# 2.1 — O que é uma skill + banco de skills prontas / m02-a01

**Objetivo:** Encontrar, inspecionar e instalar uma skill no escopo correto, com teste de comportamento.

**Preparação:** Preparar projeto vazio, ferramenta de instalação compatível e uma skill selecionada com dependências identificadas.

**Ensaio:** Instalação e execução da skill de catálogo devem ser ensaiadas na versão escolhida.

### m02-a01-b01 — Um procedimento que você não precisa repetir

Slide m02-a01-s01

Se você explica a mesma tarefa a cada nova conversa com a IA, essa explicação pode virar uma skill.

Uma skill é uma pasta com as instruções de um procedimento e, quando necessário, arquivos de apoio. O arquivo principal dessa pasta se chama SKILL.md. Nele, a skill pode dizer quando deve ser usada, que entrada precisa receber, quais critérios seguir e como entregar o resultado. Com isso, o agente, que é o assistente de IA que executa a tarefa para você, reconhece o pedido e parte de um padrão, em vez de começar do zero. A variação diminui, mas o resultado continua pedindo a sua conferência.

Pense num resumo de reunião. “Faça um resumo bom” deixa muita coisa em aberto. O que é importante? A decisão aparece junto de quem ficou responsável? Como registrar um prazo que ninguém definiu? Uma skill útil responde a essas perguntas antes da execução.

O caminho desta aula tem quatro passos: encontrar uma skill pronta, inspecionar antes de instalar, instalar só uma, no lugar certo, e testar com uma entrada de exemplo. Para começar, veja na tela a pasta e o arquivo de uma skill de exemplo, o skill-resumo-exemplo.md. Ele serve apenas como material didático, para mostrar a forma que uma skill tem por dentro.

### m02-a01-b04 — Procurar e inspecionar antes de instalar

Slide m02-a01-s04

Agora vamos procurar uma opção pronta. Abra skills.sh, com esse s no final de skills. É um diretório, isto é, uma lista de skills publicadas por outras pessoas. Procure uma tarefa, como trabalhar com documentos, em vez de procurar uma skill que prometa fazer tudo. Vamos escolher uma opção e seguir até o repositório de origem, que é o lugar onde o projeto está publicado, com todos os arquivos. O diretório ajuda a descobrir; a origem mostra o que você está instalando.

No repositório, abra o SKILL.md. Peça ao Claude para ler esse arquivo e explicar a entrada, o procedimento e a saída. Depois peça para apontar scripts, dependências, acesso à rede e instruções de instalação. Script é um arquivo de comandos que o computador executa. Dependência é outro programa ou pacote de que a skill precisa para funcionar. Compare a explicação do Claude com os arquivos. Um script pode fazer mais do que o nome sugere, então não execute só porque apareceu uma recomendação bem escrita.

Veja também quem mantém o projeto, quando ele mudou pela última vez e qual é a licença, que define em que condições você pode usar o material. Número de instalações, estrelas e análises do diretório ajudam a orientar a investigação, mas nenhum deles garante que a skill seja segura ou adequada ao seu processo. Se aparecer selo ou auditoria, leia o que foi avaliado. Uma inspeção automática pode ter escopo limitado.

Vá registrando tudo no arquivo ficha-inspecao-skill.md, antes de instalar: a tarefa, a origem, os riscos concretos que você encontrou e como pretende testar. Para começar, prefira uma tarefa pequena, uma fonte identificável e uma instalação que você consiga remover. Anote também o repositório e a versão, ou o commit, usados no exercício. O commit é o registro de uma versão específica do projeto, e permite que você volte a olhar exatamente o que usou.

### m02-a01-b02 — Encontrar e inspecionar uma opção

Slide m02-a01-s02

Com a ficha em andamento, falta decidir qual opção seguir. O objetivo desta aula é aprender a escolher e instalar uma só skill. Escolha uma compatível com o exemplo do resumo de reunião e releia, na ficha, de onde ela vem, o que ela orienta e quais recursos usa. Ela executa scripts? Acessa a rede? Depende de uma conta ou de outra ferramenta? O nome e o número de instalações não respondem a nada disso. Popularidade não é garantia de confiança.

