Estrutura de Skills

Estrutura de Diretório

skill-name/
├── skill.md              # Definição principal (obrigatório)
├── references/           # Documentação de referência detalhada
│   ├── api.md
│   └── patterns.md
├── rules/                # Regras contextuais
│   └── coding-style.md
└── examples/             # Exemplos práticos (opcional)
    └── basic-usage.md

Arquivo Principal (skill.md)

O arquivo skill.md é o ponto de entrada da skill e deve conter:

Seções Obrigatórias

Seção	Descrição
Role Definition	Descrição do papel e expertise da skill
When to Use	Condições de ativação e palavras-chave
Critical Rules	Regras que DEVEM e NÃO DEVEM ser seguidas
Technologies	Stack tecnológica coberta

Seções Recomendadas

Seção	Descrição
Core Workflow	Fluxo de trabalho principal
Decision Frameworks	Árvores de decisão para escolhas técnicas
Reference Documentation	Links para referências detalhadas
Quick Reference	Snippets e padrões de uso rápido

Convenções de Nomenclatura

• Use kebab-case para nomes de skills e arquivos
• Prefixe regras com o contexto: astro-components.rule.md
• Use extensão .md para todos os arquivos de documentação

Metadados

Skills podem incluir metadados no frontmatter:

---
name: astro-framework
version: 1.0.0
keywords: [astro, islands, static, SSR]
---