Qual a diferença entre comando, skill e subagente?

O comando é um atalho simples que você chama por nome, a forma mais básica de skill. A skill é um procedimento empacotado, acionado sob demanda, que pode ter arquivos de apoio. O subagente é um ajudante com contexto isolado, para tarefas ruidosas, especializadas ou paralelas. Cada um resolve uma necessidade distinta.

Como escolho entre eles?

Por perguntas: é um atalho rápido e repetido? Comando. É um procedimento reutilizável, talvez com modelos e referências? Skill. É uma tarefa ruidosa, especializada com poderes restritos ou que pede isolamento? Subagente. E eles se combinam: uma skill pode até acionar um subagente para a parte pesada.

É um pacote que reúne extensões, skills, subagentes, comandos e outros recursos, para instalar de uma vez. Você pode instalar plugins prontos, de marketplaces oficiais e da comunidade, e empacotar as suas extensões num plugin para compartilhar com o time ou a comunidade. É a forma de compartilhar em escala.

É seguro instalar plugins e skills de terceiros?

Requer cuidado. Plugins e skills executam instruções, então merecem revisão antes de você confiar, como qualquer código ou instrução alheia. Prefira fontes confiáveis, como o marketplace oficial e a comunidade verificada. As suas próprias extensões são seguras por natureza, porque você as escreveu.

Módulo 11 - Skills

Skills, comandos e subagentes: quando usar cada um

7 min de leitura · por Cesar Gargiulo, revisado pela equipe ValorFinal e GuardiaSec · Atualizado em 13/07/2026

O que você vai aprender

Diferenciar skills, comandos e subagentes.
Escolher a extensão certa para cada necessidade.
Ver como as três se complementam.
Conhecer os plugins como forma de compartilhar em escala.

Três formas de estender, propósitos diferentes

Ao longo do curso, você aprendeu três formas de estender o Claude Code, e agora vale colocá-las lado a lado. O comando é o mais simples: um atalho que você chama por nome para disparar um pedido pronto, ideal para tarefas rápidas e repetidas. A skill é o passo além: um procedimento empacotado, que o agente aciona sob demanda pela descrição e que pode incluir arquivos de apoio, ideal para métodos e conhecimentos reutilizáveis. O subagente é diferente na natureza: um ajudante com contexto isolado, ideal quando a tarefa é ruidosa, especializada ou precisa acontecer em separado da conversa principal. Comando, skill e subagente resolvem necessidades distintas.

Extensão	Melhor para	Marca registrada
Comando	Atalho rápido e repetido	Você chama por nome
Skill	Procedimento reutilizável, sob demanda	Acionada pela descrição, com arquivos de apoio
Subagente	Tarefa ruidosa, especializada ou isolada	Contexto próprio, devolve só o resumo

Cada extensão tem o seu ponto forte. Muitas vezes elas se combinam num mesmo fluxo de trabalho.

Vale lembrar que comando e skill não são coisas separadas, mas pontos de um mesmo espectro: o comando é a forma mais simples de skill, e a skill completa é o comando levado ao máximo, com descrição rica, acionamento automático e arquivos de apoio. Já o subagente é uma categoria à parte, definida pelo contexto isolado. Na prática, você usa os três conforme a tarefa: um comando para o atalho do dia a dia, uma skill para o procedimento reutilizável, um subagente para o trabalho pesado que merece contexto próprio. Não é escolher um em detrimento dos outros; é ter um repertório e pegar a ferramenta certa para cada momento.

Como escolher a extensão certa

A escolha fica simples com algumas perguntas. É um atalho para um pedido rápido que você repete? Um comando resolve. É um procedimento ou método que você quer que o agente aplique sob demanda, talvez com modelos e referências? É uma skill. É uma tarefa que encheria a conversa principal de ruído, ou que pede um especialista com poderes restritos, ou que precisa rodar em paralelo? É um subagente. E, muitas vezes, a resposta combina: você pode ter uma skill que, internamente, aciona um subagente para a parte pesada. As extensões se encaixam, e dominar as três te dá flexibilidade para montar fluxos sob medida.

