# Skills クイックスタート

agent hostがhosted MCP serverを直接mountできない場合は、standalone Skillの経路を選択します。

- Canonical: https://docs.xmemo.dev/ja/docs/skills/quickstart
- Locale: ja-JP
- Content-Locale: ja-JP
- Canonical-Content-Digest: 6ba591b56f318400d8b7be59a77c62166fdb9bfcc7a5682e373a3d37a5b27f17
- Edition-Digest: c00a7b6ae06275fbf7c62f294925734bb751809c6456f3dd2ca75cdefd752274
- Source-Revision: sha256:155eed78733b301c44438f3428593a7838254964821afe158cef180b6dcfda2f

## MCPではなくSkillを選ぶ場合

standalone Skillは、hosted MCP serverを直接マウントできないホスト向けのエージェントコネクタランタイムであり、直接HTTPS経由でXMemoと通信します。これはユーザーが作成したCloud Skills（XMemoに保存された再利用可能な手続き型SOP）とは異なります。

- agent hostがリモートMCPサーバーをネイティブにマウントする場合は、hosted MCPを使用します。
- ホストが代わりにローカルCLIツールやスキルスクリプトを実行する場合は、standalone Skillランタイムを使用します。
- ランタイム要件: 組み込みESMサポートを備えた Node.js 22.22.0 以上（Node.js >= 22.22.0）。
- 外部依存関係ゼロ: バンドルされたスキルスクリプトは標準の Node.js 組み込みモジュールのみを使用します。
- 直接HTTPS通信: 送信リクエストは https://xmemo.dev/v1/skill/operations と直接通信します。

## プロンプトおよびクライアント別のインストール

standalone Skillをエージェントのskillsディレクトリにインストールします。公式のインストールプロンプトをエージェントに提供するか、XMemo CLIを使用するか、正規のHTTPSインストーラーを直接実行できます。

- エージェントプロンプトに依頼する: standalone 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行は、次回のサービスリリース後に有効になります。プレリリース環境では、インストーラーを実行する前に親ディレクトリが存在することを確認してください。

```bash
# 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 にtokenを暗号化せずに保存することを明示的に確認します。
- 認証の検証: auth status --verify を実行して、credentialに必要な記憶scopeが含まれていることを検証します。

```bash
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 が必要です。

```bash
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 セクションがない場合、エージェントは1回だけ尋ねます: '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 で入手できます。

```bash
# 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
```