# 2.2 — Explorando skills prontas / m02-a02

**Objetivo:** Testar mais de uma skill pronta e executar uma adaptação com comparação controlada.

**Preparação:** Preparar skills pdf/docx inspecionadas, dependências e aplicativos para abrir os formatos; não instalar a coleção inteira.

**Ensaio:** Ensaiar geração e abertura de ambos os formatos no ambiente da aula.

### m02-a02-b01 — Testar com uma entrada conhecida

Slide m02-a02-s01

Uma skill pode parecer ótima na descrição e, mesmo assim, não servir para o seu trabalho. Skill, aqui, é uma pasta com um arquivo de instruções escrito em texto, que o agente segue para fazer um tipo de tarefa, como resumir uma conversa. Para descobrir se uma skill serve, use uma entrada que você já conhece e compare o resultado com um critério claro.

Neste exercício, a entrada é uma conversa fictícia e curta, que está no arquivo conversa-demo.txt, na pasta de apoio. Abra esse arquivo e leia com calma. Nele existem quatro elementos que eu conheço de antemão: uma decisão, uma pessoa responsável, uma pendência e um prazo que ninguém definiu. Como sei o que está no texto, consigo conferir se o resumo manteve cada um deles.

Antes de executar qualquer coisa, escreva o que você espera encontrar no resultado. Por exemplo: qual é a decisão, quem é o responsável e que o prazo não foi informado. Assim você não avalia só pela aparência ou pelo tamanho da resposta. Um resumo bem organizado ainda pode omitir uma decisão ou transformar uma sugestão em compromisso.

E use sempre esta mesma conversa, em todas as comparações. Se a entrada muda, você deixa de saber o que causou a diferença. Por isso, deixe o arquivo original como está e trabalhe só na pasta de exercício.

### m02-a02-b04 — Duas skills prontas, duas entregas verificáveis

Slide m02-a02-s04

Vamos experimentar duas opções concretas do repositório de skills da Anthropic. Repositório é o espaço público onde ficam as pastas das skills. As duas opções são PDF e DOCX, que é o formato dos documentos do Word, quando estiverem disponíveis para o agente usado no exercício.

Antes de instalar, inspecione. Abra o arquivo de instruções de cada skill, o SKILL.md, e olhe também os scripts, que são pequenos programas que ela pode executar. Veja as dependências, ou seja, o que precisa existir no computador para ela funcionar, e as permissões que ela pede. Anote tudo na ficha de inspeção. Muitas instalações ou estrelas indicam popularidade, não segurança. E instale só essas duas skills, escolhendo o agente que você usa, sem baixar a coleção inteira. O nome do formato também não garante que todos os recursos funcionem em toda superfície.

Vamos usar a mesma conversa fictícia como conteúdo. Na primeira rodada, o pedido é produzir um documento de resumo em DOCX. Na segunda, gerar uma versão PDF com as mesmas informações. Peça que os dois arquivos sejam salvos na pasta de exercício. O procedimento de resumo define o que extrair; a skill do formato ajuda a construir o arquivo. São responsabilidades diferentes, mesmo quando o pedido reúne as duas.

Agora abra os arquivos fora da conversa, no aplicativo que abre cada formato. No DOCX, confira se o texto é editável e se os títulos e listas ficaram legíveis. No PDF, percorra todas as páginas e procure cortes e quebras estranhas. Nos dois, compare os fatos com o que você escreveu antes: decisão, responsável, pendência e prazo ausente. Um arquivo bonito com uma decisão inventada continua errado.

Se a sua conta não oferece essa skill, use a inspeção para identificar o recurso que falta e procure uma instalação compatível. Não marque o teste como concluído só porque a ferramenta descreveu como faria. O teste só vale quando o arquivo real foi aberto e conferido.

### m02-a02-b02 — Um ajuste que tem motivo

Slide m02-a02-s02

Agora vamos executar a skill de resumo com a conversa e conferir o resultado com quatro perguntas, que estão no arquivo de critérios do resumo. A decisão apareceu? O responsável é a pessoa certa? A pendência continua como pendência? E o prazo, que ninguém definiu, aparece como não informado, e não como uma data inventada?

Se alguma resposta for não, olhe o procedimento da skill, porque é nele que está a causa. Por exemplo: uma skill que ordena tudo por urgência, sem explicar o que é urgente, deixa a escolha escondida dentro do procedimento. No nosso trabalho, pode ser mais útil separar decisões, ações e perguntas abertas. Esse tipo de ajuste muda a utilidade da saída.

