jevlaya
Deutsch
Dokumentation

Agent-Skill

Drop-in-Skill für Claude Code, Codex und andere Agenten-Umgebungen.

Der TypeSafe-Agent-Skill gibt deinem KI-Coding-Agenten den vollen Kontext zur TypeSafe-API: die drei Fragetypen, die architektonischen Muster und bewährte Vorgehensweisen zum Strukturieren von Evaluierungen.

Installation

Führe diese beiden Befehle in deinem Terminal aus:

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

Wähle bei der Aufforderung deinen Agenten. Die Installation ist standardmäßig projektlokal; füge -g hinzu, um global zu installieren.

Füge diesen Prompt in deinen Coding-Agenten ein:

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.

Lies SKILL.md auf GitHub oder hole dir das rohe Markdown direkt. Für die manuelle Installation kopiere das gesamte Verzeichnis skills/typesafe-ai, samt seiner Referenzdateien, in das Skills-Verzeichnis deines Agenten.

Wähle eine einzige Installationsmethode, um doppelte Kopien zu vermeiden.

Aktualisierungen

Führe für das Claude Code-Plugin aus:

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

Starte Claude Code neu oder führe /reload-plugins aus, um das Update zu laden. Um automatische Updates zu aktivieren, öffne /plugin und wähle Marketplaces → typesafe-ai → Enable auto-update.

Führe für Installationen über skills.sh npx skills update aus. Ersetze bei manuellen Kopien das gesamte Skill-Verzeichnis durch die neueste GitHub-Version.

Beispiel-Prompts

Den Skill in deinem Prompt zu nennen — „use the TypeSafe skill“ — funktioniert in jedem Agenten, also tut jeder der Prompts unten genau das. Mit dem Claude Code-Plugin kannst du außerdem /typesafe:typesafe-ai direkt aufrufen.

  • Ein guter Prompt für den Anfang ist ein Brainstorming-Prompt, der dir hilft, herauszufinden, wo TypeSafe in einem Projekt am besten eingesetzt werden kann.

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

  • Du kannst auch einen API-Schlüssel erstellen und deinem Agenten erlauben, den besten Einsatz von TypeSafe durch günstige Testabfragen herauszufinden.

    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.

  • Richte deinen Agenten auf ein bestimmtes Cookbook, das ein Problem in deiner Codebasis löst, oder auf den Cookbook-Index und frage, ob es dort Muster gibt, die denen in deinem Projekt ähneln.

    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.

Prinzipien für gutes Vibe Coding

  1. Sprich es mit deinem Agenten durch und nutze die Beispiel-Prompts oben als Ausgangspunkt.
  2. Prüfe den Plan und stelle sicher, dass er Sinn ergibt, bevor du ihn umsetzt.
  3. Lege die Konstanten (Fragen und Schwellenwerte) an einer einzigen Stelle ab, damit sie leicht zu prüfen sind. Agenten sind nicht gut darin, Fragen zu schreiben, also rechne damit, sie gemeinsam mit ihnen zu bearbeiten.
  4. Nimm Aussagen nicht für bare Münze; ermutige den Agenten, seine Annahmen zu validieren.

Häufige Probleme

Der Agent verwendet den Skill nicht

Rufe mit dem Claude Code-Plugin /typesafe:typesafe-ai auf. Bitte in anderen Agenten darum, „use the TypeSafe skill“ zu verwenden. Lädt er immer noch nicht, prüfe, ob der Installer auf den Agenten abzielte, den du benutzt, und starte den Agenten neu.

Routing funktioniert nicht wie erwartet

Prüfe die Fragen und Schwellenwerte. Möglicherweise sind deine Schwellenwerte zu hoch gesetzt (was falsch-negative Ergebnisse verursacht) oder zu niedrig (was falsch-positive Ergebnisse verursacht). Vielleicht musst du deine Fragen auch spezifischer formulieren.

Du verwendest überall Konfidenz-Schwellenwerte

Wenn es dir nur darum geht, die beste Option zu wählen, brauchst du einfach die Option mit der höchsten Konfidenz zu wählen (statt einen Konfidenz-Schwellenwert zu setzen). Wenn du einen bestimmten statistischen Algorithmus im Sinn hast, solltest du wahrscheinlich Wahrscheinlichkeiten statt Konfidenz verwenden.

TypeSafe-Code ist schwer zu prüfen

Das Wichtigste, was Menschen prüfen sollten, sind die Fragen und alle Schwellenwert-Konstanten, die in deinem TypeSafe-Code verwendet werden. Diese sollten in einer einzigen Code-Datei definiert sein, damit sie leicht zu finden sind, ohne lange suchen zu müssen.

Der Agent erfindet Anfrage- oder Antwortfelder

Ein veralteter Skill kann das verursachen. Aktualisiere ihn mit deiner Installationsmethode oben und versuche es erneut.