kit-ingerir

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?

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.

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, oyla, skiper52 — nenhum diz o que faz. O valor não está em guardar o arquivo, está em escrever quando usar e quando não usar.

Primeiro: analise, não pergunte

O script detecta sozinho família, stack, dependências, fontes, assets externos e marca. Rode antes de perguntar qualquer coisa ao usuário:

python "${SKILL_DIR}/scripts/ingerir.py" <arquivo> --analisar

Ele classifica por conteúdo, não por extensão — isso importa: 30 dos arquivos originais do acervo eram .md contendo TSX puro. Confie no que ele detectou.