Pode acontecer de a skill vir dentro de um plugin. Plugin é um pacote que pode reunir skills, conexões com serviços e outros recursos. Instalar um plugin não significa que você autorizou o acesso a um serviço: essa autorização é um passo à parte, e vale conceder só o acesso de que a tarefa precisa.

Depois, escolha o escopo, que é o alcance da instalação. Dependendo do agente e do local de instalação, a skill fica restrita a um projeto ou disponível em outros trabalhos. Para um procedimento específico de um cliente, comece pelo projeto: fica mais fácil de organizar. Para algo de uso frequente, vale avaliar uma instalação mais ampla, depois de testar no projeto.

Depois de instalar, vamos conferir a pasta e o arquivo SKILL.md e ver se o agente reconhece a skill. Isso mostra que ela está instalada e visível. O teste só termina quando executamos uma entrada de exemplo.

### m02-a01-b05 — Projeto e instalação global na prática

Slide m02-a01-s05

Vamos instalar somente a skill escolhida no projeto de exercício. A documentação atual da CLI skills usa o comando npx skills add com a origem do repositório. CLI é uma ferramenta que você usa digitando comandos. Você pode pedir ao Claude para preparar o comando com a origem, o nome da skill e o agente que está usando. Leia a seleção antes de executar. Se o Claude pedir permissão para rodar o comando, confira se ele corresponde ao que você preparou e só então aprove. Instalar uma coleção inteira torna mais difícil entender o que entrou.

Por padrão, essa CLI instala no projeto. Por isso, no primeiro ensaio, vamos rodar sem a opção -g. A opção global, o -g, amplia a disponibilidade para outros projetos do usuário. No Claude Code, confira a pasta de skills do projeto, que é .claude/skills, e a pasta de skills do usuário. Em outros agentes, o caminho pode mudar: o Codex, por exemplo, também lê a pasta .agents/skills. Não confunda uma pasta que apenas guarda arquivos de referência com uma pasta que o agente realmente descobre.

Organize o exercício com entrada, saída e procedimento em lugares claros: onde fica o arquivo que a skill vai ler, onde a saída será salva e onde está a skill. Depois da instalação, peça ao Claude para localizar a skill e explicar quando ela deve ser usada. Se não aparecer, confira o agente escolhido, o escopo, a estrutura da pasta e se a sessão precisa ser reiniciada ou atualizada para descobrir a skill nova. Só então execute uma entrada fictícia. Ver a skill listada pelo agente prova que ela foi descoberta; abrir e conferir a entrega é o teste do comportamento. Guarde também como desabilitar ou remover a instalação, para voltar ao estado anterior se necessário.

### m02-a01-b06 — Um manual com critérios e limites

Slide m02-a01-s06

Olhe novamente para o resumo de reunião. Uma instrução como “faça um bom resumo” não diz o que bom significa. O manual precisa tornar essa expectativa observável: separar decisões de sugestões, preservar responsáveis e registrar ausência de prazo.

Agora imagine duas skills com o mesmo nome. Uma exige inventar uma prioridade para toda ação; outra permite marcar prioridade não definida. Qual serve ao seu processo? Depende do que você precisa decidir e do que a entrada informa. É por isso que a inspeção não termina na confiança do autor. Você também avalia se a skill se adequa ao seu trabalho.

Para isso, monte dois testes para a skill escolhida e escreva o resultado esperado antes de rodar. O primeiro usa uma entrada normal, como uma reunião com decisões, responsáveis e prazos claros. O segundo usa uma entrada incompleta, como uma reunião em que ninguém definiu o prazo. Os materiais da aula trazem dois arquivos fictícios, conversa-demo.txt e conversa-incompleta.txt, que você pode usar nesses papéis. Para cada teste, defina duas condições de aceite e uma condição de falha. Por exemplo: aceite, se as decisões vierem separadas das sugestões e se cada responsável for preservado; falha, se a skill inventar um prazo que ninguém combinou.