Antes de alterar, guarde uma cópia do procedimento original. Se o resultado piorar, você compara e volta para a regra anterior.

Depois mude um critério por vez e repita o teste com a mesma conversa. Assim você liga a mudança à diferença no resultado. Se trocar a entrada, o formato e a regra ao mesmo tempo, não dá para saber o que melhorou. No próximo bloco, o critério que vamos mudar é o do responsável.

### m02-a02-b05 — Comparar sem trocar todas as variáveis

Slide m02-a02-s05

Agora vamos olhar para uma adaptação de processo, além do formato. Uma skill genérica pode organizar o resumo por assunto; no seu trabalho, talvez seja essencial destacar ações com responsável. Não precisamos reescrever tudo para testar essa mudança.

Guarde a versão original. Depois faça uma cópia dentro da pasta de exercício e trabalhe só nela. Nessa cópia, acrescente uma regra, escrita em português, como em qualquer texto: toda ação deve trazer responsável explícito ou a indicação de que ele não foi informado. Mantenha a mesma conversa e o mesmo formato de saída. Execute novamente e compare. Se a primeira versão deixou uma ação sem responsável e a segunda marcou a ausência corretamente, temos uma diferença observável ligada à regra.

Depois use a conversa incompleta, que é a versão do texto em que falta alguma informação, como o responsável por uma ação. Essa segunda rodada evita aceitar uma mudança que só funciona no exemplo que inspirou a correção. Aqui o resultado certo é a ausência indicada, sem nome inventado.

Registre os dois resultados no registro de testes. O objetivo não é provar que a skill ficou perfeita: é mostrar o caminho de adaptar, testar e conferir. Você passa a ter um procedimento que pode evoluir com seu trabalho, em vez de depender de uma avaliação vaga como “parece melhor”.

### m02-a02-b06 — Decidir o que aproveitar e o que criar

Slide m02-a02-s06

Depois dos testes, separe três coisas. O que a skill pronta faz bem? O que depende de um critério específico da sua empresa? E o que exige um acesso que ainda não existe? Essa separação ajuda a decidir o próximo passo.

No nosso exemplo, construir um DOCX editável pode ser um recurso genérico útil. Já decidir o que entra numa proposta, de onde vem o preço e quando parar para aprovação é processo da empresa. Não esperamos que uma skill pública conheça essas regras sem receber referência.

O acesso a um serviço externo é outra coisa. Instalar uma skill não dá, por si só, permissão para usar um serviço da sua empresa. Essa permissão vem de uma conexão específica, que você autoriza, só com o que for necessário. E qualquer envio para fora, como mandar a proposta a um cliente, continua dependendo da aprovação de uma pessoa.

Agora preencha a decisão para cada skill testada: manter, adaptar ou substituir, sempre com o motivo. Ligue cada decisão a uma saída que você observou, e não a uma impressão. Por fim, liste o acesso externo separado do procedimento. Uma recomendação curta serve: manter a skill de formato, adaptar o procedimento de resumo e deixar a entrega externa para uma conexão específica. Compare os resultados e diga por que aceita ou rejeita a mudança.

Falta um passo: levar isso para o seu processo, e é o que faremos agora.

### m02-a02-b03 — O limite da skill genérica

Slide m02-a02-s03

Uma skill pronta é um ponto de partida. Ela foi feita para um conjunto de situações que pode ser diferente do seu. Você pode aproveitar a estrutura e adaptar o procedimento, desde que saiba o que está mudando. E não precisa programar para isso: a regra é um texto em português.

Agora escolha um ajuste que faria diferença no seu processo: uma informação obrigatória, uma regra de prioridade ou um formato de entrega. Escreva por que ele importa e como você vai conferir se a skill o respeitou. Execute o ajuste na cópia de exercício, com a conversa completa e com a incompleta, e confira os dois testes antes de encerrar. Se algum resultado trouxer informação inventada, o ajuste ainda não está pronto.

Na próxima aula, deixamos a adaptação pontual e criamos um procedimento nosso, com entrada, regras, saída e exemplos de teste. Vamos usar o que já existe como apoio, sem tratar uma solução genérica como se conhecesse todo o seu trabalho.

# 2.2 — Explorando skills prontas

