Skills: Compartilhamento e Marketplace de Skills
Última atualização: 2026-08-31
A melhor prática de uma pessoa é experiência; a melhor prática de um grupo é um padrão — compartilhar transforma Skills de ferramentas pessoais em ativos de equipe.
1. Métodos de Compartilhamento
(1) Compartilhamento por Repositório Git
O método mais básico de compartilhamento, gerenciado por versão através do Git:
Estrutura do Repositório de Skills da Equipe
├── skills/
│ ├── code-review.md
│ ├── auto-test.md
│ ├── deploy.md
│ └── security-scan.md
├── README.md (índice e instruções de uso)
└── CHANGELOG.md (registros de mudanças de versão)
(2) Embarcado no Projeto
Colocar Skills diretamente no diretório do projeto:
| Plataforma | Diretório | Escopo |
|---|---|---|
| Claude Code | .claude/skills/ |
Projeto atual |
| Cursor | .cursor/rules/ |
Projeto atual |
| OpenCode | skills/ |
Projeto atual |
(3) Instalação Global
Efetivo para todos os projetos:
# Skills globais do Claude Code
~/.claude/skills/
# Configuração de nível de usuário
~/.config/opencode/skills/
2. Processo de Publicação
(1) Checklist de Qualidade da Skill
Verificação obrigatória antes de publicar:
Verificações Pré-Publicação
├── [ ] Prompt está completo e específico
├── [ ] Informações do frontmatter estão precisas (name, description, triggers)
├── [ ] Inclui exemplos de uso
├── [ ] Testado em pelo menos 2 projetos
├── [ ] Não contém informações sensíveis do projeto
├── [ ] Ferramentas necessárias estão documentadas
└── [ ] Inclui documentação README
(2) Estrutura do Pacote da Skill
Estrutura do Pacote de Publicação
├── skill-name.md # Arquivo principal da Skill
├── README.md # Instruções de uso
├── examples/ # Exemplos de uso
│ └── example-1.md
└── CHANGELOG.md # Registros de mudanças
(3) Padrões de Numeração de Versão
Versionamento Semântico: MAJOR.MINOR.PATCH
MAJOR: Mudanças incompatíveis (mudança de formato de saída)
MINOR: Adições compatíveis retroativamente (nova dimensão de revisão)
PATCH: Correções compatíveis retroativamente (corrigir ambiguidade do prompt)
Exemplo:
1.0.0 → Primeiro release oficial
1.1.0 → Adicionada dimensão de revisão de segurança
1.1.1 → Corrigido problema de formato de saída da revisão
2.0.0 → Reestruturado formato de saída (incompatível com versão anterior)
3. Descoberta e Instalação
(1) Canais de Descoberta
| Canal | Características | Ideal Para |
|---|---|---|
| Repositórios GitHub | Gerenciado por versão, rastreável | Compartilhamento interno de equipe |
| Fóruns da comunidade | Discussão + feedback | Skills genéricas |
| Marketplace oficial | Revisão de qualidade | Skills de alta qualidade |
| Recomendações de colegas | Alta confiança | Skills específicas da indústria |
(2) Processo de Instalação
# Método 1: Cópia direta
cp community/code-review.md .claude/skills/
# Método 2: Submódulo Git
git submodule add https://github.com/team/skills.git .claude/skills-external
# Método 3: Symlink (para desenvolvimento)
ln -s ~/shared-skills/code-review.md .claude/skills/code-review.md
(3) Gerenciamento de Dependências
# Declaração de dependências da Skill
dependencies:
tools:
- Read
- Bash
skills:
- name: base-review
version: ">=1.0.0"
mcp_servers:
- database
4. Prática de Biblioteca de Skills de Equipe
▶ Exemplo: Construindo uma Biblioteca de Skills de Equipe
Alice estabeleceu uma biblioteca de skills padronizada para a equipe:
Biblioteca de Skills da Equipe
├── 01-execution/ # Skills que executam tarefas diretamente
│ ├── deploy.md
│ ├── test-runner.md
│ └── lint-fix.md
├── 02-review/ # Skills para análise e avaliação
│ ├── code-review.md
│ ├── security-scan.md
│ └── performance-check.md
├── 03-assistant/ # Skills que fornecem sugestões
│ ├── doc-generator.md
│ └── refactor-advisor.md
└── README.md # Índice e guia de uso
Bob disse: "Uma biblioteca de Skills não é apenas jogar arquivos juntos — precisa de categorização, indexação e gerenciamento de versão, caso contrário não é diferente de uma pilha de arquivos aleatórios."
❓ Perguntas Frequentes
P: Skills da comunidade podem ser confiadas diretamente? R: Não. Você deve revisar o conteúdo do prompt antes de instalar para confirmar que não contém instruções maliciosas (como ler arquivos secretos, executar comandos perigosos). P: Como lidar com conflitos entre Skills de equipe e pessoais? R: Skills de equipe têm prioridade maior que Skills pessoais. Personalizações pessoais vão no diretório global; padrões de equipe vão no diretório do projeto. P: E se uma atualização de Skill quebrar compatibilidade com projetos antigos? R: Use versionamento semântico. Mudanças de versão major indicam incompatibilidade; projetos antigos fixam no número de versão major.
📖 Resumo
- Três métodos de compartilhamento: Repositório Git, embarcado no projeto, instalação global
- Processo de publicação: Verificação de qualidade → empacotar → número de versão → publicar
- Descoberta e instalação: GitHub, comunidade, marketplace + gerenciamento de dependências
- Biblioteca de skills de equipe: Gerenciamento categorizado, manutenção de índice, fixação de versão
📝 Exercícios
- Básico (⭐): Organize suas Skills criadas em um repositório Git com um índice README.
- Intermediário (⭐⭐): Crie uma biblioteca de skills de equipe categorizada com pelo menos 1 Skill para cada categoria: execução, revisão e assistente.
- Avançado (⭐⭐⭐): Projete um sistema de gerenciamento de dependências de Skills com suporte a declarações de versão, verificações de compatibilidade e notificações de atualização automática.