Depois de rodar, abra a saída e compare com essas condições, não só com a aparência do texto. Registre a entrada, a expectativa, a saída observada e a decisão: manter, ajustar ou remover a skill. Se o teste falhar, guarde a saída e a regra que não foi atendida. Você pode corrigir o procedimento, escolher outra skill ou concluir que a tarefa precisa de uma ferramenta adicional. Uma boa seleção inclui a capacidade de dizer “esta opção não serve para este caso”.

### m02-a01-b03 — O que precisa ficar claro

Slide m02-a01-s03

Para fechar, vale ter à mão um roteiro de leitura que serve para qualquer skill. Ao ler uma, procure quatro coisas. O nome identifica a skill. A descrição ajuda o agente a perceber quando usá-la. O corpo apresenta o procedimento. E os arquivos extras, se existirem, guardam exemplos, referências ou scripts, quando a tarefa realmente precisa deles.

Uma pasta cheia não é melhor por isso. O que importa é se o material ajuda a executar a tarefa sem deixar decisões importantes ao acaso.

Agora é com você. A atividade desta aula reúne tudo o que vimos, e as orientações estão no arquivo exercicios.md, na pasta de apoio. Pause o vídeo, escolha uma skill relacionada ao processo que você anotou nas aulas anteriores e explique, com suas palavras, o que ela recebe e o que entrega. Se, lendo o material, você não consegue responder, ainda falta clareza. E isso vem antes de instalar. Em seguida, preencha a ficha de inspeção, instale só essa skill e teste uma entrada normal e outra incompleta.

Você terminou quando a origem e o escopo estiverem documentados, quando a entrega observada tiver sido comparada com os critérios que você definiu antes de rodar, e quando a decisão não tiver se apoiado em popularidade.

Na próxima aula, vamos experimentar opções prontas, ver o que acontece quando uma skill pronta encontra uma necessidade específica e comparar o seu diagnóstico de hoje com o resultado real.

# 2.1 — O que é uma skill + banco de skills prontas

ID m02-a01. Roteiro técnico — Rocco adaptado ao ensino.

TC da imagem e TC da fala são independentes. Slides novos não têm TC de fonte; fala escrita ainda não tem gravação. “—” indica não uso deliberado de depoimento/trilha. IDs são localizadores editoriais, não timecodes.

**Preparação específica:** Preparar projeto vazio, ferramenta de instalação compatível e uma skill selecionada com dependências identificadas.

**Dependências e ensaio:** Instalação e execução da skill de catálogo devem ser ensaiadas na versão escolhida.

| Bloco | Slide/PDF | Ação | Conferência |
|---|---|---|---|
| m02-a01-b01 | m02-a01-s01 / p. 1 | Mostrar o arquivo e a pasta de uma skill de exemplo; usar apoio/skill-resumo-exemplo.md apenas como material didático. | Pasta e SKILL.md são localizados e sua finalidade é explicada. |
| m02-a01-b04 | m02-a01-s04 / p. 2 | Inspecionar uma skill de documentos no diretório e no repositório de origem. | Ficha identifica tarefa, origem, riscos concretos e critérios de teste. |
| m02-a01-b02 | m02-a01-s02 / p. 3 | Abrir skills.sh; selecionar uma skill compatível com o exemplo e ler origem, SKILL.md e dependências antes da instalação. Escolha exata deve ser conferida no ensaio. | Origem e dependências são lidas antes da instalação; caminho instalado é conferido. |
| m02-a01-b05 | m02-a01-s05 / p. 4 | Instalar uma única skill no projeto e conferir pasta, descoberta e saída. | Skill correta instalada no escopo escolhido e saída conferida; sem instalação indiscriminada. |
| m02-a01-b06 | m02-a01-s06 / p. 5 | Montar dois testes para a skill escolhida e registrar resultado esperado antes de rodar. | Teste contém entrada, expectativa, saída observada e decisão de manter/ajustar/remover. |
| m02-a01-b03 | m02-a01-s03 / p. 6 | Conferir nome, descrição, instruções e recursos do exemplo; orientar a atividade no apoio/exercicios.md. | Origem e escopo documentados; entrega observada confrontada com critérios prévios; popularidade não usada como certificado. |

