Skill d’agent

Un skill prêt à l’emploi pour Claude Code, Codex et d’autres environnements d’agents.

Le skill d’agent TypeSafe donne à ton agent de codage IA le contexte complet de l’API TypeSafe : les trois types de question, les motifs d’architecture et les bonnes pratiques pour structurer les évaluations.

Installation

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

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

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.

Lis SKILL.md sur GitHub ou récupère directement le Markdown brut. Pour une installation manuelle, copie tout le répertoire skills/typesafe-ai, y compris ses fichiers de référence, dans le répertoire de skills de ton agent.

Choisis une seule méthode d’installation pour éviter les copies en double.

Mises à jour

Pour le plugin Claude Code, exécute :

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

Redémarre Claude Code ou exécute /reload-plugins pour charger la mise à jour. Pour activer les mises à jour automatiques, ouvre /plugin et sélectionne Marketplaces → typesafe-ai → Enable auto-update.

Pour les installations via skills.sh, exécute npx skills update. Pour les copies manuelles, remplace tout le répertoire du skill par la dernière version GitHub.

Exemples de prompts

Nommer le skill dans ton prompt — « use the TypeSafe skill » — fonctionne dans n’importe quel agent, et chacun des prompts ci-dessous le fait. Avec le plugin Claude Code, tu peux aussi invoquer directement /typesafe:typesafe-ai.

• Un bon prompt pour commencer est un prompt de brainstorming qui t’aide à repérer où TypeSafe peut être le plus utile dans un projet.

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

• Tu peux aussi créer une clé d’API et autoriser ton agent à trouver la meilleure façon d’utiliser TypeSafe en lançant des requêtes de test peu coûteuses.

  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.

• Oriente ton agent vers un cookbook précis qui résout un problème que tu as dans ta base de code, ou vers l’index des cookbooks en lui demandant s’il existe des motifs semblables à ceux de ton projet.

  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.

Principes d’un bon vibe coding

1. Discute avec ton agent, en partant des exemples de prompts ci-dessus.
2. Relis le plan et assure-toi qu’il tient debout avant de l’implémenter.
3. Place les constantes (questions et seuils) en un seul endroit pour qu’elles soient faciles à relire. Les agents ne sont pas doués pour écrire des questions, alors prévois de les modifier en collaboration avec eux.
4. Ne prends pas les affirmations pour argent comptant ; encourage l’agent à valider ses hypothèses.

Problèmes fréquents

L’agent n’utilise pas le skill

Avec le plugin Claude Code, invoque /typesafe:typesafe-ai. Dans les autres agents, demande d’« use the TypeSafe skill ». S’il ne se charge toujours pas, vérifie que l’installateur ciblait bien l’agent que tu utilises, puis redémarre l’agent.

Le routage ne fonctionne pas comme prévu

Vérifie les questions et les seuils. Il se peut que tes seuils soient trop élevés (ce qui provoque des faux négatifs) ou trop bas (ce qui provoque des faux positifs). Tu devras peut-être aussi ajuster tes questions pour les rendre plus précises.

Tu utilises des seuils de confiance partout

Si tout ce qui t’importe est de choisir la meilleure option, il te suffit de choisir l’option avec la confiance la plus élevée (plutôt que de fixer un seuil de confiance). Si tu as en tête un algorithme statistique précis, tu devrais probablement utiliser les probabilités plutôt que la confiance.

Il est difficile de relire du code TypeSafe

Ce qu’il est le plus important de faire relire par des humains, ce sont les questions et les éventuelles constantes de seuil utilisées dans ton code TypeSafe. Elles devraient être définies dans un seul fichier de code pour être faciles à trouver sans trop fouiller.

L’agent invente des champs de requête ou de réponse

Un skill obsolète peut en être la cause. Mets-le à jour avec ta méthode d’installation ci-dessus et réessaie.