Démarrage rapide de Skills

Quand choisir la Skill au lieu de MCP

La Skill autonome est un runtime de connexion pour les hôtes ne pouvant pas monter directement un serveur MCP hébergé, communiquant par HTTPS direct avec XMemo. Elle est distincte des Cloud Skills créées par les utilisateurs (SOP procédurales réutilisables stockées dans XMemo).

• Utilisez le serveur hébergé MCP lorsque l'hôte de l'agent prend en charge nativement les serveurs MCP distants.
• Utilisez le runtime de la Skill autonome lorsque l'hôte exécute à la place des outils CLI locaux ou des scripts de skill.
• Exigence d'exécution : Node.js 22.22.0 ou supérieur (Node.js >= 22.22.0) avec prise en charge intégrée d'ESM.
• Zéro dépendance externe : Le script de skill packagé utilise uniquement les modules intégrés standard de Node.js.
• Communication HTTPS directe : Les requêtes sortantes communiquent directement avec https://xmemo.dev/v1/skill/operations.

Installation par invite et par client

Installez la Skill autonome dans le répertoire de skills de votre agent. Vous pouvez fournir l'invite d'installation officielle à votre agent, utiliser la CLI XMemo ou exécuter directement le programme d'installation HTTPS canonique.

• Invite pour votre agent : Installez la Skill autonome XMemo dans votre répertoire de skills : exécutez le programme d'installation depuis https://xmemo.dev/skill/install (sous Windows, https://xmemo.dev/skill/install.ps1) avec XMEMO_SKILL_DIR défini sur votre répertoire de skills plus /xmemo-memory. Exécutez la commande doctor qu'il affiche pour vérifier l'installation, puis rechargez vos skills et suivez les étapes de premier lancement de la Skill. Suivez vos contrôles de sécurité habituels et n'utilisez pas de privilèges élevés.
• Claude Code global : ~/.claude/skills/xmemo-memory (niveau projet : .claude/skills/xmemo-memory).
• Codex : ~/.codex/skills/xmemo-memory (ou ${CODEX_HOME:-$HOME/.codex}/skills/xmemo-memory).
• OpenClaw : ~/.openclaw/skills/xmemo-memory ou installer via ClawHub (https://clawhub.ai/xmemo/skills/xmemo).
• CLI XMemo : xmemo skill install --client <id> (prend en charge claude-code, codex et openclaw) ou xmemo skill install --all.
• Solution de secours pour l'installation manuelle : POSIX 'curl -fsSL https://xmemo.dev/skill/install | sh' ou PowerShell 'irm https://xmemo.dev/skill/install.ps1 | iex'.
• Avis de version de service : La création automatique du répertoire parent et la ligne doctor imprimée après l'installation prennent effet après la prochaine version de service ; dans les environnements de pré-version, assurez-vous que le répertoire parent existe avant d'exécuter le programme d'installation.

# 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

Premier lancement et authentification

Exécutez des vérifications de connectivité et d'authentification depuis le répertoire de la skill installée avant de lancer des opérations de mémoire. L'installation, l'authentification et l'activation constituent des étapes distinctes.

• Vérifier l'accessibilité : Exécutez doctor --anonymous pour vérifier l'accessibilité du réseau et du service sans identifiants.
• Choisir la source des identifiants : Privilégiez une clé XMEMO_KEY fournie par un magasin de secrets géré (Doppler, 1Password ou environnement).
• Connexion interactive : Exécutez login --allow-plaintext pour lancer la connexion de l'appareil basée sur le navigateur. L'option --allow-plaintext confirme explicitement l'enregistrement du jeton non chiffré dans ~/.xmemo/skill-credentials.json avec les autorisations POSIX 0600.
• Vérifier l'authentification : Exécutez auth status --verify pour vous assurer que votre identifiant dispose des portées de mémoire requises.

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

Première tâche de mémoire utile

Complétez un cycle de vie de mémoire complet : enregistrez un fait synthétique de projet, rappelez-le avec attribution de provenance, mettez-le à jour lorsque les détails évoluent et supprimez-le éventuellement via soft-delete après confirmation.

• 1. Enregistrer un fait synthétique : node scripts/xmemo-skill.mjs remember --content "Project convention: all timestamps use UTC." --path "projects/onboarding/conventions".
• 2. Rappeler le fait : node scripts/xmemo-skill.mjs recall --query "project timestamp convention". Vérifiez que la mémoire renvoyée correspond à votre contenu enregistré.
• 3. Mettre à jour la mémoire : node scripts/xmemo-skill.mjs update --id <id> --content "Project convention: all timestamps use UTC with ISO 8601 formatting.".
• 4. Nettoyage facultatif : node scripts/xmemo-skill.mjs forget --id <id> --confirm. La suppression requiert strictement --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

Profil de projet et proposition AGENTS.md

Lorsque la connexion au premier lancement est terminée, l'agent peut proposer d'ajouter une section de mémoire XMemo au fichier AGENTS.md de votre projet. Cette proposition nécessite un consentement explicite séparé de l'utilisateur.

• Proposition soumise à consentement distinct : Si le projet n'a pas de section XMemo, l'agent demande une seule fois : '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).'
• Afficher les instructions : node scripts/xmemo-skill.mjs profile affiche les instructions d'invite recommandées pour la configuration de l'agent du projet.
• Enregistrer la préférence utilisateur : node scripts/xmemo-skill.mjs profile --status later ou node scripts/xmemo-skill.mjs profile --status never enregistre la réponse afin que l'agent ne sollicite pas l'utilisateur à plusieurs reprises.
• Registres de l'écosystème : La fiche de Skill vérifiée est disponible sur ClawHub à l'adresse https://clawhub.ai/xmemo/skills/xmemo ; plugin compagnon OpenClaw sur 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