📁 Organizando múltiplas skills
Um repositório de skills bem organizado tem a pasta skills/ na raiz, com subpastas por categoria: skills/frontend/, skills/devops/, skills/testing/. O CLI faz descoberta recursiva.
Estrutura de repositório
Organização por categoria facilita a manutenção e permite instalar todas as skills de uma categoria com um só comando usando -s com wildcard.
💡 Conceitos-chave
pasta skills/ · subpastas por categoria · descoberta recursiva · organização · manutenção
🗺️ Pastas de descoberta padrão
O CLI busca em: skills/, .claude/skills/, .agents/skills/, .cursor/skills/ e skills/.curated/. Múltiplas localizações suportam diferentes cenários de organização.
Onde o CLI procura
Conhecer todas as pastas permite colocar skills no lugar certo para cada caso: skills/ para público, .claude/skills/ para Claude-específico, skills/.curated/ para skills estáveis.
💡 Conceitos-chave
skills/ · .claude/skills/ · .agents/skills/ · .curated/ · prioridade de descoberta
📋 Plugin Manifest e marketplace.json
O arquivo .claude-plugin/marketplace.json permite definir metadados do repositório: nome, descrição, categorias, autor. Usado pelo skills.sh para listagem.
Metadados do repositório
Um marketplace.json bem preenchido melhora a descoberta no skills.sh. Skills sem esse arquivo são listadas mas com informações mínimas.
💡 Conceitos-chave
marketplace.json · metadados · categorias · autor · skills.sh listing
🔍 Descoberta recursiva na prática
O CLI percorre recursivamente as pastas de descoberta, encontrando todos os arquivos .md. Arquivos em subpastas como skills/frontend/react.md são incluídos automaticamente.
Como o CLI percorre pastas
A descoberta recursiva permite organizar skills em hierarquias profundas sem configuração adicional. O CLI encontra tudo automaticamente.
💡 Conceitos-chave
recursividade · profundidade · sem configuração · hierarquia de pastas · auto-discovery
🔖 Versionamento e branches
Use branches Git para versionar skills: main para estável, develop para experimental. Usuários podem instalar de um branch específico via URL com /tree/branch-name.
Controlando versões de skills
Versionamento por branch permite manter skills estáveis em main enquanto desenvolve novas em branches. Times podem fixar em uma versão segura.
💡 Conceitos-chave
branches · main · develop · URL com tree/ · fixar versão · compatibilidade
⭐ Skills .curated e .experimental
Use subpastas especiais: skills/.curated/ para skills testadas e estáveis, skills/.experimental/ para skills em desenvolvimento que podem quebrar.
Marcando maturidade
Separar por maturidade ajuda usuários a escolher: instalar .curated/ para produção, .experimental/ para testar novas funcionalidades.
💡 Conceitos-chave
.curated · .experimental · maturidade · produção · teste
✅ Resumo do Módulo
Próximo:
3.3 — Campos Avançados do SKILL.md