📝 O que sao Skills
Skills sao instrucoes em Markdown que voce salva na pasta .claude/commands/ do seu projeto. Elas funcionam como slash commands customizados: voce digita /project:nome-da-skill e o Claude segue as instrucoes passo a passo. Nao e codigo, nao e API, nao e plugin. E texto puro que guia o comportamento do agente.
🎯 Conceito Principal
Uma Skill e um prompt estruturado e reutilizavel. Em vez de digitar as mesmas instrucoes toda vez que precisa de um code review, voce cria uma skill que define exatamente o que checar, em que ordem, e como formatar a saida. O Claude le o Markdown e executa como se voce tivesse digitado tudo manualmente.
- • Formato: Arquivo .md com instrucoes em linguagem natural
- • Ativacao: Via slash command /project:nome ou /user:nome
- • Custo: Zero instalacao, zero dependencias, zero configuracao
💡 Dica Pratica
Pense em Skills como "receitas de bolo" para o Claude. Cada skill tem ingredientes (inputs), passos (instrucoes) e resultado esperado (output). A beleza e que qualquer pessoa no time pode usar a mesma skill e obter resultados consistentes, independente de quao bem ela sabe promptar.
🔌 O que sao MCPs
MCPs (Model Context Protocol) sao servidores externos que dao ao Claude acesso a ferramentas que ele nao tem nativamente: bancos de dados, APIs, sistemas de arquivos remotos, navegadores, etc. Diferente de Skills, MCPs envolvem codigo rodando, processos em background e comunicacao via protocolo padronizado.
🎯 Conceito Principal
Um MCP e um servidor que expoe ferramentas para o Claude usar. Quando voce configura o MCP do Supabase, por exemplo, o Claude ganha acesso a ferramentas como "query_database", "create_table", "insert_row". Ele chama essas ferramentas durante a conversa como se fossem nativas.
- • Formato: Servidor Node/Python que implementa o protocolo MCP
- • Ativacao: Configurado em .claude/settings.json ou via claude mcp add
- • Custo: Requer instalacao, configuracao e manutencao do servidor
💡 Dica Pratica
MCPs sao para quando o Claude precisa interagir com o mundo externo. Se a tarefa pode ser resolvida apenas com instrucoes de texto (code review, refatoracao, analise), use uma Skill. Se precisa conectar com Slack, banco de dados, ou API externa, ai sim voce precisa de um MCP.
📦 O que sao Plugins
Plugins sao pacotes instaláveis que combinam Skills, configuracoes e possivelmente MCPs em um unico bundle. Pense neles como "apps" para o Claude Code: voce instala uma vez e ganha um conjunto completo de funcionalidades. Plugins podem vir de um marketplace ou serem criados por voce.
🎯 Conceito Principal
Um Plugin empacota multiplas Skills (e opcionalmente MCPs) em algo que pode ser instalado, atualizado e compartilhado com um unico comando. E a evolucao natural: voce comeca com uma skill avulsa, ela cresce, voce adiciona mais, e eventualmente empacota tudo como um plugin.
- • Formato: Repositorio ou pacote com estrutura padronizada
- • Ativacao: Instalado via marketplace ou manualmente via git clone
- • Custo: Mais complexo de criar, mais facil de distribuir
💡 Dica Pratica
Nao comece por plugins. Comece criando Skills simples, valide que funcionam, e so empacote como plugin quando quiser compartilhar com o time ou a comunidade. A maioria dos workflows pode ser resolvida com 2-3 Skills individuais sem precisar de um plugin completo.
📊 Tabela Comparativa
A diferenca entre Skills, MCPs e Plugins nao e sobre qual e "melhor" - e sobre qual resolver seu problema especifico. Aqui esta a comparacao direta para voce nunca mais confundir.
🎯 Conceito Principal
| Criterio | Skill | MCP | Plugin |
|---|---|---|---|
| Formato | Markdown .md | Servidor (Node/Python) | Bundle (Skills + config) |
| Instalacao | Copiar arquivo | npm/pip + config | Marketplace / git |
| Complexidade | Baixa | Alta | Media |
| Acesso externo | Nao | Sim | Depende |
| Compartilhavel | Copiar arquivo | Publicar pacote | Marketplace |
| Manutencao | Minima | Constante | Moderada |
💡 Dica Pratica
Imprima essa tabela ou salve como referencia. Quando alguem perguntar "preciso de um MCP pra isso?", consulte a coluna "Acesso externo". Se a resposta for "nao precisa acessar nada externo", uma Skill resolve. Voce vai economizar horas de configuracao desnecessaria.
🤔 Quando Usar Cada Um
A regra de ouro e simples: comece sempre pela Skill. So escale para MCP ou Plugin quando a Skill nao resolver. A maioria das pessoas pula direto para MCPs quando uma skill de 20 linhas resolveria o problema.
🎯 Conceito Principal
- • Use Skill quando: A tarefa e sobre analisar, gerar, formatar ou transformar texto/codigo. Ex: code review, gerar testes, refatorar, criar documentacao.
- • Use MCP quando: O Claude precisa acessar algo fora do sistema de arquivos local. Ex: consultar banco de dados, enviar mensagem no Slack, acessar API do GitHub.
- • Use Plugin quando: Voce tem um conjunto de Skills + configs que quer distribuir como pacote. Ex: "plugin de DevOps" com skills de deploy, monitoring e incident response.
💡 Dica Pratica
Faca o "teste do Markdown": se voce consegue descrever a tarefa inteira em um arquivo .md com instrucoes claras, e uma Skill. Se em algum momento voce pensa "mas ele precisa acessar X pra pegar Y", ai voce precisa de um MCP. E se voce tem 5+ Skills que sempre andam juntas, considere empacotar como Plugin.
🧭 Framework de Decisao
Use este fluxograma mental toda vez que precisar automatizar algo no Claude Code. Em menos de 30 segundos voce sabe exatamente qual caminho seguir, sem perder tempo com abordagens erradas.
🎯 Conceito Principal
Pergunta 1: Precisa acessar servico externo?
SIM → MCP (ou Plugin com MCP embutido)
NAO → Vai para Pergunta 2
Pergunta 2: E uma unica tarefa ou um conjunto de tarefas?
UNICA → Skill simples (.md)
CONJUNTO → Vai para Pergunta 3
Pergunta 3: Precisa compartilhar com time/comunidade?
SIM → Plugin (empacota tudo)
NAO → Multiplas Skills na pasta .claude/commands/
💡 Dica Pratica
80% das vezes a resposta e "Skill". Isso nao e exagero - a maioria das tarefas de desenvolvimento sao sobre manipular texto e codigo, que e exatamente o que Skills fazem. Guarde MCPs e Plugins para os 20% que realmente precisam de integracao externa ou distribuicao.