ID m02-a02. 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 skills pdf/docx inspecionadas, dependências e aplicativos para abrir os formatos; não instalar a coleção inteira.

**Dependências e ensaio:** Ensaiar geração e abertura de ambos os formatos no ambiente da aula.

| Bloco | Slide/PDF | Ação | Conferência |
|---|---|---|---|
| m02-a02-b01 | m02-a02-s01 / p. 1 | Abrir apoio/conversa-demo.txt e usar a mesma entrada em todas as comparações. | Entrada de referência e critérios são visíveis antes de executar. |
| m02-a02-b04 | m02-a02-s04 / p. 2 | Testar skills pdf e docx com a mesma conversa fictícia, abrindo os arquivos reais. | Dois arquivos reais comparados com a mesma fonte; capacidades do formato e conteúdo distinguidas. |
| m02-a02-b02 | m02-a02-s02 / p. 3 | Executar a skill escolhida. Comparar com apoio/criterios-resumo.md; adaptar somente um critério e repetir com a mesma entrada. | Um único critério é alterado e a segunda saída é comparada com a primeira. |
| m02-a02-b05 | m02-a02-s05 / p. 4 | Modificar uma regra numa cópia da skill de resumo e repetir dois testes. | Mudança isolada melhora critério observado sem inventar informação no segundo caso. |
| m02-a02-b06 | m02-a02-s06 / p. 5 | Registrar decisão de uso para cada skill e vincular ao teste executado. | Decisão sobre skill pronta sustentada por teste e requisito concreto. |
| m02-a02-b03 | m02-a02-s03 / p. 6 | Registrar um ajuste necessário para o processo do aluno, sem exigir edição de código. | Arquivos reais abertos, fatos conferidos, cópia original preservada e adaptação executada com evidência antes/depois. |

## m02-a02-b01 — Testar com uma entrada conhecida

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Abrir apoio/conversa-demo.txt e usar a mesma entrada em todas as comparações. | slides/m02-a02.pptx e slides/m02-a02.pdf, página 1, ID m02-a02-s01; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m02-a02-b01 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m02-a02-b01. Sem trilha prevista. |

**Estado inicial:** Preparar skills pdf/docx inspecionadas, dependências e aplicativos para abrir os formatos; não instalar a coleção inteira.

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

**Passos de captura:**
1. Abrir apoio/conversa-demo.txt e usar a mesma entrada em todas as comparações.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Entrada de referência e critérios são visíveis antes de executar.

**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-a02-b01; SHA-256 08ae4239ffcbeb96f02d80b3fc4a689a342d65e0213a4584d236c16d0d6a5160.

**Função visual:** Abrir apoio/conversa-demo.txt e usar a mesma entrada em todas as comparações.


## m02-a02-b04 — Duas skills prontas, duas entregas verificáveis

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Testar skills pdf e docx com a mesma conversa fictícia, abrindo os arquivos reais. | slides/m02-a02.pptx e slides/m02-a02.pdf, página 2, ID m02-a02-s04; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m02-a02-b04 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m02-a02-b04. Sem trilha prevista. |

**Estado inicial:** Preparar skills pdf/docx inspecionadas, dependências e aplicativos para abrir os formatos; não instalar a coleção inteira.

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

**Passos de captura:**
1. Inspecionar duas skills em anthropics/skills e suas dependências.
2. Pedir DOCX e PDF do mesmo resumo, em saída de exercício.
3. Abrir cada formato e conferir conteúdo e edição/legibilidade.

**Saída e conferência:** Dois arquivos reais comparados com a mesma fonte; capacidades do formato e conteúdo distinguidas.

**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-a02-b04; SHA-256 f1c68ba6e4d778f8dac6b694b7d4d2cc59b121b77c3f6a15f0e919e4edd825dc.

**Função visual:** Testar skills pdf e docx com a mesma conversa fictícia, abrindo os arquivos reais.


## m02-a02-b02 — Um ajuste que tem motivo

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Executar a skill escolhida. Comparar com apoio/criterios-resumo.md; adaptar somente um critério e repetir com a mesma entrada. | slides/m02-a02.pptx e slides/m02-a02.pdf, página 3, ID m02-a02-s02; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m02-a02-b02 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m02-a02-b02. Sem trilha prevista. |

**Estado inicial:** Preparar skills pdf/docx inspecionadas, dependências e aplicativos para abrir os formatos; não instalar a coleção inteira.

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