## m02-a01-b01 — Um procedimento que você não precisa repetir

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Mostrar o arquivo e a pasta de uma skill de exemplo; usar apoio/skill-resumo-exemplo.md apenas como material didático. | slides/m02-a01.pptx e slides/m02-a01.pdf, página 1, ID m02-a01-s01; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m02-a01-b01 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m02-a01-b01. Sem trilha prevista. |

**Estado inicial:** Preparar projeto vazio, ferramenta de instalação compatível e uma skill selecionada com dependências identificadas.

**Entrada/material:** apoio/ficha-inspecao-skill.md, apoio/skill-resumo-exemplo.md, apoio/conversa-demo.txt, apoio/conversa-incompleta.txt

**Passos de captura:**
1. Mostrar o arquivo e a pasta de uma skill de exemplo; usar apoio/skill-resumo-exemplo.md apenas como material didático.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Pasta e SKILL.md são localizados e sua finalidade é explicada.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m02-a01-b01; SHA-256 16a9fce770819d95c6044f00205f023a296ca0692a650ac801400c0e6ce0743b.

**Função visual:** Mostrar o arquivo e a pasta de uma skill de exemplo; usar apoio/skill-resumo-exemplo.md apenas como material didático.


## m02-a01-b04 — Procurar e inspecionar antes de instalar

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Inspecionar uma skill de documentos no diretório e no repositório de origem. | slides/m02-a01.pptx e slides/m02-a01.pdf, página 2, ID m02-a01-s04; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m02-a01-b04 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m02-a01-b04. Sem trilha prevista. |

**Estado inicial:** Preparar projeto vazio, ferramenta de instalação compatível e uma skill selecionada com dependências identificadas.

**Entrada/material:** apoio/ficha-inspecao-skill.md, apoio/skill-resumo-exemplo.md, apoio/conversa-demo.txt, apoio/conversa-incompleta.txt

**Passos de captura:**
1. Pesquisar em skills.sh e abrir origem.
2. Ler SKILL.md, scripts, dependências e licença.
3. Preencher ficha-inspecao-skill.md antes de instalar.

**Saída e conferência:** Ficha identifica tarefa, origem, riscos concretos e critérios de teste.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m02-a01-b04; SHA-256 fabc162f242a573166c3fde9d014cc8b3becf9d9ec74921cc09264f558577010.

**Função visual:** Inspecionar uma skill de documentos no diretório e no repositório de origem.


## m02-a01-b02 — Encontrar e inspecionar uma opção

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Abrir skills.sh; selecionar uma skill compatível com o exemplo e ler origem, SKILL.md e dependências antes da instalação. Escolha exata deve ser conferida no ensaio. | slides/m02-a01.pptx e slides/m02-a01.pdf, página 3, ID m02-a01-s02; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m02-a01-b02 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m02-a01-b02. Sem trilha prevista. |

**Estado inicial:** Preparar projeto vazio, ferramenta de instalação compatível e uma skill selecionada com dependências identificadas.

**Entrada/material:** apoio/ficha-inspecao-skill.md, apoio/skill-resumo-exemplo.md, apoio/conversa-demo.txt, apoio/conversa-incompleta.txt

**Passos de captura:**
1. Abrir skills.sh; selecionar uma skill compatível com o exemplo e ler origem, SKILL.md e dependências antes da instalação. Escolha exata deve ser conferida no ensaio.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Origem e dependências são lidas antes da instalação; caminho instalado é conferido.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m02-a01-b02; SHA-256 c64ea71fe6bd6fb62c5d4ec9d0848c66ebbe820056cfa006b665e5cdba074404.

**Função visual:** Abrir skills.sh; selecionar uma skill compatível com o exemplo e ler origem, SKILL.md e dependências antes da instalação. Escolha exata deve ser conferida no ensaio.


## m02-a01-b05 — Projeto e instalação global na prática

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Instalar uma única skill no projeto e conferir pasta, descoberta e saída. | slides/m02-a01.pptx e slides/m02-a01.pdf, página 4, ID m02-a01-s05; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m02-a01-b05 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m02-a01-b05. Sem trilha prevista. |

