Skills e plugins do Claude Code

O que é uma skill, exatamente

Uma skill apresenta instruções de forma progressiva. O modelo vê inicialmente apenas o nome e a descrição da skill; quando uma tarefa corresponde a ela, lê o SKILL.md completo e os arquivos que a skill indica. Isso mantém o contexto pequeno e oferece ao agente conhecimento aprofundado e específico da tarefa sob demanda — procedimentos, regras de estilo, listas de verificação do domínio e até scripts auxiliares executáveis.

---
name: release-notes
description: Write release notes from the git log in this repo's house style. Use when asked for a changelog or release notes.
---

1. Run `git log --oneline <last-tag>..HEAD`.
2. Group commits by area (api, ui, infra). Drop chores.
3. One line per change, user-facing wording, no commit hashes.
4. Output in the format of CHANGELOG.md; do not edit the file unless asked.

Onde o Claude Code encontra skills

~/.claude/skills/<name>/SKILL.md — pessoais, em todos os projetos.
.claude/skills/<name>/SKILL.md — versionadas no repositório, compartilhadas com a equipe.
Dentro de plugins — o mecanismo de distribuição de conjuntos de skills, comandos de barra, subagentes e configuração MCP.

O marketplace de plugins

/plugin marketplace add anthropics/claude-code   # register a marketplace (any git repo with a manifest)
/plugin install <name>@<marketplace>          # install from it
/plugin                                        # browse, enable, disable, update

Um marketplace é apenas um repositório com um manifesto de plugins, portanto as equipes hospedam marketplaces privados da mesma forma. As skills oficiais da Anthropic ficam em github.com/anthropics/skills — skills de documentos (PDF, DOCX, XLSX, PPTX), uma skill de criação de skills e exemplos que vale a pena ler antes de escrever a sua.

Skills que as pessoas realmente instalam

Skills de documentos — leia e produza arquivos PDF, Word, Excel e PowerPoint corretamente, em vez de tentar adivinhar.
Skills de design de interfaces — uma biblioteca de componentes, tokens e regras de layout para que a interface gerada corresponda ao produto.
Skills de testes e revisão — a definição de pronto da equipe, codificada uma única vez.
Procedimentos de implantação — os comandos e as verificações exatos, com barreiras de proteção para os perigosos.
Nossa lista selecionada, com links e a finalidade de cada item: github.com/iskandaryv/awesome-claude-skills.

Como escrever uma boa skill

Seja específico na descrição sobre *quando* usá-la — é nisso que o modelo se baseia para identificar correspondências.
Mantenha o SKILL.md curto e coloque o material de referência extenso em arquivos separados para os quais a skill fornece links.
Prefira scripts para etapas determinísticas; o modelo deve chamá-los, não deduzi-los novamente.
Teste-a com /skills em uma sessão e observe se ela é acionada nas tarefas que você pretendia.

Subagentes, hooks e MCP têm seus próprios guias

As skills são um dos quatro pontos de extensão. Subagentes (agentes separados com seu próprio contexto), hooks (comandos de shell em eventos de ferramentas) e servidores MCP (ferramentas e dados externos) têm, cada um, um guia dedicado nesta central; as skills são o ponto que reúne procedimentos para todos eles.

Skills no gateway

As skills são arquivos na sua máquina, lidos pelo ambiente de execução do Claude Code, portanto são totalmente independentes do endpoint de API configurado. Sessões que usam muitas skills também são sessões longas — justamente o caso para o qual um plano de preço fixo foi feito.

Experimente gratuitamente primeiro

Novas contas recebem $5 em crédito gratuito para a API com o código CLAUDECODE — suficiente para uma noite de Claude Code com Sonnet — e depois créditos com 7.69231× o valor nominal.

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

Crie uma conta com o código CLAUDECODE

Perguntas frequentes

Qual é a diferença entre uma skill e um plugin?

Uma skill é uma capacidade (uma pasta com SKILL.md). Um plugin é um pacote distribuível que pode conter várias skills, além de comandos de barra, subagentes e servidores MCP, instalado a partir de um marketplace.

As skills do Claude Code são gratuitas?

Sim. As skills oficiais da Anthropic e as coleções da comunidade são repositórios abertos; as skills só consomem tokens quando são efetivamente carregadas em uma sessão.

Onde fica o marketplace de skills do Claude Code?

Não existe uma loja única. Qualquer repositório git com um manifesto de plugins é um marketplace; registre-o com /plugin marketplace add. Os próprios repositórios da Anthropic são o ponto de partida habitual.

Posso usar skills com o Agent SDK?

Sim — o SDK usa o mesmo ambiente de execução, portanto as skills nos diretórios padrão são carregadas da mesma forma.

Execute o Claude Code no gateway

Os mesmos modelos, duas variáveis de ambiente, créditos com 7.69231× o valor nominal — ou um plano ilimitado com preço fixo. Novas contas: $5 em crédito gratuito para a API com o código CLAUDECODE.

Obter uma chave de API Ver planos ilimitados

A AI Prime Tech é um gateway de API independente e não é afiliada, endossada nem patrocinada pela Anthropic. “Claude” e “Claude Code” são marcas comerciais da Anthropic. Os recursos do Claude Code descritos aqui seguem a documentação pública da Anthropic no momento da redação e mudam com frequência; os preços e as listas de modelos nesta página são obtidos das configurações atuais deste gateway.

TLDR