Vá além das skills padrão e crie comportamentos customizados — testados com o mesmo rigor das skills core.
Uma SKILL.md é um arquivo de texto com estrutura específica: frontmatter YAML com metadados obrigatórios, seguido do conteúdo instrucional em Markdown. O frontmatter define como a skill é identificada e quando ela é ativada. O conteúdo define o que o agente deve fazer quando ativado.
---
name: minha-skill
description: O que esta skill faz em uma linha
version: 1.0.0
triggers:
- "palavras que ativam"
- "frases de gatilho"
- "contextos que aplicam"
---
# Título da Skill
## Quando aplicar
[Descreva as situações onde o agente deve usar esta skill]
## O que fazer
[Instruções detalhadas de comportamento]
## O que NÃO fazer
[Antipadrões explícitos]
## Exemplos
[Exemplos concretos de uso correto]O campo triggers é crítico
Os triggers são as frases que o sistema busca no contexto para decidir se deve injetar sua skill. Se estiverem muito genéricos, a skill ativa em contextos errados. Se muito específicos, nunca ativa. Teste com frases reais que você usaria.
A skill writing-skills do Superpowers foi criada especificamente para testar novas skills. Ela instrui o agente a usar subagentes para simular sessões onde a skill deve e não deve ativar, verificando se o comportamento está correto antes de usar em produção.
O Superpowers tem uma taxa de rejeição de PRs de 94%. Isso não é um problema — é uma característica. Skills são código comportamental que molda como agentes de IA agem em sessões reais. O impacto de uma skill ruim é sistêmico: ela afeta todos os usuários do projeto em todas as sessões.
A lição para suas skills pessoais
O mesmo rigor que o Superpowers aplica ao core deve ser aplicado às suas skills pessoais. Teste-as antes de usar em produção. Uma skill não testada é uma aposta no comportamento do agente.
Nem toda skill que você criar pertence ao core do Superpowers. O critério é simples: a skill seria útil para um desenvolvedor trabalhando em um projeto completamente diferente do seu? Se sim, pode ser candidata ao core. Se não, deve ficar no seu plugin privado.
Ex: brainstorming, tdd, debugging
Ex: deploy para seu cloud específico
Publicar skills específicas como core polui o projeto para todos e resulta em rejeição. Manter plugins privados bem organizados é mais valioso do que PRs rejeitados ao core.
Skills úteis podem ser compartilhadas além do seu projeto pessoal. Um plugin de skills é um repositório Git com a mesma estrutura do Superpowers — apenas as skills específicas do seu domínio — que outros desenvolvedores do mesmo domínio podem instalar.
meu-plugin-skills/
├── skills/
│ ├── minha-skill-1.md
│ └── minha-skill-2.md
├── sync.sh # copia para o harness
├── CHANGELOG.md
└── README.md # como instalar e usarVersionamento semântico
Use semver para versionar seu plugin. MAJOR quando skills mudam comportamento de forma incompatível, MINOR quando adiciona novas skills, PATCH quando corrige bugs nas skills existentes. Mantenha CHANGELOG.md com as mudanças de cada versão.
Exercício final da trilha: identificar um comportamento recorrente que você quer automatizar, escrever a skill completa, testá-la com o protocolo de 4 testes e documentá-la para uso futuro. Esta é a habilidade que fecha o ciclo — você agora pode customizar o Superpowers para o seu workflow específico.
Parabéns — você concluiu a trilha
Você percorreu os 10 módulos da trilha Superpowers, do anti-padrão "só escreve o código" à criação de skills customizadas. O Superpowers é uma metodologia viva — use o que aprendeu, adapte ao seu workflow e crie as skills que faltam para o seu domínio.
Todos os 10 módulos da trilha Superpowers — Desenvolvimento com Agentes de IA