scaffold-skill
scaffold-skill cria uma nova skill do Octopus com o formato certo desde o início
— o frontmatter, a disciplina de tamanho, os arquivos de apoio opcionais — e a
conecta a um bundle pra que ela de fato seja entregue. É a porta de entrada pra
estender o catálogo.
O que resolve
Uma skill criada ad hoc tende a sair errada em pequenos jeitos que se acumulam:
frontmatter faltando ou malformado, um SKILL.md que se espalha além do ponto de
ser carregável, arquivos de apoio aninhados fundo demais pra achar — e, mais
comum, uma skill que existe mas não pertence a bundle nenhum, então ninguém a
instala. scaffold-skill torna a estrutura correta o default, pra que uma skill
nova seja consistente e descobrível no dia um.
Como resolve
- Estrutura correta — frontmatter com
name+description, um SKILL.md mantido ≤ 250 linhas, eREFERENCE.md/EXAMPLES.md/scripts/opcionais em um nível de profundidade (sem aninhamento fundo pra caçar). - Registro em bundle — a skill é registrada num bundle alvo como parte do scaffolding, então nenhuma skill sai solta — toda skill mapeia pra um bundle que um time pode habilitar.
É a contraparte do compress-skill (que encolhe skills existentes): a família
*-skill pra autorar e manter o catálogo.
Quando usar
Sempre que estiver adicionando uma capacidade nova ao Octopus. Comece aqui em vez de copiar um SKILL.md existente à mão — a estrutura e a conexão com o bundle vêm de graça.