🎮 Jogo da aula

Comando, skill ou subagente?

Classifique cada necessidade conforme a extensão mais adequada.

Uma dica que atravessa as três: comece simples e cresça conforme a necessidade. Muita gente tenta montar subagentes e skills elaboradas cedo demais, antes de sentir a dor que elas resolvem. O caminho melhor é o oposto: use o Claude Code normalmente, note onde você repete instruções ou onde a conversa fica poluída, e crie a extensão certa para aquela dor específica. Assim, cada comando, skill ou subagente que você cria nasce de uma necessidade real e é de fato usado. Extensões criadas por antecipação, sem uma dor clara, costumam virar peças esquecidas. Deixe as suas nascerem do uso.

Plugins: compartilhar em escala

Há um recurso que reúne tudo isso e leva ao compartilhamento em escala: os plugins. Um plugin é um pacote que pode conter skills, subagentes, comandos e outros recursos juntos, para instalar de uma vez. Em vez de criar cada extensão à mão, você pode instalar um plugin que já traz um conjunto de habilidades prontas, e pode empacotar as suas extensões num plugin para compartilhar com o time ou com a comunidade. Existem catálogos, os marketplaces, de onde se instalam plugins, com pacotes oficiais da Anthropic e da comunidade. É a forma de o ecossistema de extensões crescer e circular, muito além do que cada pessoa cria sozinha.

Com este módulo, você fecha o conjunto de recursos que transformam o Claude Code de uma ferramenta pronta numa plataforma que você molda: comandos, subagentes e skills, com os plugins como forma de compartilhar. Combinado com a base de conversar, controlar permissões, planejar e usar git, você tem um domínio profundo da ferramenta. Os próximos módulos entram em recursos que conectam o Claude Code ao mundo externo e ao trabalho de escala: o protocolo que liga o agente a ferramentas e dados de fora, a configuração avançada e a automação. Você chega neles como um usuário que não só usa, mas estende o Claude Code com maestria.

Teste rápido

O que é um plugin no Claude Code?

Perguntas frequentes

Qual a diferença entre comando, skill e subagente?: O comando é um atalho simples que você chama por nome, a forma mais básica de skill. A skill é um procedimento empacotado, acionado sob demanda, que pode ter arquivos de apoio. O subagente é um ajudante com contexto isolado, para tarefas ruidosas, especializadas ou paralelas. Cada um resolve uma necessidade distinta.
Como escolho entre eles?: Por perguntas: é um atalho rápido e repetido? Comando. É um procedimento reutilizável, talvez com modelos e referências? Skill. É uma tarefa ruidosa, especializada com poderes restritos ou que pede isolamento? Subagente. E eles se combinam: uma skill pode até acionar um subagente para a parte pesada.
Qual a melhor forma de começar a criar extensões?: Comece simples e deixe as extensões nascerem do uso. Use o Claude Code normalmente, note onde repete instruções ou onde a conversa fica poluída, e crie a extensão certa para aquela dor. Extensões criadas por antecipação, sem uma necessidade clara, costumam virar peças esquecidas.
O que é um plugin?: É um pacote que reúne extensões, skills, subagentes, comandos e outros recursos, para instalar de uma vez. Você pode instalar plugins prontos, de marketplaces oficiais e da comunidade, e empacotar as suas extensões num plugin para compartilhar com o time ou a comunidade. É a forma de compartilhar em escala.
É seguro instalar plugins e skills de terceiros?: Requer cuidado. Plugins e skills executam instruções, então merecem revisão antes de você confiar, como qualquer código ou instrução alheia. Prefira fontes confiáveis, como o marketplace oficial e a comunidade verificada. As suas próprias extensões são seguras por natureza, porque você as escreveu.

Fontes

Seu progresso fica salvo neste aparelho. Assinantes sincronizam entre os aparelhos.

← Skills com arquivos de apoio Concluir e avançar →