Skills 빠른 시작

MCP 대신 Skill을 선택할 때

독립 실행형 Skill은 hosted MCP server를 직접 마운트할 수 없는 호스트를 위한 에이전트 커넥터 런타임으로, 직접 HTTPS를 통해 XMemo와 통신합니다. 이는 사용자가 작성한 Cloud Skills(XMemo에 저장된 재사용 가능한 절차적 SOP)와는 구별됩니다.

• 에이전트 호스트가 원격 MCP 서버를 기본적으로 마운트하는 경우 hosted MCP를 사용하십시오.
• 호스트가 로컬 CLI 도구나 스킬 스크립트를 대신 실행하는 경우 독립 실행형 Skill 런타임을 사용하십시오.
• 런타임 요구 사항: 기본 제공 ESM을 지원하는 Node.js 22.22.0 이상(Node.js >= 22.22.0).
• 외부 종속성 없음: 번들된 스킬 스크립트는 표준 Node.js 내장 모듈만 사용합니다.
• 직접 HTTPS 통신: 아웃바운드 요청은 https://xmemo.dev/v1/skill/operations와 직접 통신합니다.

프롬프트 및 클라이언트별 설치

에이전트 skills 디렉터리에 독립 실행형 Skill을 설치합니다. 공식 설치 프롬프트를 에이전트에 제공하거나, XMemo CLI를 사용하거나, 표준 HTTPS 설치 프로그램을 직접 실행할 수 있습니다.

• 에이전트에 요청하는 프롬프트: 독립 실행형 XMemo Skill을 skills 디렉터리에 설치합니다: XMEMO_SKILL_DIR을 skills 디렉터리 더하기 /xmemo-memory로 설정하고 https://xmemo.dev/skill/install (Windows의 경우 https://xmemo.dev/skill/install.ps1)에서 설치 프로그램을 실행하십시오. 출력되는 doctor 명령을 실행하여 설치를 확인한 다음, skills를 다시 로드하고 Skill의 첫 실행 단계를 따르십시오. 일반적인 보안 검사를 준수하고 상승된 권한을 사용하지 마십시오.
• Claude Code 전역: ~/.claude/skills/xmemo-memory(프로젝트 수준: .claude/skills/xmemo-memory).
• Codex: ~/.codex/skills/xmemo-memory(또는 ${CODEX_HOME:-$HOME/.codex}/skills/xmemo-memory).
• OpenClaw: ~/.openclaw/skills/xmemo-memory 또는 ClawHub(https://clawhub.ai/xmemo/skills/xmemo)를 통해 설치.
• XMemo CLI: xmemo skill install --client <id>(claude-code, codex, openclaw 지원) 또는 xmemo skill install --all.
• 수동 설치 프로그램 대체 수단: POSIX 'curl -fsSL https://xmemo.dev/skill/install | sh' 또는 PowerShell 'irm https://xmemo.dev/skill/install.ps1 | iex'.
• 서비스 출시 알림: 자동화된 상위 디렉터리 생성 및 설치 후 출력되는 doctor 줄은 다음 서비스 출시 후에 적용됩니다. 시험판 환경에서는 설치 프로그램을 실행하기 전에 상위 디렉터리가 존재하는지 확인하십시오.

# Ask your agent to run the installer, or run it directly:
curl -fsSL https://xmemo.dev/skill/install | XMEMO_SKILL_DIR="$HOME/.claude/skills/xmemo-memory" sh

# Or install via XMemo CLI:
xmemo skill install --client claude-code

첫 실행 및 인증

메모리 작업을 시작하기 전에 설치된 skill 디렉터리에서 연결 및 인증 검사를 실행하십시오. 설치, 인증 및 활성화는 서로 다른 마일스톤입니다.

• 연결 가능성 확인: doctor --anonymous를 실행하여 credential 없이 네트워크 및 서비스 접근성을 확인합니다.
• credential 소스 선택: 관리형 시크릿 저장소(Doppler, 1Password 또는 환경)에서 제공하는 XMEMO_KEY를 선호합니다.
• 대화형 로그인: login --allow-plaintext를 실행하여 브라우저 기반 기기 로그인을 시작합니다. --allow-plaintext 플래그는 0600 POSIX 권한으로 ~/.xmemo/skill-credentials.json에 토큰을 암호화되지 않은 상태로 저장하는 것을 명시적으로 확인합니다.
• 인증 확인: auth status --verify를 실행하여 credential에 필요한 메모리 scope가 포함되어 있는지 확인합니다.

node scripts/xmemo-skill.mjs doctor --anonymous
node scripts/xmemo-skill.mjs login --allow-plaintext
node scripts/xmemo-skill.mjs auth status --verify

첫 번째 유용한 메모리 작업

전체 메모리 수명 주기를 완료합니다: 합성 프로젝트 팩트를 저장하고, 출처 속성과 함께 회상하고, 세부 정보가 변경되면 업데이트하고, 확인 후 선택적으로 소프트 삭제합니다.

• 1. 합성 팩트 저장: node scripts/xmemo-skill.mjs remember --content "Project convention: all timestamps use UTC." --path "projects/onboarding/conventions".
• 2. 팩트 회상: node scripts/xmemo-skill.mjs recall --query "project timestamp convention". 반환된 메모리가 저장된 콘텐츠와 일치하는지 확인합니다.
• 3. 메모리 업데이트: node scripts/xmemo-skill.mjs update --id <id> --content "Project convention: all timestamps use UTC with ISO 8601 formatting.".
• 4. 선택적 정리: node scripts/xmemo-skill.mjs forget --id <id> --confirm. 삭제 시 엄격하게 --confirm 플래그가 필요합니다.

node scripts/xmemo-skill.mjs remember --content "Project convention: all timestamps use UTC." --path "projects/onboarding/conventions"
node scripts/xmemo-skill.mjs recall --query "project timestamp convention"
node scripts/xmemo-skill.mjs update --id mem_01hxyz... --content "Project convention: all timestamps use UTC with ISO 8601 formatting."
node scripts/xmemo-skill.mjs forget --id mem_01hxyz... --confirm

프로젝트 프로필 및 AGENTS.md 제안

첫 실행 로그인이 완료되면 에이전트가 프로젝트의 AGENTS.md에 XMemo 메모리 섹션을 추가할 것을 제안할 수 있습니다. 이 제안에는 별도의 명시적인 사용자 동의가 필요합니다.

• 개별 동의가 필요한 제안: 프로젝트에 XMemo 섹션이 없는 경우 에이전트가 한 번 묻습니다: 'Want XMemo used automatically in every session of this project? I can add a short XMemo section to AGENTS.md (yes / later / don't ask again).'
• 지침 출력: node scripts/xmemo-skill.mjs profile은 프로젝트 에이전트 구성에 권장되는 프롬프트 지침을 출력합니다.
• 사용자 기본 설정 기록: node scripts/xmemo-skill.mjs profile --status later 또는 node scripts/xmemo-skill.mjs profile --status never를 사용하여 답변을 기록하면 에이전트가 반복해서 묻지 않습니다.
• 생태계 레지스트리: 검증된 Skill 목록은 ClawHub의 https://clawhub.ai/xmemo/skills/xmemo에서 확인할 수 있으며, OpenClaw 컴패니언 플러그인은 https://clawhub.ai/xmemo/plugins/openclaw-memory에서 확인할 수 있습니다.

# Inspect agent profile instructions:
node scripts/xmemo-skill.mjs profile

# Record deferred or declined offer:
node scripts/xmemo-skill.mjs profile --status later
node scripts/xmemo-skill.mjs profile --status never