Skills-Schnellstart

Wann die Skill statt MCP gewählt werden sollte

Die eigenständige Skill ist eine Agenten-Konnektor-Laufzeitumgebung für Hosts, die einen gehosteten MCP-Server nicht einbinden können, und kommuniziert über direktes HTTPS mit XMemo. Sie unterscheidet sich von benutzererstellten Cloud Skills (wiederverwendbare prozedurale SOPs, die in XMemo gespeichert sind).

• Verwenden Sie gehostetes MCP, wenn der Agenten-Host Remote-MCP-Server nativ einbindet.
• Verwenden Sie stattdessen die eigenständige Skill-Laufzeitumgebung, wenn der Host lokale CLI-Tools oder Skill-Skripte ausführt.
• Laufzeitanforderung: Node.js 22.22.0 oder höher (Node.js >= 22.22.0) mit integrierter ESM-Unterstützung.
• Keine externen Abhängigkeiten: Das gebündelte Skill-Skript verwendet ausschließlich standardmäßige integrierte Node.js-Module.
• Direkte HTTPS-Kommunikation: Ausgehende Anfragen kommunizieren direkt mit https://xmemo.dev/v1/skill/operations.

Installation nach Prompt und nach Client

Installieren Sie die eigenständige Skill in Ihrem Agenten-Skills-Verzeichnis. Sie können Ihrem Agenten den offiziellen Installations-Prompt bereitstellen, die XMemo-CLI verwenden oder das kanonische HTTPS-Installationsprogramm direkt ausführen.

• Agenten-Prompt übergeben: Installieren Sie die eigenständige XMemo-Skill in Ihrem Skills-Verzeichnis: Führen Sie das Installationsprogramm von https://xmemo.dev/skill/install (unter Windows https://xmemo.dev/skill/install.ps1) aus, wobei XMEMO_SKILL_DIR auf Ihr Skills-Verzeichnis plus /xmemo-memory festgelegt ist. Führen Sie den ausgegebenen doctor-Befehl aus, um die Installation zu überprüfen, laden Sie dann Ihre Skills neu und befolgen Sie die Schritte für den ersten Start der Skill. Befolgen Sie Ihre normalen Sicherheitsprüfungen und verwenden Sie keine erhöhten Rechte.
• Claude Code global: ~/.claude/skills/xmemo-memory (Projektebene: .claude/skills/xmemo-memory).
• Codex: ~/.codex/skills/xmemo-memory (oder ${CODEX_HOME:-$HOME/.codex}/skills/xmemo-memory).
• OpenClaw: ~/.openclaw/skills/xmemo-memory oder über ClawHub installieren (https://clawhub.ai/xmemo/skills/xmemo).
• XMemo-CLI: xmemo skill install --client <id> (unterstützt claude-code, codex und openclaw) oder xmemo skill install --all.
• Manuelles Fallback-Installationsprogramm: POSIX 'curl -fsSL https://xmemo.dev/skill/install | sh' oder PowerShell 'irm https://xmemo.dev/skill/install.ps1 | iex'.
• Hinweis zur Service-Veröffentlichung: Die automatisierte Erstellung des übergeordneten Verzeichnisses und die ausgegebene doctor-Zeile nach der Installation treten nach der nächsten Service-Veröffentlichung in Kraft; stellen Sie in Vorab-Umgebungen sicher, dass das übergeordnete Verzeichnis vor dem Ausführen des Installationsprogramms existiert.

# 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

Erster Start und Authentifizierung

Führen Sie Konnektivitäts- und Authentifizierungsprüfungen aus dem installierten Skill-Verzeichnis durch, bevor Sie Speicheroperationen initiieren. Installation, Authentifizierung und Aktivierung sind getrennte Meilensteine.

• Erreichbarkeit prüfen: Führen Sie doctor --anonymous aus, um die Netzwerk- und Dienst-Erreichbarkeit ohne Anmeldedaten zu überprüfen.
• Anmeldedatenquelle wählen: Bevorzugen Sie ein XMEMO_KEY, das von einem verwalteten Secret-Speicher (Doppler, 1Password oder Umgebung) bereitgestellt wird.
• Interaktive Anmeldung: Führen Sie login --allow-plaintext aus, um die browserbasierte Geräteanmeldung zu starten. Das Flag --allow-plaintext bestätigt explizit das unverschlüsselte Speichern des Tokens in ~/.xmemo/skill-credentials.json mit 0600 POSIX-Berechtigungen.
• Authentifizierung überprüfen: Führen Sie auth status --verify aus, um zu überprüfen, ob Ihre Anmeldedaten die erforderlichen Speicher-Scopes aufweisen.

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

Erste nützliche Speicheraufgabe

Schließen Sie einen vollständigen Speicherlebenszyklus ab: Speichern Sie einen synthetischen Projektfakt, rufen Sie ihn mit Herkunftsnachweis ab, aktualisieren Sie ihn bei Detailänderungen und löschen Sie ihn optional nach Bestätigung per Soft-Delete.

• 1. Synthetischen Fakt speichern: node scripts/xmemo-skill.mjs remember --content "Project convention: all timestamps use UTC." --path "projects/onboarding/conventions".
• 2. Fakt abrufen: node scripts/xmemo-skill.mjs recall --query "project timestamp convention". Überprüfen Sie, ob der zurückgegebene Speicherinhalt Ihrem gespeicherten Inhalt entspricht.
• 3. Speicher aktualisieren: node scripts/xmemo-skill.mjs update --id <id> --content "Project convention: all timestamps use UTC with ISO 8601 formatting.".
• 4. Optionale Bereinigung: node scripts/xmemo-skill.mjs forget --id <id> --confirm. Das Löschen erfordert zwingend --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

Projektprofil und AGENTS.md-Angebot

Nach Abschluss der Anmeldung beim ersten Start kann der Agent anbieten, einen XMemo-Speicherabschnitt zu AGENTS.md Ihres Projekts hinzuzufügen. Dieses Angebot erfordert eine separate explizite Zustimmung des Benutzers.

• Separat zugestimmtes Angebot: Wenn dem Projekt ein XMemo-Abschnitt fehlt, fragt der Agent einmal: '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).'
• Anweisungen ausgeben: node scripts/xmemo-skill.mjs profile gibt empfohlene Prompt-Anweisungen für die Agentenkonfiguration des Projekts aus.
• Benutzerpräferenz aufzeichnen: node scripts/xmemo-skill.mjs profile --status later oder node scripts/xmemo-skill.mjs profile --status never zeichnet die Antwort auf, damit der Agent nicht wiederholt nachfragt.
• Ökosystem-Registries: Verifizierter Skill-Eintrag ist auf ClawHub unter https://clawhub.ai/xmemo/skills/xmemo verfügbar; OpenClaw-Begleit-Plugin unter 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