Projeto pessoal · código aberto
Cast Skills
Criação de um pacote npm que instala skills de contexto de projeto e um workflow orientado por especificação em seis ferramentas de IA para código.
Problema
Agentes de código reaprendem o projeto a cada sessão: esquecem convenções, fronteiras de módulos e regras de negócio que não estão escritas em lugar nenhum.
Dados disponíveis
O codebase e as respostas do time a perguntas curtas do bootstrapper, transformados em uma árvore de skills do projeto.
Decisões de arquitetura
Padrão aberto como fonte
SKILL.md é o formato canônico. A conversão para ferramentas com formato próprio (Cursor, Windsurf) acontece só na instalação.
Divulgação progressiva
O agente carrega primeiro o mapa geral do projeto e depois só as regras do módulo que está mexendo.
Roteador sempre ativo
A skill using-project-skills entra no início de qualquer feature, correção ou refatoração e conduz o trabalho pelo contexto do projeto e pelo workflow de especificação.
Implementação
- Wizard (npx cast-skills) que detecta as ferramentas instaladas e copia as skills: SKILL.md nativo para Claude Code, Copilot, Gemini e Codex; conversão para .mdc no Cursor e para regras no Windsurf.
- Três skills: using-project-skills (roteador), creating-project-skills (bootstrapper) e explaining-changes (explicações depois de uma mudança).
- Testes automatizados do Node cobrem a instalação e a conversão de formatos.
Resultado
- 6ferramentas suportadas
Publicado no npm como cast-skills.
Limitações e aprendizados
- Os ganhos de tokens citados no README são referência da Anthropic sobre o padrão de skills, não uma medição deste projeto.