Habilidade de agente

Uma habilidade pronta a usar para o Claude Code, o Codex e outros ambientes de agentes.

A habilidade de agente da TypeSafe dá ao teu agente de programação de IA o contexto completo sobre a API da TypeSafe: os três tipos de pergunta, os padrões de arquitetura e as boas práticas para estruturar avaliações.

Instalação

Executa estes dois comandos no teu terminal:

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

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

Escolhe o teu agente quando solicitado. A instalação é local ao projeto por predefinição; acrescenta -g para instalar globalmente.

Cola este prompt no teu 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.

Lê o SKILL.md no GitHub ou obtém diretamente o Markdown em bruto. Para instalação manual, copia o diretório skills/typesafe-ai inteiro, incluindo os seus ficheiros de referência, para o diretório de habilidades do teu agente.

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

Atualizações

Para o plugin do Claude Code, executa:

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

Reinicia o Claude Code ou executa /reload-plugins para carregar a atualização. Para ativar atualizações automáticas, abre /plugin e seleciona Marketplaces → typesafe-ai → Enable auto-update.

Para instalações via skills.sh, executa npx skills update. Para cópias manuais, substitui o diretório da habilidade inteiro pela versão mais recente do GitHub.

Prompts de exemplo

Nomear a habilidade no teu prompt — «usa a habilidade TypeSafe» — funciona em qualquer agente, por isso cada um dos prompts abaixo o faz. Com o plugin do Claude Code, também podes invocar /typesafe:typesafe-ai diretamente.

Um bom prompt para começar é um prompt de brainstorm que te ajuda a descobrir onde a TypeSafe pode ser melhor usada num 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.

Também podes criar uma chave de API e dar ao teu 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.

Aponta o teu agente a um cookbook específico que resolva um problema que tens no teu código, ou aponta-o ao índice de cookbooks e pergunta se há padrões semelhantes aos do teu 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.

Bons princípios de vibe coding

Fala com o teu agente, usando os prompts de exemplo acima como ponto de partida.
Revê o plano e garante que faz sentido antes de o implementar.
Coloca as constantes (perguntas e limiares) num único sítio, para serem fáceis de rever. Os agentes não são ótimos a escrever perguntas, por isso conta com edições colaborativas com eles.
Não aceites as afirmações à letra; incentiva o agente a validar os seus pressupostos.

Problemas comuns

O agente não está a usar a habilidade

Com o plugin do Claude Code, invoca /typesafe:typesafe-ai. Noutros agentes, pede para «usar a habilidade TypeSafe». Se continuar a não carregar, confirma que o instalador apontou para o agente que estás a usar e reinicia o agente.

O encaminhamento não funciona como esperas

Verifica as perguntas e os limiares. É possível que os teus limiares estejam demasiado altos (causando falsos negativos) ou demasiado baixos (causando falsos positivos). Podes também precisar de afinar as perguntas para serem mais específicas.

Estás a usar limiares de confiança em todo o lado

Se só te interessa escolher a melhor opção, basta escolher a opção com a maior confiança (em vez de definir um limiar de confiança). Se tens em mente um algoritmo estatístico específico, provavelmente deves usar as probabilidades em vez da confiança.

É difícil rever código TypeSafe

O mais importante para as pessoas reverem são as perguntas e quaisquer constantes de limiar usadas no teu código TypeSafe. Devem ser definidas num único ficheiro de código, para serem fáceis de encontrar sem grande investigação.

O agente inventa campos do pedido ou da resposta

Uma habilidade desatualizada pode causar isto. Atualiza-a usando o teu método de instalação acima e tenta de novo.