# Início rápido de Skills Escolha o caminho independente do Skill quando o host do agente não puder montar diretamente um servidor MCP hospedado. - Canonical: https://docs.xmemo.dev/pt-br/docs/skills/quickstart - Locale: pt-BR - Content-Locale: pt-BR - Canonical-Content-Digest: 6ba591b56f318400d8b7be59a77c62166fdb9bfcc7a5682e373a3d37a5b27f17 - Edition-Digest: 382c845f576d9710ffa2b8b079ed1a6e4a828081deb504e28fbfd0e28621012d - Source-Revision: sha256:155eed78733b301c44438f3428593a7838254964821afe158cef180b6dcfda2f ## 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 (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. ```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 ``` ## 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. ```bash 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 --content "Project convention: all timestamps use UTC with ISO 8601 formatting.". - 4. Limpeza opcional: node scripts/xmemo-skill.mjs forget --id --confirm. A exclusão exige estritamente --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 ``` ## 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. ```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 ```