Leve o curso com você
Consulte as quatro aulas e o capítulo de Engenharia de Prompt Avançada em PDF ou baixe o site completo, com imagens, exemplos e skills.
Aprenda a localizar, avaliar, criar e disponibilizar skills e a organizar agentes e squads no Claude. Cada procedimento conserva a sequência de capturas da demonstração e acrescenta preparação, explicações e conferências para você reproduzir a atividade.
Nos tópicos 04.4, 04.5 e 04.10, baixe os três pacotes de skills usados na aula. As capturas registram a interface da demonstração; os complementos distinguem o que foi registrado das instruções completas sugeridas para uso.
04.1. Procurando e instalando skills do Claude
Você localizará o plugin Legal no catálogo do Claude, examinará seus componentes e acompanhará a confirmação de instalação. O resultado importante não é apenas encontrar a palavra legal, mas reconhecer a origem do pacote, o que ele acrescenta e quais integrações podem transmitir dados a outros serviços.
O que você vai compreender
Uma skill reúne instruções especializadas e, quando necessário, arquivos ou scripts de apoio. Um plugin pode agrupar várias skills, agentes e conectores. Portanto, instalar o plugin Legal não equivale a contratar uma base de jurisprudência brasileira ou autorizar todos os conectores. Na gravação, a ficha identifica a Anthropic como fornecedora e apresenta nove skills e sete conectores naquela versão.
Preparação
Abra o Claude com a conta usada no curso. Confira a organização selecionada e use uma conversa de teste, sem documentos de clientes. Para utilizar skills no Chat, a execução de código e a criação de arquivos devem estar habilitadas; em uma organização, a política administrativa também participa dessa disponibilidade.
Procedimento acompanhado
Passo 1. Abra o menu da conta
Clique no nome da conta, no canto inferior esquerdo. Esse menu reúne configurações pessoais e atalhos administrativos. Verifique a identidade e a organização antes de alterar qualquer recurso; uma instalação pessoal e uma distribuição institucional têm alcances diferentes.
Passo 2. Entre em Configurações
Selecione Configurações no menu aberto. A captura seguinte mostra a área geral da conta. Não é necessário iniciar uma conversa nem criar um projeto para chegar ao catálogo de skills.
Passo 3. Abra Skills
Na navegação das configurações, escolha Skills. Observe a separação entre recursos criados por você, fornecidos pela organização e disponibilizados pela Anthropic ou por parceiros. Essa origem ajuda a decidir quem mantém o procedimento e onde solicitar uma atualização.
Passo 4. Selecione Descobrir
Abra a aba Descobrir para consultar o catálogo. Meus apresenta o que está associado à conta; Descobrir permite procurar novos componentes. O procedimento gravado passa de uma lista de skills já existentes para a descoberta do plugin jurídico.
Passo 5. Ative o campo de pesquisa
Clique em Procurar e digite Legal. A busca pode retornar plugins, skills e conectores na mesma interface. Leia o tipo de cada resultado para não adicionar uma integração diferente daquela que pretende estudar.
Passo 6. Localize o plugin Legal
Identifique o resultado Legal atribuído à Anthropic. A captura apresenta também outros componentes já disponíveis. Se o plugin já estiver na conta, abra sua ficha para conferir o estado em vez de repetir a instalação ou remover a versão existente.
Passo 7. Examine a ficha do plugin
Abra os detalhes de Legal. Percorra Visão geral, Conteúdo, Skills e Conectores. A ficha registrada informa que conectores podem enviar dados a outros serviços. Confira a necessidade de cada integração; o pacote de instruções não exige autorizar indiscriminadamente Gmail, calendário ou repositórios de documentos.
Passo 8. Use Adicionar
Após conferir fornecedor e componentes, clique em Adicionar. O botão inicia o fluxo de instalação do plugin. A captura preserva a ficha que serve de base para essa decisão; o clique não é evidência de que todos os componentes já estejam funcionando.
Passo 9. Leia a confirmação e continue
A janela informa que plugins podem incluir componentes executáveis e menciona o Cowork. Leia a confirmação e use Continuar apenas para o pacote que decidiu instalar. O registro também mostra uma notificação de remoção; por isso, confira o estado final em Meus, sem inferir sucesso apenas dessa tela.
Prompt completo sugerido para esta atividade
Use a skill de avaliação de riscos jurídicos do plugin Legal, se estiver disponível nesta conversa. Analise apenas este exemplo fictício: um contrato de prestação de serviços prevê rescisão com aviso de 30 dias e contém exclusão ampla de responsabilidade por indisponibilidade. Separe texto informado, riscos condicionados e documentos faltantes. Não invente cláusulas, precedentes nem prazos. Entregue uma tabela tema | evidência recebida | risco | pergunta ao responsável e indique qual skill foi efetivamente utilizada. Não envie dados a conectores nem produza uma conclusão jurídica definitiva.
Conferência do resultado e continuidade
Volte à lista de componentes instalados, localize Legal e confirme seu estado. Abra uma nova conversa e envie o prompt de teste. Leia a resposta e verifique se ela reconhece que recebeu somente uma descrição, não o contrato integral. A instalação está conferida quando o pacote aparece na conta; a aplicação da skill é uma segunda verificação, feita na tarefa e nas evidências de uso exibidas pelo produto.
Fontes e aprofundamento
04.2. Buscando e instalando skills do skills.sh
Você pesquisará uma skill no diretório skills.sh, abrirá suas instruções e levará ao Claude o prompt de utilização oferecido pela página. O exemplo é legal-risk-assessment, associado ao repositório anthropics/knowledge-work-plugins.
O que você vai compreender
O diretório ajuda a descobrir procedimentos reutilizáveis, mas a página de uma skill, o prompt para carregá-la e sua instalação persistente são coisas distintas. O modo Prompt mostrado na gravação solicita a execução de npx skills use e a leitura das instruções retornadas. Isso não comprova que a skill ficou instalada para todas as conversas futuras. Já o modo Command apresenta uma opção de instalação pelo utilitário; o ambiente que executará o comando precisa possuir as ferramentas e permissões correspondentes.
Preparação
Mantenha uma guia com o Claude e abra outra para https://skills.sh. Antes de autorizar execução, examine o fornecedor, o repositório, o conteúdo de SKILL.md e os recursos associados. Um comando npx pode obter e executar software; ele não deve ser tratado como uma simples frase de pesquisa. Se estiver em Chat sem essa ferramenta, peça leitura e análise das instruções, sem alegar uma instalação que não ocorreu.
Procedimento acompanhado
Passo 1. Abra uma nova guia
Na janela em que o Claude já está aberto, use Nova guia. Manter o diretório separado da conversa permite conferir a origem do material antes de copiar qualquer instrução. A primeira captura registra o ponto de partida, não uma instalação concluída.
Passo 2. Acesse The Agent Skills Directory
Abra skills.sh, identificado na gravação como The Agent Skills Directory. A página inicial mostra o diretório e seus rankings. Rankings e números de instalações ajudam a localizar um item, mas não substituem a leitura do procedimento que será usado.
Passo 3. Pesquise a skill
Clique em Search skills e procure legal. A seleção pretendida é legal-risk-assessment. Diferencie resultados de nome parecido, como redação, resposta jurídica ou pesquisa; cada um propõe um objetivo e um conjunto de instruções diferentes.
Passo 4. Abra legal-risk-assessment
Selecione o resultado associado a anthropics/knowledge-work-plugins. Confira o identificador completo e o repositório. A avaliação de riscos organiza severidade e probabilidade; ela não transforma um exemplo contratual incompleto em parecer sobre fatos comprovados.
Passo 5. Leia a página e selecione Prompt
Na página da skill, leia SKILL.md e abra a opção Prompt. A captura também apresenta a alternativa Command. Não misture o comando de instalação exibido nessa alternativa com o texto de carregamento que o modo Prompt oferece ao assistente.
Passo 6. Copie o prompt gerado
Use o controle de cópia do bloco Prompt. O texto solicita npx skills use para o repositório e a skill indicados, leitura da saída completa e resolução dos caminhos de arquivos de apoio. Preserve aspas e o identificador da skill ao copiar.
Passo 7. Retorne à guia do Claude
Selecione a guia Nova sessão do Claude. A captura ainda mostra o diretório porque registra a transição de foco. Antes de colar, confira a barra de endereço e o campo de mensagem da conversa de destino.
Passo 8. Confira a conversa nova
Com o Claude em primeiro plano, use uma conversa de teste. O campo está vazio no registro. Não cole o comando em uma página externa nem em uma conversa que contenha informações de outro cliente ou projeto.
Passo 9. Cole o texto no campo de mensagem
Cole o prompt copiado no compositor do Claude. Revise repositório, nome da skill e escopo da execução antes do envio. Se desejar primeiro apenas uma inspeção, substitua a autorização de execução por um pedido explícito de análise, como no complemento abaixo.
Passo 10. Envie e acompanhe o retorno
Clique em Enviar mensagem. O registro termina com o prompt no compositor, sem evidência da execução subsequente. Aguarde a resposta, confira se houve ferramenta real e leia eventuais pedidos de permissão. O uso nesta conversa e a instalação persistente devem ser comprovados separadamente.
Registro literal da demonstração
Registro do prompt de utilização exibido no modo Prompt. Ele solicita execução; o tutorial não o executa automaticamente. A gravação mostra o envio, não a confirmação de instalação persistente.
Texto registrado
Run `npx skills use "https://github.com/anthropics/knowledge-work-plugins" --skill "legal-risk-assessment"` and follow the generated skill instructions now. Read its complete output, redirecting it to a temporary file first if necessary. Resolve relative paths from the supporting-files directory it provides.
Prompt completo sugerido para esta atividade
Examine a skill legal-risk-assessment do repositório https://github.com/anthropics/knowledge-work-plugins. Primeiro leia SKILL.md e identifique arquivos de apoio, dependências, comandos, permissões e possíveis transmissões de dados. Não execute npx, não instale pacotes e não altere arquivos nesta primeira etapa. Explique a diferença entre usar as instruções nesta sessão e instalar a skill de modo persistente no ambiente disponível. Depois apresente o procedimento exato para o meu ambiente e aguarde minha autorização antes de executar comandos.
Conferência do resultado e continuidade
Envie primeiro o pedido de inspeção. Leia a análise, confira a página de origem e só então decida se autoriza a instalação ou o carregamento temporário. Após eventual execução autorizada, peça os caminhos realmente criados, a saída do utilitário e um teste com dados fictícios. Uma resposta que apenas interpreta o prompt não demonstra que npx foi executado.
Fontes e aprofundamento
04.3. Procurando e instalando skills externas
Você localizará um repositório externo de skills jurídicas brasileiras, copiará sua URL e pedirá ao Claude uma análise de segurança e utilidade antes de decidir pela instalação. A gravação usa autodevx/legal-skills e termina no envio desse pedido de análise.
O que você vai compreender
Encontrar um repositório no GitHub não significa que seu conteúdo foi aprovado para o escritório. README descreve a proposta; SKILL.md contém as instruções de cada procedimento; scripts e configurações podem introduzir efeitos adicionais. A análise deve distinguir o que é apenas orientação textual, o que executa código e o que exige acesso a dados ou serviços.
Preparação
Abra uma conversa nova e uma guia para pesquisa. Use o endereço público do repositório, sem credenciais. Nesta etapa, não há necessidade de fornecer contratos, números de processos ou dados pessoais. A pesquisa registrada é github skills legislação; o resultado selecionado é explicitamente o repositório autodevx/legal-skills.
Procedimento acompanhado
Passo 1. Abra uma conversa nova
Selecione Nova sessão no Claude. Uma conversa separada facilita limitar a análise ao pacote externo e evita que dados de outro trabalho entrem no contexto sem necessidade. Ainda não anexe documentos jurídicos reais.
Passo 2. Abra uma guia para pesquisa
Use Nova guia no navegador. Pesquise github skills legislação ou acesse diretamente o repositório indicado no próximo passo. A pesquisa é um meio de localização, não uma verificação de autenticidade ou qualidade jurídica.
Passo 3. Localize o resultado do GitHub
Identifique autodevx/legal-skills nos resultados. A descrição menciona parser CNJ, revisão de contratos, contingência e classificação de audiências. Esses itens são propostas do projeto e devem ser confrontados com os arquivos disponíveis, não repetidos como capacidades já testadas.
Passo 4. Abra o resultado em outra guia
A captura mostra o menu de contexto Abrir link em uma nova guia. Use essa opção para manter os resultados da busca disponíveis. Confira se o domínio é github.com e se proprietário e repositório correspondem ao resultado escolhido.
Passo 5. Confirme o repositório escolhido
Clique no resultado autodevx/legal-skills. O título identifica o foco em jurídico brasileiro. A decisão importante é selecionar o projeto correto, evitando confundir a página geral de tópicos legal-skills com um pacote específico.
Passo 6. Examine a página do repositório
Na página do projeto, localize README, licença, pasta skills e demais recursos. Observe que um repositório pode reunir diversas skills. A instalação deve indicar qual delas interessa, em vez de incorporar todo o conjunto sem leitura.
Passo 7. Copie a URL da barra de endereços
Selecione https://github.com/autodevx/legal-skills e copie o endereço completo. Evite URLs de pesquisa, páginas intermediárias ou links com parâmetros de autenticação. O endereço público basta para a inspeção inicial.
Passo 8. Volte ao Claude
Alterne para a guia da conversa nova. O registro preserva a página do GitHub durante essa troca. Confirme o destino antes de colar o endereço, especialmente quando houver várias guias com títulos semelhantes.
Passo 9. Cole o endereço
Clique no campo de mensagem do Claude e pressione Ctrl+V. Acrescente uma instrução clara de análise antes de instalar. Uma URL isolada não define se você quer resumo, auditoria, download ou execução.
Passo 10. Envie o pedido de avaliação
A mensagem visível solicita verificar segurança e utilidade da skill para o repositório. Envie-a e aguarde a leitura dos arquivos. O procedimento registrado não mostra a instalação posterior; essa decisão depende da inspeção e da escolha do ambiente de destino.
Registro literal da demonstração
Texto visível na última captura. O pedido avalia o material; não autoriza, por si só, instalar ou executar recursos.
Texto registrado
https://github.com/autodevx/legal-skills Verifique a segurança e analise a utilidade desta skill para este repositório
Prompt completo sugerido para esta atividade
Analise https://github.com/autodevx/legal-skills para uso didático por participantes de um escritório de advocacia brasileiro. Leia README, licença, os SKILL.md relevantes e os scripts ou configurações referenciados. Liste finalidade, entradas, saídas, dependências, acesso à rede, gravação de arquivos e riscos de instruções externas. Diferencie capacidades descritas de capacidades verificadas. Não execute código, não instale nada e não acesse dados de clientes. Recomende somente os componentes úteis ao objetivo de revisão contratual, explique as lacunas e apresente um plano de teste com documentos fictícios. Aguarde minha aprovação para qualquer instalação.
Conferência do resultado e continuidade
Leia a resposta verificando se ela aponta arquivos e trechos concretos. Uma avaliação útil informa o que leu e o que ainda depende de teste, incluindo referências ausentes e comandos executáveis. Se decidir instalar, escolha o escopo pessoal ou do projeto, registre a versão de origem e teste uma entrada fictícia antes de disponibilizar o procedimento a outras pessoas.
Fontes e aprofundamento
04.4. Criando uma skill de busca legislativa local
Você partirá do acervo ctresb/leis para solicitar uma skill que consulte legislação em uma cópia local, examinará o pacote busca-legislativa e acompanhará seu download e salvamento. O objetivo é transformar uma fonte de pesquisa em um procedimento reutilizável com referências rastreáveis.
O que você vai compreender
O acervo é uma conversão de textos normativos para Markdown, com metadados e referências de origem. A pesquisa local facilita filtrar e ler dispositivos, mas a cópia precisa de atualização e conferência da fonte oficial para uso jurídico. O número 323.849 e a cobertura de 25 estados mais o Distrito Federal pertencem à versão descrita na captura e no pacote, não a um inventário atualizado automaticamente nesta página.
Preparação
Abra a URL pública https://github.com/ctresb/leis e uma conversa nova no Claude. Para um teste local posterior, o pacote utiliza Python 3, Git e ripgrep, com acervo definido por LEIS_DIR ou, por padrão, ~/leis-br. O clone exige rede e espaço em disco; prefira um escopo parcial compatível com a pesquisa, em vez de baixar toda a coleção sem necessidade.
Procedimento acompanhado
Passo 1. Inicie uma conversa nova
Abra Nova sessão no Claude. O trabalho agora é construir um procedimento de consulta, não executar uma pesquisa jurídica sobre um cliente. Mantenha a conversa limitada à fonte e ao desenho da skill.
Passo 2. Abra ctresb/leis
Selecione a guia ou o resultado ctresb/leis: Todas as leis do Brasil. Confira proprietário e nome do repositório. A URL desse acervo será a referência do pedido de criação da skill.
Passo 3. Leia a apresentação do acervo
Localize Legislação brasileira em Markdown no README. Leia organização das pastas, cobertura e origem dos textos. A captura registra a quantidade de normas daquela versão; para uma pergunta concreta, a existência da jurisdição e do tipo normativo é mais importante que o tamanho total anunciado.
Passo 4. Selecione o endereço
Clique na barra de endereços e selecione https://github.com/ctresb/leis. Copiar o repositório permite que o assistente examine estrutura e documentação, em vez de trabalhar somente com uma descrição resumida.
Passo 5. Copie a URL completa
Copie o endereço selecionado. Esta captura registra a seleção do mesmo endereço e é mantida na sequência original. Não substitua a URL do acervo por um resultado de busca ou por um arquivo isolado sem indicar essa mudança.
Passo 6. Retorne ao Claude
Selecione a guia Nova sessão. Confira que está na conversa destinada à criação da skill. O vínculo entre repositório, procedimento e pacote deve permanecer explícito para a revisão posterior.
Passo 7. Cole a URL no compositor
Cole o endereço no campo de mensagem. Acrescente a tarefa de clonar e usar o acervo para consultas locais, delimitando primeiro a criação do pacote. A leitura do repositório e o clone no computador são operações distintas.
Passo 8. Envie o pedido de criação
A mensagem gravada pede uma skill que clone e utilize o repositório para buscas legislativas locais. Envie o pedido e aguarde a geração do pacote. O complemento abaixo acrescenta cobertura, atualização, limites de uso e uma saída com referências, sem alterar a transcrição do registro.
Passo 9. Baixe busca-legislativa
Quando o pacote estiver pronto, use Baixar busca-legislativa. Salve o arquivo em uma pasta conhecida e examine SKILL.md e scripts/leis.py antes de autorizar uso. Baixar um pacote não executa seu script nem realiza o clone do acervo.
Passo 10. Salve a skill e confira a lista
A gravação encerra em Salvar Skill, no fluxo de cadastro. Confira o nome, a descrição e o estado na sua lista de skills. Para usar em Code, confirme o caminho e o escopo de instalação; não presuma que o simples download já disponibilizou o procedimento em todas as ferramentas.
Registro literal da demonstração
Pedido visível na captura de envio. As especificações adicionais do próximo bloco são um complemento didático para tornar a criação e o teste verificáveis.
Texto registrado
https://github.com/ctresb/leis Crie uma skill que clone e utilize este repositório para realizar buscas legislativas locais
Prompt completo sugerido para esta atividade
Crie uma skill chamada busca-legislativa a partir de https://github.com/ctresb/leis. Primeiro leia a documentação e descreva cobertura, estrutura, metadados e lacunas. Prepare SKILL.md e um script de consulta local com comandos para verificar o acervo, preparar uma cópia parcial, buscar por termos, localizar norma por número e ler artigos. Use Python 3, Git e ripgrep; permita configurar LEIS_DIR. Não faça o clone nem instale dependências nesta etapa. Cada resposta de pesquisa deve indicar norma, artigo, trecho, caminho local, situação, versão do texto e link da fonte oficial. Diferencie ausência de resultado de inexistência de norma. Entregue o pacote para download e um plano de teste com a Constituição Federal, art. 37, e a Lei 12.815/2013, sem inventar resultado de execução.
Pacote fornecido para download
O pacote fornecido contém busca-legislativa/SKILL.md e busca-legislativa/scripts/leis.py. O script oferece setup, buscar, lei, ler, cf e info. Vários termos na busca têm combinação lógica E; --ementa restringe a ementa, --uf delimita a esfera e --vigentes filtra a situação registrada no acervo. Esse filtro não substitui conferir alterações e vigência na fonte primária. A versão distribuída informa ausência de PR e RJ e não inclui normas municipais, portarias, instruções normativas, resoluções ou decretos regulamentares. Esses limites devem orientar a escolha da fonte, não ser ocultados pela resposta.
Baixar busca-legislativa.skill
Antes de instalar, abra o pacote e confira SKILL.md e os arquivos de apoio.
Continuação prática sugerida
Use busca-legislativa no ambiente local autorizado. Primeiro execute apenas a verificação info e mostre o caminho e o escopo existentes. Se não houver acervo, apresente a proposta de clone parcial federal e aguarde minha autorização. Depois de preparado, consulte o art. 37 da Constituição e localize a Lei 12.815/2013. Informe comandos e arquivos realmente lidos, transcreva somente o trecho necessário e apresente o link oficial do cabeçalho. Confira a versão do texto e registre qualquer divergência ou lacuna. Não afirme inexistência de norma por uma busca sem resultados.
Conferência do resultado e continuidade
Abra o pacote baixado como arquivo compactado para inspeção. No uso autorizado, comece por info e só depois prepare o acervo necessário. Compare um dispositivo conhecido com a fonte oficial indicada nos metadados e guarde data de atualização e versão consultada. O resultado satisfatório mostra a consulta real e o trecho encontrado, sem confundir cópia local, redação original e texto consolidado.
Fontes e aprofundamento
04.5. Criando uma skill de interação com a API da Jusbrasil
Você reunirá a página do produto e a documentação técnica da API Jusbrasil Soluções, solicitará uma skill de integração e abrirá o pacote já produzido. A sequência também registra interrupção de resposta, organização da barra lateral e exclusão de uma conversa de teste. Essas ações de navegação não são requisitos para criar ou instalar a skill.
O que você vai compreender
Uma API oferece operações estruturadas sobre um serviço; uma skill orienta como escolher e realizar essas operações. O arquivo de instruções não concede contrato, crédito, módulo ou credencial. O pacote diferencia a plataforma op, de origem Digesto, e os produtos Consulta PRO, com bases e cabeçalhos de autenticação distintos. Na aula, a preparação pode ser feita sem consultar pessoas ou processos reais e sem expor chaves.
Preparação
Abra https://conteudo.jusbrasil.com.br/api e siga Acessar documentação. A documentação técnica consultada é https://api.jusbrasil.com.br/docs/index.html. Mantenha as duas URLs separadas: a primeira apresenta o produto; a segunda descreve recursos e autenticação. Para testar operações reais depois, confirme produto contratado, finalidade autorizada, ambiente e forma segura de fornecer credenciais.
Procedimento acompanhado
Passo 1. Abra uma nova conversa
Selecione Nova sessão no Claude para preparar a skill da API. Não reutilize uma conversa com dados de um caso concreto. O primeiro objetivo é reunir fontes técnicas e desenhar a integração.
Passo 2. Selecione a página de APIs
Abra a guia de Jusbrasil Soluções. O rótulo Uso da memória em APIs, presente no texto automático do documento, pertence à interface do navegador; a ação relevante é alternar para a página do produto, não configurar memória da API.
Passo 3. Selecione a URL do produto
Clique na barra de endereços da página de APIs. Confirme o domínio oficial e a página /api. Esse endereço fornece contexto comercial e aponta a documentação, mas não deve ser usado como URL base de todas as chamadas.
Passo 4. Copie a URL
Copie o endereço selecionado. A captura conserva esse instante da navegação. A URL pública pode ser compartilhada com o assistente sem incluir token, cabeçalho de autenticação ou parâmetros privados.
Passo 5. Retorne à conversa do Claude
Selecione a guia Nova sessão. O documento registra duas formas de nomear a mesma troca de guia, inclusive uma indicação de memória do navegador. Ambas correspondem ao retorno ao compositor do Claude.
Passo 6. Inicie o pedido de criação
Escreva Crie uma skill de interação com a API da JusBrasil e cole a URL do produto. Ainda não envie credenciais. A mensagem precisa receber a documentação técnica para que o pacote não seja construído apenas a partir da página de apresentação.
Passo 7. Volte à página da Jusbrasil
Alterne novamente para a guia do produto. O objetivo agora é obter a documentação oficial. A troca entre guias mantém a mensagem em preparação no Claude.
Passo 8. Abra Acessar documentação
Use o link Acessar documentação. Confira o título Documentação de integração via API e o domínio api.jusbrasil.com.br. A página apresenta autenticação, recursos, monitoramentos e demais produtos; cada operação deve remeter à seção correspondente.
Passo 9. Selecione a barra de endereços
Na guia da documentação, clique na barra de endereço e pesquisa. Não copie a URL de uma busca ou de uma guia diferente. A referência desejada é a documentação técnica, que será adicionada ao pedido já iniciado.
Passo 10. Confira a guia de documentação
A captura identifica Documentação de integração via API no Google Chrome. Mantenha o foco nessa página e confira o endereço antes de copiar. O título de janela é apenas um sinal de navegação, não uma chamada de API.
Passo 11. Copie a URL técnica
Copie https://api.jusbrasil.com.br/docs/index.html. Esse endereço deve acompanhar o pedido para orientar consultas ao esquema e aos requisitos de cada endpoint. Não copie conteúdo de uma área autenticada com segredos de acesso.
Passo 12. Volte ao Claude
Retorne à conversa em que o pedido está sendo composto. A indicação Uso da memória em Nova sessão é um rótulo automático do navegador. A atividade é simplesmente alternar para o campo de mensagem correto.
Passo 13. Acrescente a referência de documentação
Após a URL do produto, escreva Documentação em e cole o endereço técnico. A imagem preserva a mensagem antes de o endereço aparecer nessa linha; por isso, o bloco literal abaixo mantém esse estado incompleto, e o complemento apresenta uma instrução pronta para envio.
Passo 14. Reconheça o controle Interromper resposta
A gravação aciona Interromper resposta. Esse controle cancela a geração em andamento; ele não instala a skill nem valida um pacote. Na sua execução, aguarde o término da criação ou interrompa apenas quando houver motivo concreto para revisar o pedido.
Passo 15. Abra as opções da conversa de teste
O menu Mais opções para JusBrasil API skill serve à gestão da conversa. A existência desse título não demonstra que uma integração já foi instalada. Guarde arquivos necessários antes de qualquer ação de organização ou exclusão.
Passo 16. Observe a navegação pela barra lateral
A captura registra o controle Barra lateral. Ele altera a apresentação e ajuda a localizar conversas. Não é parte da autenticação da Jusbrasil nem um passo obrigatório da instalação.
Passo 17. Identifique a conversa selecionada
O registro volta à conversa JusBrasil API skill. Confira o título para distinguir o teste recém-aberto da conversa anterior que contém o pacote concluído. Apagar a conversa errada pode eliminar o histórico necessário à conferência.
Passo 18. Entenda a exclusão mostrada
A gravação confirma Apagar para uma conversa de teste. Trata-se de uma ação acessória e permanente sobre o histórico, não sobre o contrato da API. Para reproduzir a parte pedagógica, mantenha a conversa ou arquive-a; excluir não é necessário para continuar.
Passo 19. Abra Arquivo na navegação
Use Arquivo para localizar as conversas anteriores registradas. O nome do controle se refere à listagem da interface. Não significa que você está extraindo o pacote de instalação nem recuperando uma conversa apagada.
Passo 20. Selecione Skill para API Jusbrasil
Abra a conversa anterior chamada Skill para API Jusbrasil, que contém o material salvo. Esta é outra conversa, não a restauração da que acabou de ser excluída. Confira o conteúdo antes de baixar arquivos.
Passo 21. Abra o item Jusbrasil api
Selecione o artefato Jusbrasil api na conversa. Leia finalidade, estrutura e regras de credenciais. Uma skill de integração pode conter exemplos de chamadas, mas o texto de exemplo não comprova uma resposta real do serviço.
Passo 22. Confira Mensagem 2 de 2
A interface permite navegar entre mensagens ou versões; a captura seleciona Mensagem 2 de 2. Confira que a versão aberta corresponde ao pacote pretendido e não a um rascunho anterior com instruções incompletas.
Passo 23. Visualize e baixe o pacote
Use Ver Jusbrasil api para abrir o conteúdo. A tela apresenta orientações sobre credenciais diferentes, módulos contratados e divergências documentais, além do download. Leia essas dependências e salve jusbrasil-api.skill; não forneça chaves no texto da conversa.
Registro literal da demonstração
Registro incompleto visível na captura 13: a linha Documentação em ainda não apresenta a URL. O próximo prompt completa a atividade, sem atribuir essa conclusão à imagem.
Texto registrado
Crie uma skill de interação com a API da JusBrasil: https://conteudo.jusbrasil.com.br/api Documentação em:
Prompt completo sugerido para esta atividade
Crie uma skill chamada jusbrasil-api para orientar integração com a API Jusbrasil Soluções. Página do produto: https://conteudo.jusbrasil.com.br/api. Documentação oficial: https://api.jusbrasil.com.br/docs/index.html. Leia as seções relevantes antes de definir endpoints, campos e autenticação. Separe a plataforma op das famílias Consulta PRO, indique bases, credenciais e módulos necessários e explique paginação, limites, erros e webhooks. Credenciais devem vir de variáveis de ambiente e nunca aparecer em respostas ou logs. Diferencie consultas de leitura, operações que criam recursos e operações que consomem créditos. Exija aprovação explícita de custo e escopo antes de encomendas ou monitoramentos. Entregue SKILL.md em um pacote para download e exemplos identificados como exemplos. Não realize chamadas, não cadastre monitoramentos, não consulte pessoas reais e não altere configurações de contas.
Pacote fornecido para download
O pacote contém jusbrasil-api/SKILL.md. Ele reúne instruções, tabela de operações, exemplos Python e um esboço de receptor de webhook dentro do próprio Markdown; não contém um cliente instalado nem um servidor pronto. Os exemplos referem requests e Flask, e o receptor usa enqueue como ponto de integração a implementar. As variáveis JUSBRASIL_OP_TOKEN, JUSBRASIL_CPRO_API_KEY e WEBHOOK_SECRET são nomes de configuração, não chaves fornecidas. Preserve os valores fora do histórico, do código versionado e dos downloads. No uso, confira autenticação, permissão, produto e módulo ao investigar 401/403, sem alterar cabeçalhos ou ampliar acesso por tentativa indiscriminada. O campo api_name identifica eventos, mas não substitui autenticação criptográfica do remetente. Dados processuais e identificadores pessoais exigem finalidade, minimização e controle de acesso; nem todo dado pessoal é automaticamente dado sensível na classificação legal.
Antes de instalar, abra o pacote e confira SKILL.md e os arquivos de apoio.
Continuação prática sugerida
Leia a skill jusbrasil-api disponível e prepare somente um plano de consulta, sem acessar a API. Objetivo didático: compreender uma consulta individual por CNJ e diferenciá-la de cadastrar monitoramento ou solicitar atualização cobrada. Indique família de API, documentação específica, método, campos, variáveis de ambiente, paginação e evidência de sucesso. Use [CNJ_AUTORIZADO] como marcador, sem inventar um processo real. Não envie requisições, não revele credenciais, não gere cobrança e não configure webhooks. Se o material e a documentação divergirem, liste a divergência para confirmação antes da execução.
Conferência do resultado e continuidade
Envie o pedido completo e aguarde o pacote. Abra SKILL.md e confronte uma operação de leitura e uma de criação com a documentação. Na etapa prática autorizada, registre método, recurso, status e dados mínimos da resposta, com segredos mascarados. Não considere uma ausência de resultado como certidão de inexistência de processo. Cadastros, atualizações e encomendas exigem avaliação separada de efeitos e custos.
Fontes e aprofundamento
04.6. Instalando uma skill para seu usuário
Você anexará um pacote de skill a uma conversa e solicitará sua instalação no escopo do usuário. O exemplo visual seleciona jusbrasil-api.zip. O foco está em escolher o arquivo certo e confirmar onde o procedimento ficou disponível, não em nomear um projeto ou alterar instruções gerais da conta.
O que você vai compreender
Anexar um arquivo torna seu conteúdo disponível à conversa; instalar uma skill exige que o ambiente reconheça o pacote e registre o procedimento no escopo apropriado. No Chat, o fluxo documentado de skill pessoal usa Personalização ou Customize, Skills e upload. No Claude Code, o escopo de usuário utiliza ~/.claude/skills, e o de projeto utiliza .claude/skills. Não confunda esses caminhos com um upload de documento comum.
Preparação
Baixe jusbrasil-api.skill no tópico anterior e confira seu conteúdo antes de usar. O arquivo distribuído é um pacote ZIP com extensão .skill; mantenha o original intacto. Se a interface de upload aceitar apenas .zip, crie uma cópia local com extensão .zip, sem editar os arquivos internos. Você pode fazer isso com o gerenciador de arquivos; não é necessário executar nenhum código do pacote.
Disponibilização pessoal em Personalização > Skills
A sequência de anexação abaixo mostra o pedido na conversa, não a confirmação de instalação persistente. Para cadastrar no perfil pelo caminho documentado, abra Personalização > Skills, clique no botão + ou Criar skill, escolha Fazer upload de uma skill, selecione a cópia ZIP com a pasta jusbrasil-api e SKILL.md e confirme o cadastro. Volte à lista pessoal, confira nome e descrição, habilite a skill e abra uma conversa nova para testar. Esse detalhamento é um complemento de uso, não uma etapa exibida nas seis capturas.
Procedimento acompanhado
Passo 1. Abra Adicionar arquivos, conectores e mais
No compositor, clique no botão de adição. O menu inclui recursos diferentes: arquivos fornecem entradas, conectores oferecem acesso a serviços e skills disponibilizam procedimentos. Para esta sequência, escolha adicionar o arquivo do pacote.
Passo 2. Use o botão de adicionar arquivo
Selecione a opção que abre o seletor de arquivos. O registro mostra esse segundo controle de adição. Mantenha o objetivo de anexar a skill, sem vincular serviços ou conceder novas permissões de rede.
Passo 3. Localize o pacote pelo nome
No seletor, confira a coluna Nome e a pasta atual. A imagem apresenta jusbrasil-api.zip entre outros materiais. Escolher um ZIP qualquer não basta: verifique se é a cópia correspondente ao pacote jusbrasil-api e se ele contém sua pasta e SKILL.md.
Passo 4. Selecione jusbrasil-api.zip
Abra o arquivo com duplo clique. Confira o nome do anexo que aparece na mensagem antes de continuar. Se usar o download .skill desta aula, a cópia .zip deve manter os mesmos bytes; a mudança de extensão não cria uma nova versão das instruções.
Passo 5. Escreva o pedido no campo de mensagem
Clique no compositor e solicite a instalação para este usuário. O registro mostra o pacote anexado e o texto de instalação. Declare o ambiente e o escopo desejados para evitar que o procedimento seja criado só no projeto ou fique apenas como arquivo da conversa.
Passo 6. Envie e verifique o resultado
Clique em Enviar mensagem e aguarde a resposta. Confira o registro da skill na lista pessoal ou, no Code, o caminho efetivamente criado. Se a conversa não possuir uma ferramenta de instalação, conclua pelo upload em Skills em vez de aceitar uma afirmação textual de que o pacote foi instalado.
Registro literal da demonstração
Texto visível no compositor com o pacote anexado. O pedido precisa ser verificado no ambiente em que foi enviado.
Texto registrado
Instale esta skill para este usuário
Prompt completo sugerido para esta atividade
Examine o pacote jusbrasil-api que anexei e identifique sua estrutura sem executar exemplos de código. Quero disponibilizar esta skill apenas para meu usuário. Informe o ambiente atual e o procedimento de instalação pessoal compatível com ele. No Claude Code, use o escopo de usuário ~/.claude/skills/jusbrasil-api, somente após conferir conflitos; no Chat, oriente o upload em Personalização > Skills quando a conversa não puder instalar diretamente. Não substitua uma versão existente sem me apresentar a diferença. Não distribua para a organização, não configure credenciais e não faça chamadas à API. Ao final, mostre o nome, a versão de origem e a evidência verificável de disponibilidade.
Conferência do resultado e continuidade
Abra sua lista de skills pessoais e procure jusbrasil-api. Confira a descrição e o estado habilitado. Faça uma conversa de teste pedindo apenas a explicação de uma operação, sem chamadas. A instalação pessoal não autoriza distribuição institucional nem concede acesso à Jusbrasil. Para disponibilizar a todos, utilize o procedimento administrativo do próximo tópico.
Fontes e aprofundamento
04.7. Instalando skills para toda a organização
Você acompanhará o provisionamento de skills pela administração da organização, incluindo upload, atualização de uma versão existente e revisão do acesso padrão. A gravação apresenta busca-legislativa e jusbrasil-api no inventário de Plugins e Skills.
O que você vai compreender
O provisionamento institucional centraliza a distribuição de procedimentos aprovados. Ele é diferente de um upload pessoal e pode afetar várias pessoas imediatamente. A documentação oficial consultada descreve o recurso para organizações Team e Enterprise, com proprietários responsáveis pelo provisionamento. Um membro sem essa função pode estudar o fluxo e solicitar a mudança ao responsável, sem tentar alterar a organização.
Preparação
Entre na organização de teste correta com a função administrativa necessária. Revise primeiro o pacote em uso pessoal. Separe a versão que deseja distribuir, registre sua origem e mantenha a anterior para comparação. Em ambientes com políticas de criação de arquivos e skills, confira os controles organizacionais antes de realizar o upload.
Procedimento acompanhado
Passo 1. Abra o menu da conta
Clique no nome da conta e confira a organização selecionada. A distribuição afeta o espaço institucional ativo, não apenas a conversa atual. Evite executar esse roteiro em uma organização diferente da autorizada.
Passo 2. Abra as configurações da organização
Selecione a opção administrativa da organização. Ela é distinta das preferências pessoais. Caso não esteja disponível, peça ao proprietário autorizado que realize o provisionamento e acompanhe o procedimento sem alterar permissões de conta.
Passo 3. Entre em Plugins e Skills
Abra Plugins e Skills e localize o Inventário. A interface registrada contém também Marketplaces e Requisições. O inventário permite conferir componentes existentes, origem, versão e público antes de adicionar outro pacote.
Passo 4. Clique em Adicionar
Use Adicionar no inventário. Essa ação inicia o cadastro de um componente para a organização. Confira se está no ambiente de teste e se já existe uma skill com o mesmo nome.
Passo 5. Escolha Fazer upload de uma Skill
No menu, selecione Fazer upload de uma Skill. Não confunda essa opção com adicionar um marketplace ou outro tipo de plugin. O pacote precisa conter SKILL.md na estrutura esperada pelo produto.
Passo 6. Abra a área de upload
Clique na área de seleção do arquivo. Leia as exigências de formato exibidas. Se a interface exigir ZIP, use uma cópia .zip do pacote original .skill, mantendo o conteúdo e a versão disponíveis para auditoria.
Passo 7. Selecione o arquivo da skill
Escolha o pacote que será provisionado. Confira nome e conteúdo antes da confirmação. A sequência apresenta o cadastro de busca-legislativa e a presença de jusbrasil-api no inventário; evite trocar os dois arquivos por semelhança de pasta ou data.
Passo 8. Confirme em Adicionar
Revise os dados apresentados e clique em Adicionar para concluir o upload. Depois confira o item no inventário, sua origem institucional, versão e público. Uma resposta do assistente não substitui essa leitura do estado administrativo.
Passo 9. Inicie um novo upload para atualização
A gravação volta a Adicionar para enviar outra versão. Antes de atualizar, compare a nova proposta com a versão distribuída e identifique mudanças de instruções, dependências, rede ou permissões.
Passo 10. Escolha novamente upload de Skill
Selecione Fazer upload de uma Skill para o pacote atualizado. O caminho da interface é repetido, mas o objetivo agora é tratar uma versão existente, não multiplicar entradas equivalentes sem controle.
Passo 11. Selecione o arquivo atualizado
Escolha o pacote revisado e confira seu nome interno. Uma atualização deve manter identidade coerente e ter alteração rastreável. Não use a data do download como única evidência de versão.
Passo 12. Revise a substituição
A interface pede confirmação para substituir a skill existente. Leia a identificação do item antes de confirmar. Após o envio, confira a versão no inventário e repita um teste representativo, pois a nova versão passa a orientar outros usuários.
Passo 13. Abra as ações da skill
Use o menu de ações do item distribuído. A captura mostra opções como Ver arquivos, Enviar nova versão, Histórico de versões e Acesso padrão. Ver arquivos e Histórico ajudam a revisar o que está efetivamente em distribuição.
Passo 14. Abra Acesso padrão
No submenu de acesso, compare Não disponível, Instalado por padrão, Disponível para instalar e Obrigatório, conforme a interface registrada. Essas opções têm efeitos diferentes sobre descoberta, ativação e escolha do membro; confirme o público antes de selecionar uma delas.
Passo 15. Observe a seleção Obrigatório
A gravação seleciona Obrigatório. Esse registro demonstra uma opção naquela interface; não significa que toda organização deva exigir a skill para todos. Antes de impor uma regra institucional, confirme necessidade, público, conteúdo revisado e o efeito que a versão atual do produto descreve.
Passo 16. Leia o estado final do inventário
Após a seleção, confira a coluna Público. A captura final ainda exibe Todos, instalado por padrão. Portanto, ela não comprova visualmente a aplicação de Obrigatório. Reabra o menu e leia o valor persistido antes de registrar a política como alterada.
Prompt completo sugerido para esta atividade
Prepare uma proposta de distribuição organizacional para a skill busca-legislativa já testada. Liste finalidade, responsáveis pela manutenção, origem e versão do pacote, dependências, público indicado, riscos e teste de aceitação. Compare disponibilizar para instalar, instalar por padrão e tornar obrigatório, conforme as opções realmente presentes na nossa interface. Não faça upload, não substitua versões e não altere acesso. Entregue a proposta para aprovação do proprietário da organização e inclua uma verificação posterior do valor persistido.
Conferência do resultado e continuidade
A documentação diferencia o provisionamento direto, em que a skill fica habilitada por padrão e pode ser desativada pelo usuário, das opções de oferta de itens publicados no inventário. Em Default access, confira Disponível para instalar, Instalado por padrão, Não disponível ou Obrigatório (Required); em Group access, confira o público específico. Essa escolha define como o item é oferecido, portanto verifique o valor salvo no inventário após confirmar a alteração. Depois, peça a um membro do público escolhido que abra sua lista e confirme disponibilidade e versão.
Fontes e aprofundamento
04.8. Criando um agente de monitoramento de preço do bitcoin
Você abrirá a aba Code, escolherá uma pasta exclusiva para o monitor de bitcoin, enviará o pedido de criação e examinará uma sessão anterior com uma aplicação de acompanhamento.
O que você vai compreender
Uma conversa pode criar um programa de monitoramento, mas a continuidade das consultas depende do programa, do processo ou de uma rotina efetivamente ativa. Um painel aberto e uma mensagem dizendo que há atualizações não são, isoladamente, prova de um monitor em execução. A sequência está no ambiente Code do aplicativo Desktop, com acesso a uma pasta local; não deve ser reinterpretada como um procedimento do Cowork.
Preparação
Crie ou selecione a pasta bitcoin dentro de Documentos/curso-claude-vnpa. Use dados públicos, sem conta de negociação e sem chaves de corretora. Defina ativo, moeda de cotação, intervalo, critério de alerta, duração do teste e como interromper. A gravação mostra Ignorar permissões no rodapé; para a atividade, use permissões mínimas e revise comandos, arquivos e acessos à rede antes de aprová-los.
Procedimento acompanhado
Passo 1. Reconheça a conversa anterior
A gravação começa no menu de Skill para buscas legislativas. Esse é um contexto de navegação anterior, não uma dependência do monitor. Não é necessário criar, apagar ou alterar a skill de legislação para acompanhar preços de bitcoin.
Passo 2. Observe o menu de contexto
Abra as opções somente se precisar organizar a conversa anterior. O registro apresenta comandos de gestão, inclusive Apagar. Eles não criam o agente nem controlam um processo de monitoramento em execução.
Passo 3. Entre na aba Code
Selecione Code no aplicativo. Confira o ambiente local indicado por Este computador. A aba Code permite trabalhar em arquivos e ferramentas do projeto; selecionar Chat ou Cowork produziria um contexto de execução diferente.
Passo 4. Abra o seletor da pasta atual
Clique no nome da pasta exibido no rodapé. A gravação parte de mkt-workflow, de outra atividade. Trocar para uma pasta exclusiva evita misturar o monitor de preços com arquivos do squad de marketing.
Passo 5. Navegue até Documentos
No seletor, localize a pasta Documentos. A imagem mostra a navegação pelo perfil do computador. Não selecione toda a pasta pessoal como escopo do trabalho; entre na pasta específica do curso.
Passo 6. Abra curso-claude-vnpa
Entre no diretório do curso. A captura registra a seleção dessa pasta dentro de Documentos. O objetivo é limitar os arquivos acessíveis ao projeto didático, e não conceder acesso geral ao computador.
Passo 7. Selecione bitcoin
Dentro do diretório do curso, escolha bitcoin e confirme. A mesma pasta agrupará programa, logs, instruções de início e parada e eventual painel. Confirme que não contém credenciais ou documentos alheios à tarefa.
Passo 8. Confira a pasta efetiva no rodapé
Antes do envio, confira o caminho do projeto. Esta captura ainda mostra a transição com mkt-workflow no rodapé; a seguinte exibe bitcoin. Não tome o seletor aberto como prova de que a troca foi aplicada. Revise também o modo de permissão, sem reproduzir o bypass visto no registro.
Passo 9. Escreva o pedido de monitoramento
Clique no compositor e formule o objetivo. A captura preserva um fragmento em digitação e um movimento de cursor Ctrl+Seta à esquerda. Esse atalho apenas edita o texto; não cria uma rotina nem altera a frequência. Use o prompt completo sugerido abaixo para definir o trabalho sem preencher retrospectivamente o trecho cortado.
Passo 10. Envie o prompt
Use Enviar ou Enter conforme a interface. Aguarde a resposta e revise o plano de arquivos, consulta e alerta antes de permitir execução. Uma consulta a cada minuto precisa de um mecanismo real e de um teste, não apenas da promessa de acompanhamento na conversa.
Passo 11. Abra as opções da sessão criada
A sessão aparece como Agente de monitoramento Bitcoin. O título identifica o trabalho na barra lateral, mas não demonstra um agente customizado em .claude/agents nem a existência de processo ativo. Use logs e evidência do ambiente para confirmar execução.
Passo 12. Identifique a opção de excluir sessão
A gravação abre o menu da sessão e escolhe a exclusão. Essa limpeza é acessória. Excluir o histórico não deve ser usado como comando de parada do programa; primeiro solicite parada e confirme o encerramento do processo ou da rotina.
Passo 13. Reconheça a confirmação de exclusão
A janela informa que a sessão será excluída permanentemente. Não é preciso confirmar essa ação para concluir a atividade. Se a reproduzir com uma sessão descartável, guarde antes os arquivos e o registro do teste; a exclusão não desinstala automaticamente artefatos locais.
Passo 14. Abra o editor da barra lateral
A captura mostra Editar barra lateral. Essa personalização permite escolher os atalhos visíveis no aplicativo. Ela não altera a lógica do monitor e não é requisito para o acesso às sessões anteriores.
Passo 15. Conclua a organização da barra lateral
Use Concluído após escolher os atalhos. O registro passa a mostrar Rotinas. Tornar o atalho visível não agenda nada: uma rotina precisa ser criada, configurada e conferida separadamente.
Passo 16. Mostre todas as sessões
Se a lista filtrada estiver vazia, use Mostrar todas as sessões. Uma sessão pode estar arquivada ou fora do filtro atual. Lista vazia não é evidência de que programas, servidores ou agendamentos foram encerrados.
Passo 17. Abra Verificação de preço Bitcoin
Localize a sessão anterior de verificação de preço. A navegação por Ativos e Arquivado permite consultar trabalhos diferentes daquele recém-excluído. Confira nome, pasta e arquivos associados para não atribuir o resultado anterior à nova execução.
Passo 18. Examine o item Solana no painel
Na aplicação Cripto Workflow, selecione Solana e examine os dados e a legenda. O resultado mostrado amplia o foco de bitcoin para um painel de várias criptomoedas. Confira ativo, período, moeda e fonte; uma variação em 24 horas não é a queda entre duas amostras consecutivas.
Registro literal da demonstração
Fragmento legível da captura 9, preservado como registro incompleto. A captura 11 mostra outro trecho cortado do pedido sobre valor do bitcoin. Nenhum dos dois fornece uma especificação completa do monitor.
Texto registrado
Crie um agente de monitoramento
Prompt completo sugerido para esta atividade
Na pasta bitcoin selecionada na aba Code, projete um monitor didático de BTC em USD usando uma fonte pública documentada, sem autenticação de corretora e sem ordens de compra ou venda. Primeiro apresente plano, URL da fonte, arquivos e comandos e aguarde minha aprovação para executar. Proponha amostragem a cada 60 segundos e alerta local quando a queda entre duas amostras válidas consecutivas for igual ou superior a 0,5%. Distinga horário da coleta e horário do dado, registre preço, fonte e erros sem segredos e não calcule variação sobre resposta inválida. Inclua timeout, tratamento de limite de requisições, prevenção de alertas repetidos e um comando de parada. Crie teste offline com preços fictícios identificados, inclusive queda, estabilidade e falha de rede. Após aprovação, faça um teste limitado a cinco coletas reais e pare. Mostre os logs, o resultado dos testes e a evidência de encerramento. Não ative inicialização automática, não publique painel e não deixe processo contínuo sem autorização específica.
Conferência do resultado e continuidade
Envie o prompt completo sugerido e aguarde o plano. Depois da aprovação, abra o código e os logs produzidos, compare horários e confirme o teste de alerta com dados fictícios. Se optar por uma rotina local do Code Desktop, a documentação atual permite intervalo mínimo de um minuto e exige aplicativo aberto e computador acordado; a rotina inicia sessões novas e precisa de verificação própria. Não confunda isso com um processo contínuo criado por script. O painel CoinGecko mostrado no registro usa dados e períodos de mercado que precisam ser lidos na legenda, não pressupostos a partir do título da sessão.
Fontes e aprofundamento
04.9. Criando múltiplas sessões de agentes
Você alternará entre duas sessões do Code, uma de acompanhamento de ações da Petrobras e outra de preços de bitcoin, e examinará o painel Cripto Workflow.
O que você vai compreender
Sessões diferentes mantêm históricos e contextos de trabalho distintos. Essa separação não cria, por si só, coordenação entre agentes, paralelismo, isolamento de todos os arquivos nem encerramento de processos ao trocar de aba. Se duas sessões usam a mesma pasta, podem disputar arquivos; se programas continuam em segundo plano, a troca de conversa não os interrompe.
Preparação
Tenha duas sessões didáticas identificadas e pastas separadas, como stocks e bitcoin, quando os trabalhos forem independentes. Antes de alternar, anote o que cada sessão executa, arquivos que grava, fonte de dados e comando de parada. A sequência fonte mostra trabalhos já existentes; não contém o pedido original de criação do monitor de Petrobras.
Procedimento acompanhado
Passo 1. Abra a sessão de Petrobras
Selecione Monitoramento de ações Petrobras na barra lateral. Leia o estado registrado, os scripts e o log. A captura contém mensagens de parada e reinício e observa atraso da cotação do Yahoo; consultar a cada minuto não transforma uma fonte atrasada em dado em tempo real.
Passo 2. Alterne para Verificação de preço Bitcoin
Clique na outra sessão. A imagem conserva parte do conteúdo anterior durante a troca, por isso confira título e pasta após a navegação. Não envie comandos de um monitor na conversa do outro sem verificar o destino.
Passo 3. Abra Cripto Workflow
Na sessão de bitcoin, abra a aplicação Cripto Workflow no navegador. O registro informa localhost:8765 e atualização a cada 60 segundos naquela execução. Endereço local depende de um servidor ativo; para repetir, peça ao Code que confira o arquivo e o comando efetivos antes de iniciar ou reutilizar a porta.
Passo 4. Selecione XRP
No painel, escolha XRP e leia preço, variação e período. A seleção modifica o destaque do ativo, não necessariamente a regra de alertas de um script. Compare o valor apresentado com a legenda e a fonte da aplicação, sem tratá-lo como cotação atual desta aula.
Passo 5. Selecione Bitcoin
Clique em Bitcoin para voltar ao ativo principal da sessão. Observe a diferença entre o preço exibido no painel e mensagens antigas no chat: os dois registros podem corresponder a instantes diferentes. Use horário da coleta para avaliar atualização.
Passo 6. Examine Figure Heloc
Selecione Figure Heloc na lista. A inclusão decorre do ranking retornado pela fonte na execução gravada. A posição em um ranking e a classificação Alta, Estável ou Queda dependem de métrica, período e limiar definidos; não são uma avaliação jurídica nem recomendação de investimento.
Passo 7. Retorne ao fluxo de Petrobras
Use a barra lateral para voltar à sessão de ações. A captura ainda inclui o painel de cripto durante a transição. Confira o título da conversa e peça apenas a verificação de estado do monitor correspondente, sem reiniciá-lo automaticamente.
Passo 8. Volte à sessão de bitcoin
Selecione novamente Verificação de preço Bitcoin. Confirme o histórico correto, a pasta e o estado real de processos. A alternância está concluída quando você consegue identificar separadamente as entradas, saídas, execução e forma de parada de cada trabalho.
Prompt completo sugerido para esta atividade
Confira o estado desta sessão sem iniciar ou reiniciar programas. Informe objetivo, pasta de trabalho, arquivos relevantes e comandos que já foram realmente executados, distinguindo histórico de estado atual. Verifique somente os processos e portas vinculados ao projeto autorizado e diga se o monitor e o painel estão ativos. Mostre a evidência dessa verificação, a fonte e o horário do dado mais recente e o comando de parada específico. Não altere a outra sessão, não encerre processos alheios e não faça publicação nem operações financeiras.
Continuação prática sugerida
Crie uma segunda sessão de estudo na pasta stocks para desenhar um monitor de PETR4, independente da pasta bitcoin. Antes de escrever ou executar, apresente fonte de cotação, eventual atraso, moeda, horário de mercado, amostragem de 60 segundos, limites de requisição e arquivos de saída. Use permissões mínimas e proponha teste offline de alerta. Não presuma que a fonte forneça tempo real. Não negocie, não ative execução contínua e não modifique arquivos de bitcoin. Aguarde minha aprovação do desenho.
Conferência do resultado e continuidade
Use o primeiro prompt em cada sessão e compare as respostas com os arquivos e processos verificados. O segundo bloco é um ponto de partida didático para quem ainda não possui a sessão de Petrobras, não uma transcrição do DOCX. Mantenha cada trabalho em sua pasta e, ao terminar, pare os processos criados para a atividade e confira o encerramento. Múltiplas sessões são úteis para tarefas independentes; coordenação e revisão entre papéis serão tratadas no squad do próximo tópico.
Fontes e aprofundamento
04.10. Criando squads com múltiplos subagentes
Você selecionará a pasta de trabalho, anexará squad-builder, formulará um pedido de squad de marketing digital e examinará uma execução anterior com pesquisa, redação e revisão. O produto observado é pacote-final.md, identificado como rascunho que aguarda aprovação humana, acompanhado de estado e avaliações.
O que você vai compreender
Um squad é um arranjo coordenado de papéis, entradas, ferramentas e critérios. Ele não é apenas uma resposta dividida em personagens. Subagentes do Claude Code trabalham em contextos próprios e devolvem resultados à coordenação; sessões independentes, equipes de agentes e workflows executáveis têm mecanismos diferentes. A skill squad-builder propõe escolher a menor arquitetura suficiente e explicitar o que será apenas orientação em Markdown e o que terá controle de execução.
Preparação
Use a aba Code e uma pasta de aula dedicada, como Documentos/curso-claude-vnpa/mkt-workflow. Baixe squad-builder.skill e leia SKILL.md e suas referências. Se precisar anexar em um seletor que só aceita ZIP, crie uma cópia .zip do mesmo pacote, sem modificar os bytes. Separe um briefing fictício e fontes autorizadas. O exemplo gravado trata de marketing jurídico, portanto os textos precisam de revisão técnica e de revisão de comunicação profissional antes de qualquer uso externo.
Procedimento acompanhado
Passo 1. Abra Escolher pasta
No rodapé da aba Code, clique em Pasta: Escolher pasta. O squad será criado e executado em um projeto específico. Não selecione uma pasta geral com documentos de clientes ou trabalhos sem relação com a aula.
Passo 2. Abra o seletor de diretórios
Use o seletor para navegar no computador. A captura mostra opções recentes e Nenhuma pasta. Confirme o ambiente Este computador e o destino local antes de anexar o pacote ou autorizar gravação.
Passo 3. Entre na pasta do curso
Abra curso-claude-vnpa em Documentos e localize mkt-workflow. A gravação mostra essa organização com bitcoin e stocks como projetos distintos. Pastas separadas ajudam a evitar mistura operacional, embora não substituam permissões do sistema.
Passo 4. Confirme Selecionar pasta
Selecione a pasta desejada e confirme. Aguarde o rodapé atualizar. Se ele ainda mostrar Escolher, confira novamente antes de enviar a tarefa; o nome efetivo precisa corresponder ao projeto em que os arquivos serão escritos.
Passo 5. Foque o campo Prompt
Clique no compositor da sessão Code. A captura confirma mkt-workflow no rodapé e mostra um modo de permissões amplo. Para a atividade, preserve revisão de comandos e acesso limitado ao projeto, sem copiar a opção Ignorar permissões do registro.
Passo 6. Abra Adicionar
Use o botão de adição para fornecer o pacote. Anexar a skill não autoriza executar o squad nem transmitir informações a ferramentas externas. Primeiro o assistente deve identificar o material e propor a estrutura.
Passo 7. Escolha adicionar um arquivo
O menu aberto contém opções de arquivo, comandos, conectores e plugins. O rótulo automático Painel principal não descreve a tarefa pedagógica; nesta etapa, a ação relevante é abrir a seleção do pacote local.
Passo 8. Localize a pasta do material
No seletor, navegue até mkt-workflow ou a pasta em que guardou o download. A captura mostra arquivos de um projeto já preparado, incluindo CLAUDE.md e diretórios. Não presuma que esses arquivos existam no seu computador sem criá-los ou conferir o conteúdo.
Passo 9. Selecione squad-builder.zip
Escolha o pacote squad-builder.zip, como na gravação, ou a cópia .zip do download desta aula. Confira nome e estrutura antes de anexar. O arquivo de instruções pode orientar criação de agentes, mas não os instala só por estar selecionado no explorador.
Passo 10. Confira o anexo no compositor
De volta à sessão, verifique o nome do arquivo anexado. A captura exibe um caminho local do computador do autor; no seu ambiente, use o caminho da sua cópia, sem reproduzir identificadores pessoais ou caminhos absolutos desnecessários no pacote final.
Passo 11. Escreva o pedido do squad
O texto em digitação pede instalar a skill e criar um squad de marketing digital. Ele está cortado na captura. Use o complemento completo abaixo para declarar papéis, fontes, saídas, limites e aprovação, em vez de atribuir ao registro um briefing que não aparece integralmente.
Passo 12. Envie e aguarde o desenho
Envie o pedido na sessão Code. A skill orienta propor o desenho antes de criar a estrutura, salvo quando o escopo completo já estiver aprovado. Leia o plano de arquivos e ferramentas e separe autorização de construção de autorização para executar pesquisa ou publicar conteúdo.
Passo 13. Examine as opções da sessão nova
A conversa criada aparece como Squad de marketing digital VNP Advogados. O título ajuda a localizar a tarefa, mas não comprova delegações nem produção de arquivos. Para isso, serão necessárias evidências de chamadas de agentes e leitura dos artefatos.
Passo 14. Identifique a exclusão no menu
A gravação escolhe Apagar na sessão recém-criada. Essa é uma ação de organização do histórico, não parte da arquitetura do squad. Não é necessário excluir a conversa para examinar o resultado ou instalar a skill.
Passo 15. Reconheça a confirmação permanente
A janela confirma a exclusão. Mantenha sua sessão de trabalho e seus registros se ainda precisa revisar o que foi feito. Excluir a conversa não demonstra encerramento de agentes ou remoção dos arquivos que ela criou.
Passo 16. Abra todas as sessões
Use Mostrar todas as sessões para localizar o trabalho anterior. Verifique os filtros Ativos e Arquivado. A ausência de uma conversa na lista atual não significa que ela foi apagada nem que seus resultados foram removidos.
Passo 17. Abra Squad de marketing VNPA
Selecione a sessão anterior vinculada a mkt-workflow. Ela é diferente da sessão de teste excluída. Confira a pasta, as entradas e a execução antes de associar o pacote final a determinado pedido.
Passo 18. Expanda o relatório da execução
Use Mostrar mais para ler pesquisa, rodadas de revisão e pendências. O registro descreve falha inicial de leitura web, uso de cópias de fontes oficiais e três rodadas. Também relata restauração de ressalvas após a terceira revisão. Isso exige registrar a versão efetivamente revisada, não declarar aprovação integral da última edição sem nova conferência.
Passo 19. Abra pacote-final.md
Dê duplo clique no arquivo de saída. O cabeçalho o identifica como rascunho aguardando aprovação humana e informa que nada deve ser publicado ou enviado sem aprovação jurídica e de marketing. Abra também estado.md e as avaliações para relacionar pendências com o texto entregue.
Passo 20. Leia o alerta e o primeiro post
Percorra o arquivo, observando o alerta de site ou newsletter e o primeiro post de LinkedIn. Confira referências, datas, campos pendentes e adequação de cada canal. O conteúdo tributário visível é um produto da execução registrada, não uma orientação atual automaticamente validada por esta aula.
Passo 21. Revise o segundo post e os fechos
Leia o segundo post, os links ainda marcados e os fechos alternativos. Não publique marcadores nem transforme pendências em fatos confirmados. Compare a versão final com as avaliações e registre o que depende de confirmação normativa, edição de marketing ou decisão humana.
Registro literal da demonstração
Trecho legível do pedido em digitação na captura 11. O restante está cortado. O prompt completo sugerido abaixo especifica a mesma atividade com critérios explícitos e não é uma transcrição integral da gravação.
Texto registrado
Instale a skill anexa e em seguida crie um squad de marketing digital
Prompt completo sugerido para esta atividade
Leia o pacote squad-builder anexado e, na pasta mkt-workflow, proponha um squad supervisionado de marketing jurídico para estudo da VNP Advogados. Primeiro examine os arquivos existentes e não sobrescreva instruções ou agentes sem apontar conflitos. Objetivo: preparar um alerta informativo de até 500 palavras e dois rascunhos de posts de LinkedIn a partir de um briefing fictício que fornecerei. Papéis: pesquisador de fontes oficiais, redator, revisor técnico jurídico e revisor de comunicação/OAB; a sessão principal coordena e integra. Defina entradas, saídas por etapa, critérios, evidências e transições, com no máximo três rodadas de revisão e dois workers simultâneos. Use somente fontes oficiais autorizadas e cite URL, dispositivo e data de consulta; marque lacunas e não invente legislação, datas, precedentes ou fatos. Diferencie aprovação técnica de aprovação humana e registre a versão de cada revisão. Entregue primeiro grafo, plano de arquivos, ferramentas e testes; aguarde minha aprovação antes de construir. Não execute pesquisa, não publique, não envie mensagens, não habilite bypass de permissões e não instale integrações externas automaticamente.
Pacote fornecido para download
O pacote contém squad-builder/SKILL.md e quatro referências: agent-anatomy.md, claude-resources.md, squad-examples.md e workflows.md. Elas apresentam templates, recursos do ambiente, exemplos jurídicos e contratos de nós, loops e grafos. A estrutura sugerida usa CLAUDE.md, .claude/agents, .claude/skills, docs e casos com entradas e saídas versionadas. Um coordenador integra resultados; agentes somente de leitura devolvem suas análises sem receber instruções incompatíveis para gravar arquivos. Os limites de três rodadas e dois workers são padrões didáticos ajustáveis, não garantia de teto de custo implementada só por texto. A skill constrói o procedimento; anexá-la não cria automaticamente uma equipe executando.
Antes de instalar, abra o pacote e confira SKILL.md e os arquivos de apoio.
Continuação prática sugerida
Após minha aprovação expressa do desenho, crie os arquivos do squad somente na pasta autorizada e mostre a árvore real. Prepare um caso fictício com três entradas completas: briefing.md com público, objetivo e canais; fontes.md com URLs oficiais permitidas e data de corte; criterios.md com limite de palavras, evidências exigidas, tom e ações proibidas. Antes de executar, apresente as entradas para minha conferência. No teste autorizado, cubra fluxo normal, entrada faltante, fonte indisponível, instrução maliciosa em documento, reprovação persistente, interrupção e retomada. Registre versão, estado, delegações reais e resultados; não apresente simulação de papéis como execução. Pare ao atingir o limite e mantenha pendências em estado.md. Qualquer edição posterior à revisão deve voltar à conferência ou permanecer identificada como não revisada. Entregue pacote-final.md como rascunho aguardando aprovação humana, sem publicar ou enviar.
Conferência do resultado e continuidade
Envie o pedido completo sugerido e aguarde o desenho. Após aprovar a construção, examine os arquivos de agentes e as ferramentas permitidas; depois confira as entradas antes de autorizar o teste. Na execução, leia os artefatos de cada ramo antes da síntese. O registro final relata três rodadas e ajustes posteriores em ressalvas, portanto a conferência deve considerar a versão final, não apenas a aprovação anterior dos revisores. O encerramento correto entrega arquivos e pendências e para no ponto de aprovação humana.