**Estado inicial:** Preparar projeto vazio, ferramenta de instalação compatível e uma skill selecionada com dependências identificadas.

**Entrada/material:** apoio/ficha-inspecao-skill.md, apoio/skill-resumo-exemplo.md, apoio/conversa-demo.txt, apoio/conversa-incompleta.txt

**Passos de captura:**
1. Preparar comando com origem/skill/agente explícitos.
2. Instalar no projeto, sem -g no primeiro ensaio.
3. Conferir diretório real e descoberta numa sessão de exercício.
4. Executar entrada fictícia e abrir saída.

**Saída e conferência:** Skill correta instalada no escopo escolhido e saída conferida; sem instalação indiscriminada.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m02-a01-b05; SHA-256 9d51aea5977a5afe6eaffb68811bf7dfe269ad367169f5c4e5e5a79d2ee7c346.

**Função visual:** Instalar uma única skill no projeto e conferir pasta, descoberta e saída.


## m02-a01-b06 — Um manual com critérios e limites

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Montar dois testes para a skill escolhida e registrar resultado esperado antes de rodar. | slides/m02-a01.pptx e slides/m02-a01.pdf, página 5, ID m02-a01-s06; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m02-a01-b06 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m02-a01-b06. Sem trilha prevista. |

**Estado inicial:** Preparar projeto vazio, ferramenta de instalação compatível e uma skill selecionada com dependências identificadas.

**Entrada/material:** apoio/ficha-inspecao-skill.md, apoio/skill-resumo-exemplo.md, apoio/conversa-demo.txt, apoio/conversa-incompleta.txt

**Passos de captura:**
1. Escrever entrada normal e incompleta.
2. Definir duas condições de aceite e uma condição de falha.
3. Comparar a entrega com essas condições, não só com aparência.

**Saída e conferência:** Teste contém entrada, expectativa, saída observada e decisão de manter/ajustar/remover.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m02-a01-b06; SHA-256 61f5374e780966d497667beee62d37b97865bb9395cfc7640254500eac7ac94b.

**Função visual:** Montar dois testes para a skill escolhida e registrar resultado esperado antes de rodar.


## m02-a01-b03 — O que precisa ficar claro

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Conferir nome, descrição, instruções e recursos do exemplo; orientar a atividade no apoio/exercicios.md. | slides/m02-a01.pptx e slides/m02-a01.pdf, página 6, ID m02-a01-s03; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m02-a01-b03 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m02-a01-b03. Sem trilha prevista. |

**Estado inicial:** Preparar projeto vazio, ferramenta de instalação compatível e uma skill selecionada com dependências identificadas.

**Entrada/material:** apoio/ficha-inspecao-skill.md, apoio/skill-resumo-exemplo.md, apoio/conversa-demo.txt, apoio/conversa-incompleta.txt

**Passos de captura:**
1. Conferir nome, descrição, instruções e recursos do exemplo; orientar a atividade no apoio/exercicios.md.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Origem e escopo documentados; entrega observada confrontada com critérios prévios; popularidade não usada como certificado.

**Se falhar:** Parar na ação que falhou, registrar mensagem sem credenciais e restaurar a entrada de teste antes de repetir o trecho. Não narrar uma entrega que não foi observada.

**Corte e continuidade:** Entrada: enquadramento e fonte do trecho prontos. Saída: concluir a conferência. Retirar espera sem ação e tentativas abandonadas; preservar o contexto, a decisão e a última frase completa.

**Fala correspondente:** roteiro-fala.md / m02-a01-b03; SHA-256 7e5cc5c7a4b56f48054e53f91322022ab6bcecb7d6ae8e2235342334cb842be6.

**Função visual:** Conferir nome, descrição, instruções e recursos do exemplo; orientar a atividade no apoio/exercicios.md.


## Atividade e solução

Escolher uma skill, preencher a inspeção, instalar só ela e testar uma entrada normal e outra incompleta.

Origem e escopo documentados; entrega observada confrontada com critérios prévios; popularidade não usada como certificado.

## Materiais

- ficha-inspecao-skill.md
- skill-resumo-exemplo.md
- conversa-demo.txt
- conversa-incompleta.txt