Habilidades de Escrita (Excelência)

Disparador para excelência na criação de habilidades. Use a árvore de decisão abaixo para encontrar o template e os padrões corretos.

⚡ Árvore de Decisão Rápida

O que você precisa fazer?

1. Criar uma habilidade NOVA:

   • É simples (arquivo único, <200 linhas)? → Arquitetura Nível 1
   • É complexa (multi-conceito, 200-1000 linhas)? → Arquitetura Nível 2
   • É uma plataforma massiva (10+ produtos, AWS, Convex)? → Arquitetura Nível 3

2. Melhorar uma habilidade EXISTENTE:

   • Corrigir "é muito longa" -> Modularizar (Nível 3)
   • Corrigir "IA ignora regras" -> Anti-Racionalização
   • Corrigir "usuários não a encontram" -> CSO (Otimização de Busca)

3. Verificar Conformidade:

   • Checar metadados/nomeação -> Padrões
   • Adicionar testes -> Guia de Testes

📚 Índice de Componentes

🛠️ Templates

• Habilidade de Técnica (Como fazer)
• Habilidade de Referência (Documentação)
• Habilidade de Disciplina (Regras)
• Habilidade de Padrão (Padrões de Design)

Quando Usar

• Criando uma habilidade NOVA do zero
• Melhorando uma habilidade EXISTENTE que os agentes ignoram
• Depurando por que uma habilidade não está sendo acionada
• Padronizando habilidades em uma equipe

Como Funciona

1. Identificar objetivo → Usar árvore de decisão acima
2. Selecionar template → De references/templates/
3. Aplicar CSO → Otimizar descrição para descoberta
4. Adicionar anti-racionalização → Para habilidades de disciplina
5. Testar → Ciclo VERMELHO-VERDE-REFACTORAR

Exemplo Rápido

---
name: my-technique
description: Use when [specific symptom occurs].
metadata:
  category: technique
  triggers: error-text, symptom, tool-name
---

# My Technique

## When to Use
- [Symptom A]
- [Error message]

Erros Comuns

Veja gotchas.md para mais.

✅ Checklist Pré-Implantação

Antes de implantar qualquer habilidade:

• Campo name corresponde exatamente ao nome do diretório
• Nome do arquivo SKILL.md está TODO EM MAIÚSCULAS
• Descrição começa com "Use quando..."
• metadata.triggers tem 3+ palavras-chave
• Total de linhas < 500 (usar references/ para mais)
• Sem @ forçando carregamento em referências cruzadas
• Testado com cenários reais

🔗 Habilidades Relacionadas

• opencode-expert: Para configuração do ambiente OpenCode
• Use o comando /write-skill para criação guiada de habilidades

Exemplos

Criar uma habilidade Nível 1:

mkdir -p ~/.config/opencode/skills/my-technique
touch ~/.config/opencode/skills/my-technique/SKILL.md

Criar uma habilidade Nível 2:

mkdir -p ~/.config/opencode/skills/my-skill/references/core
touch ~/.config/opencode/skills/my-skill/{SKILL.md,gotchas.md}
touch ~/.config/opencode/skills/my-skill/references/core/README.md

Limitações

• Use esta habilidade apenas quando a tarefa corresponder claramente ao escopo descrito acima.
• Não trate a saída como substituta para validação específica do ambiente, testes ou revisão de especialistas.
• Pare e peça esclarecimentos se forem necessárias entradas, permissões, limites de segurança ou critérios de sucesso ausentes.