Skill de agente

Uma skill pronta para usar no Claude Code, Codex e outros ambientes de agentes.

A skill de agente da TypeSafe dá ao seu agente de programação com IA o contexto completo da API da TypeSafe: os três tipos de pergunta, os padrões arquitetônicos e as boas práticas para estruturar avaliações.

Instalação

Execute estes dois comandos no seu terminal:

claude plugin marketplace add typesafe-ai/skills
claude plugin install typesafe@typesafe-ai

npx skills add typesafe-ai/skills --skill typesafe-ai

Escolha o seu agente quando for solicitado. A instalação é local ao projeto por padrão; adicione -g para instalar globalmente.

Cole este prompt no seu agente de programação:

Install the TypeSafe skill. If you're in Claude Code, run `claude plugin marketplace add typesafe-ai/skills`, then `claude plugin install typesafe@typesafe-ai`. If you're in another agent, run `npx skills add typesafe-ai/skills --skill typesafe-ai` and select your agent. Use one installation method. You can read the skill directly at https://github.com/typesafe-ai/skills/blob/main/skills/typesafe-ai/SKILL.md (raw: https://raw.githubusercontent.com/typesafe-ai/skills/main/skills/typesafe-ai/SKILL.md). Then use the TypeSafe skill when working on this project.

Leia o SKILL.md no GitHub ou obtenha diretamente o Markdown bruto. Para instalação manual, copie todo o diretório skills/typesafe-ai, incluindo os seus arquivos de referência, para o diretório de skills do seu agente.

Escolha um único método de instalação para evitar cópias duplicadas.

Atualizações

Para o plugin do Claude Code, execute:

claude plugin marketplace update typesafe-ai
claude plugin update typesafe@typesafe-ai

Reinicie o Claude Code ou execute /reload-plugins para carregar a atualização. Para habilitar as atualizações automáticas, abra /plugin e selecione Marketplaces → typesafe-ai → Enable auto-update.

Para instalações via skills.sh, execute npx skills update. Para cópias manuais, substitua todo o diretório da skill pela versão mais recente do GitHub.

Prompts de exemplo

Nomear a skill no seu prompt — “use the TypeSafe skill” — funciona em qualquer agente, então cada um dos prompts abaixo faz isso. Com o plugin do Claude Code, você também pode invocar /typesafe:typesafe-ai diretamente.

Um bom prompt para começar é um de brainstorming que ajude você a descobrir onde a TypeSafe pode ser melhor usada em um projeto.

Using the TypeSafe skill, explore the project and find opportunities for using
intelligent judgement to stand in for complex parsing or other fragile code.

Você também pode criar uma chave de API e dar ao seu agente permissão para descobrir a melhor forma de usar a TypeSafe executando consultas de teste baratas.

Using the TypeSafe skill, run some experiments using the TypeSafe API key that I've
exported to `TYPESAFE_API_KEY`. Propose changes based on the most promising results.

Aponte o seu agente para um cookbook específico que resolva um problema que você tem na sua base de código, ou aponte-o para o índice de cookbooks e pergunte se há algum padrão parecido com os do seu projeto.
```
Using the TypeSafe skill, analyze my code and see if there are any applicable
cookbooks (https://console.typesafe.ai/docs/cookbooks) that show how I could
refactor my code to be less fragile or complex.
```

Princípios de um bom vibe coding

Converse com o seu agente, usando os prompts de exemplo acima como ponto de partida.
Revise o plano e garanta que faça sentido antes de implementá-lo.
Coloque as constantes (perguntas e limiares) em um único lugar, para facilitar a revisão. Agentes não são bons em escrever perguntas, então conte com editá-las em colaboração com eles.
Não aceite afirmações sem questionar; incentive o agente a validar as suas suposições.

Problemas comuns

O agente não está usando a skill

Com o plugin do Claude Code, invoque /typesafe:typesafe-ai. Em outros agentes, peça para “use the TypeSafe skill”. Se ainda assim não carregar, confirme que o instalador apontou para o agente que você está usando e reinicie o agente.

O roteamento não funciona como você espera

Verifique as perguntas e os limiares. É possível que os seus limiares estejam altos demais (causando falsos negativos) ou baixos demais (causando falsos positivos). Talvez você também precise ajustar as perguntas para serem mais específicas.

Você usa limiares de confiança em todo lugar

Se a única coisa que importa é escolher a melhor opção, você só precisa escolher a opção com a maior confiança (em vez de definir um limiar de confiança). Se você tem em mente um algoritmo estatístico específico, provavelmente deveria usar probabilidades em vez de confiança.

É difícil revisar o código da TypeSafe

O mais importante para as pessoas revisarem são as perguntas e quaisquer constantes de limiar usadas no seu código da TypeSafe. Elas devem ser definidas em um único arquivo de código, para serem fáceis de encontrar sem muita garimpagem.

O agente inventa campos de requisição ou de resposta

Uma skill desatualizada pode causar isso. Atualize-a com o método de instalação acima e tente de novo.