kit-ingerirlisted
Install: claude install-skill harebeats/cannonball
# kit-ingerir — alimentar o acervo
## Antes de qualquer comando: resolva o `SKILL_DIR`
Todo comando abaixo roda um script que viaja junto desta skill, em
`SKILL_DIR/scripts/`. Defina `SKILL_DIR` como o **caminho absoluto da pasta que
contém ESTE SKILL.md que você acabou de ler** — o seu harness informou esse caminho
no resultado da leitura. Funciona em qualquer hospedeiro, sem depender de variável
de ambiente de nenhum agente específico:
```
~/.claude/plugins/cache/cannonball/cannonball/<v>/skills/<nome>/SKILL.md
~/.codex/skills/<nome>/SKILL.md
~/.gemini/skills/<nome>/SKILL.md
~/.agents/skills/<nome>/SKILL.md
```
Em todos, `SKILL_DIR` é a pasta do `SKILL.md`, e `SKILL_DIR/scripts/` está ao lado.
## Antes da primeira ingestão: onde isso vai morar?
```bash
python "${SKILL_DIR}/scripts/vincular.py"
```
Se a resposta for *"quem manda: o padrão, porque nada foi vinculado"*, **pergunte ao
usuário onde ele quer o acervo antes de gravar a primeira peça.** O padrão é
`~/.cannonball`, que funciona mas quase nunca é o que ele quer a longo prazo — e mover
depois é trabalho manual, com o índice para regerar.
```bash
python "${SKILL_DIR}/scripts/vincular.py" --para "<pasta>"
```
Sugira uma pasta versionada num repositório **privado**: o acervo guarda material de
terceiros e de clientes, e não é dele para redistribuir.
Pergunte uma vez por máquina, não a cada ingestão.
Um item mal descrito é um item perdido. O acervo já provou isso: os nomes originais
eram `bend`, `peel`, `vex`,