**Passos de captura:**
1. Executar a skill escolhida. Comparar com apoio/criterios-resumo.md; adaptar somente um critério e repetir com a mesma entrada.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Um único critério é alterado e a segunda saída é comparada com a primeira.

**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-a02-b02; SHA-256 97e502ff5e82c5bf590325ba6b9caf692c96e477d5825c045bc85c5d4764444d.

**Função visual:** Executar a skill escolhida. Comparar com apoio/criterios-resumo.md; adaptar somente um critério e repetir com a mesma entrada.


## m02-a02-b05 — Comparar sem trocar todas as variáveis

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Modificar uma regra numa cópia da skill de resumo e repetir dois testes. | slides/m02-a02.pptx e slides/m02-a02.pdf, página 4, ID m02-a02-s05; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m02-a02-b05 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m02-a02-b05. Sem trilha prevista. |

**Estado inicial:** Preparar skills pdf/docx inspecionadas, dependências e aplicativos para abrir os formatos; não instalar a coleção inteira.

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

**Passos de captura:**
1. Preservar original e criar cópia local.
2. Alterar somente a regra de responsável.
3. Executar conversa completa e incompleta.
4. Comparar resultados no registro de testes.

**Saída e conferência:** Mudança isolada melhora critério observado sem inventar informação no segundo caso.

**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-a02-b05; SHA-256 c0d386c74392fe9afe06bf980e3365e88eba33ff8c458934867578a4a58d8bc2.

**Função visual:** Modificar uma regra numa cópia da skill de resumo e repetir dois testes.


## m02-a02-b06 — Decidir o que aproveitar e o que criar

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Demo. Registrar decisão de uso para cada skill e vincular ao teste executado. | slides/m02-a02.pptx e slides/m02-a02.pdf, página 5, ID m02-a02-s06; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m02-a02-b06 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m02-a02-b06. Sem trilha prevista. |

**Estado inicial:** Preparar skills pdf/docx inspecionadas, dependências e aplicativos para abrir os formatos; não instalar a coleção inteira.

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

**Passos de captura:**
1. Preencher manter/adaptar/substituir com motivo.
2. Vincular cada decisão a uma saída observada.
3. Listar acesso externo separado do procedimento.

**Saída e conferência:** Decisão sobre skill pronta sustentada por teste e requisito concreto.

**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-a02-b06; SHA-256 543f22920c3254ce8514c4eb10f5a1521549f9df033115a144e12db76c01743b.

**Função visual:** Registrar decisão de uso para cada skill e vincular ao teste executado.


## m02-a02-b03 — O limite da skill genérica

| TC imagem | VIDEO | GFX | TC fala | SOUND BITES | SOUND |
|---|---|---|---|---|---|
| Não fornecido: material novo; localizar slide pelo ID. | Câmera. Registrar um ajuste necessário para o processo do aluno, sem exigir edição de código. | slides/m02-a02.pptx e slides/m02-a02.pdf, página 6, ID m02-a02-s03; composição Opus verificada. Aplicativo real: captura nova a produzir quando indicada. | Não fornecido: fala original ainda não gravada; localizador m02-a02-b03 | —. Sem depoimento ou fala externa neste bloco. | Locução do professor conforme roteiro-fala.md, bloco m02-a02-b03. Sem trilha prevista. |

**Estado inicial:** Preparar skills pdf/docx inspecionadas, dependências e aplicativos para abrir os formatos; não instalar a coleção inteira.

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

**Passos de captura:**
1. Registrar um ajuste necessário para o processo do aluno, sem exigir edição de código.
2. Abrir o resultado e comparar com o critério da aula.

**Saída e conferência:** Arquivos reais abertos, fatos conferidos, cópia original preservada e adaptação executada com evidência antes/depois.

**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-a02-b03; SHA-256 99afbc73a63498a13f025021fc7d35bc42f5d0366e653ebac67ce7eb30697c1a.

**Função visual:** Registrar um ajuste necessário para o processo do aluno, sem exigir edição de código.


## Atividade e solução

Produzir DOCX/PDF com a mesma entrada e executar uma alteração de regra na skill de resumo, com dois testes.

Arquivos reais abertos, fatos conferidos, cópia original preservada e adaptação executada com evidência antes/depois.

## Materiais

- conversa-demo.txt
- conversa-incompleta.txt
- ficha-inspecao-skill.md
- registro-testes.md