Explorar documentação
Primeiros passos
Escolha um local de instalação, verifique o pacote e atualize ou remova habilidades.
Nesta página
1. Instale no local certo
Use um FlashData instalado CLI. --skip-auth instala as habilidades off-line sem criar um teste ou mudar credenciais.
Substitua o códice por código de claude ou cursor para esses hosts. Use --directory PATH para outro projeto, não pode ser combinado com --global. Codex e Cursor compartilham uma instalação de projeto.
flashdata setup --agent codex --directory . --skip-auth --non-interactive --json
flashdata skills verify --agent codex --directory . --jsonflashdata setup --agent codex --global --skip-auth --non-interactive --json
flashdata skills verify --agent codex --global --jsonPara onde os arquivos vão
Outros anfitriões usam o instalador independente ou cópias de diretório inteiro do repositório oficial. Mantenha SKILL.md e seus arquivos de suporte juntos.
| Host | Projeto | Toda a gente |
|---|---|---|
| Codex | .agents/skills | ~/.agents/skills |
| Claude Code | .claude/skills | ~/.claude/skills ou $CLAUDE_CONFIG_DIR/skills |
| Cursor | .agents/skills | ~/.cursor/skills |
2. Leia o resultado da verificação
As habilidades verificam se comparam a instalação selecionada com a revisão do executável atual. Espere ok: true e data.verified: true; data.directories identifica a localização verificada e data.sourceCommit identifica a revisão de fonte empacotada. Isso confirma arquivos, não acesso API.
A lista de habilidades lista o que esse CLI pode instalar, não o que está instalado em seu agente.
flashdata skills list --jsonInstale apenas uma habilidade selecionada
Use o mesmo --skill, --agent e bandeiras de localização para instalação e verificação. Omitindo --skill verifica o pacote padrão, que relatará arquivos desaparecidos quando você instalou apenas um subconjunto.
flashdata setup --agent codex --directory . --skill google-search --skip-auth --non-interactive --json
flashdata skills verify --agent codex --directory . --skill google-search --json3. Recarregue o agente e verifique o acesso
Comece uma nova sessão de agentes para carregar as habilidades instaladas. Execute as verificações dentro daquela sessão com o usuário OS, perfil e diretório de estado usado para login. FLASHDATA_API_KEY substitui a chave salva. Para um perfil personalizado, adicione seu --profile e --state-dir ao auth status.
flashdata --version
flashdata doctor --offline
flashdata auth status --jsonAtualizar sem perder as mudanças locais
Atualize o CLI usando seu instalador original, e então repita o par de instalação e verificação do passo 1. Mantenha o mesmo hospedeiro, localização e seleção --skill. Arquivos gerenciados não modificados atualizados, arquivos conflitantes ou modificados localmente fazem o comando parar para revisão. Recarregue o agente depois que a verificação passar.
Para uma instalação de repositório, atualize todo o diretório de habilidades, incluindo referências, scripts e ativos. A revisão do pacote CLI pode ser diferente da última commit do repositório.
Conserte uma verificação falhada
| Sintoma | Ação |
|---|---|
| Arquivos de habilidade desaparecidos | Verifique --agent, --directory / --global e --skill. Verifique o mesmo local e seleção que você instalou. |
| Hash descompasso / mudança local | Reveja o arquivo reportado contra a revisão empacotada. Preservar suas mudanças antes de substituir qualquer coisa, em seguida, repetir instalação e verificação. |
| Symlink ou bloqueio de instalação | Use um diretório normal. Verifique se outro instalador está rodando antes de lidar com um bloqueio velho; não remova um bloqueio ativo. |
| Verificado, mas o agente não pode encontrá-lo | Abra o projeto, verifique a localização da habilidade do anfitrião e reinicie sua sessão. |
| Verificado, mas as chamadas API falham | Verifique auth status no ambiente de agentes. Arquivos de habilidade não fornecem credenciais ou créditos. |
Remova habilidades ou revogue o acesso
Desativar as habilidades em seu host ou remover seus diretórios instalados para parar de carregar instruções. Revogar o acesso do agente separadamente em Connected apps, ou revogar uma chave importada em API Keys. Remover habilidades não revoga credenciais.