Início rápido de Skills

Quando escolher o Skill em vez do MCP

O Skill independente é um runtime conector de agentes para hosts que não podem montar um servidor MCP hospedado diretamente, comunicando-se por HTTPS direto com o XMemo. É diferente dos Cloud Skills criados pelo usuário (SOPs procedimentais reutilizáveis armazenados no XMemo).

• Use o MCP hospedado quando o host do agente montar nativamente servidores MCP remotos.
• Use o runtime do Skill independente quando o host executar ferramentas CLI locais ou scripts de skill em vez disso.
• Requisito de runtime: Node.js 22.22.0 ou superior (Node.js >= 22.22.0) com suporte a ESM integrado.
• Zero dependências externas: O script de skill empacotado usa apenas módulos integrados padrão do Node.js.
• Comunicação HTTPS direta: As solicitações de saída falam diretamente com https://xmemo.dev/v1/skill/operations.

Instalação por prompt e por cliente

Instale o Skill independente no diretório de skills do seu agente. Você pode fornecer o prompt de instalação oficial ao seu agente, usar a CLI do XMemo ou executar o instalador HTTPS canônico diretamente.

• Prompt para o seu agente: Instale o Skill independente do XMemo no seu diretório de skills: execute o instalador em https://xmemo.dev/skill/install (no Windows, https://xmemo.dev/skill/install.ps1) com XMEMO_SKILL_DIR definido como seu diretório de skills mais /xmemo-memory. Execute o comando doctor exibido para verificar a instalação, recarregue suas skills e siga as etapas de primeira execução do Skill. Siga suas verificações normais de segurança e não use privilégios elevados.
• Claude Code global: ~/.claude/skills/xmemo-memory (nível de projeto: .claude/skills/xmemo-memory).
• Codex: ~/.codex/skills/xmemo-memory (ou ${CODEX_HOME:-$HOME/.codex}/skills/xmemo-memory).
• OpenClaw: ~/.openclaw/skills/xmemo-memory ou instale via ClawHub (https://clawhub.ai/xmemo/skills/xmemo).
• CLI do XMemo: xmemo skill install --client <id> (suporta claude-code, codex e openclaw) ou xmemo skill install --all.
• Instalador manual de fallback: POSIX 'curl -fsSL https://xmemo.dev/skill/install | sh' ou PowerShell 'irm https://xmemo.dev/skill/install.ps1 | iex'.
• Aviso de lançamento do serviço: A criação automatizada do diretório pai e a linha do doctor pós-instalação entram em vigor após o próximo lançamento do serviço; em ambientes de pré-lançamento, certifique-se de que o diretório pai exista antes de executar o instalador.

# 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

Primeira execução e autenticação

Execute verificações de conectividade e autenticação no diretório do skill instalado antes de iniciar as operações de memória. Instalação, autenticação e ativação são marcos distintos.

• Verificar acessibilidade: Execute doctor --anonymous para verificar a acessibilidade de rede e serviço sem credenciais.
• Escolher fonte de credencial: Prefira um XMEMO_KEY fornecido por um repositório de segredos gerenciado (Doppler, 1Password ou ambiente).
• Login interativo: Execute login --allow-plaintext para iniciar o login por dispositivo baseado em navegador. A flag --allow-plaintext confirma explicitamente o armazenamento do token sem criptografia em ~/.xmemo/skill-credentials.json com permissões POSIX 0600.
• Verificar autenticação: Execute auth status --verify para validar que sua credencial possui os escopos de memória necessários.

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

Primeira tarefa de memória útil

Conclua um ciclo de vida de memória completo: salve um fato sintético do projeto, recupere-o com atribuição de fonte, atualize-o quando os detalhes evoluírem e, opcionalmente, exclua-o via soft-delete após confirmação.

• 1. Salvar fato sintético: node scripts/xmemo-skill.mjs remember --content "Project convention: all timestamps use UTC." --path "projects/onboarding/conventions".
• 2. Recuperar fato: node scripts/xmemo-skill.mjs recall --query "project timestamp convention". Verifique se a memória retornada corresponde ao conteúdo salvo.
• 3. Atualizar memória: node scripts/xmemo-skill.mjs update --id <id> --content "Project convention: all timestamps use UTC with ISO 8601 formatting.".
• 4. Limpeza opcional: node scripts/xmemo-skill.mjs forget --id <id> --confirm. A exclusão exige estritamente --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

Perfil do projeto e oferta do AGENTS.md

Quando o login na primeira execução for concluído, o agente poderá se oferecer para adicionar uma seção de memória do XMemo ao AGENTS.md do seu projeto. Essa oferta requer consentimento explícito e separado do usuário.

• Oferta com consentimento separado: Se o projeto não tiver uma seção do XMemo, o agente perguntará uma vez: '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).'
• Imprimir instruções: node scripts/xmemo-skill.mjs profile imprime as instruções de prompt recomendadas para a configuração do agente do projeto.
• Registrar preferência do usuário: node scripts/xmemo-skill.mjs profile --status later ou node scripts/xmemo-skill.mjs profile --status never registra a resposta para que o agente não pergunte repetidamente.
• Registros do ecossistema: A listagem verificada do Skill está disponível no ClawHub em https://clawhub.ai/xmemo/skills/xmemo; plugin complementar do OpenClaw em 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