Zum Inhalt springen

Tool-Design-Skill

Werkzeugschnittstellen mit klaren Eingaben, Ausgaben, Auswahlhinweisen und behebbaren Fehlern entwerfen.

Community · Muratcan Koylan
AutorMuratcan Koylan
LizenzMIT
Quellemuratcankoylan/Agent-Skills-for-Context-Engineering · SKILL.md auf GitHub
Funktioniert inClaude Code · Codex, Gemini CLI, Cursor, Copilot
Aus der Quelle gelesen am

Der Skill tool-design verbessert die Schnittstelle zwischen Agent und aufrufbaren Werkzeugen.

Jedes Werkzeug wird als Vertrag beschrieben: Einsatzzeitpunkt, Eingaben, Ausgaben und Fehlerbehebung. Das Backend implementiert der Skill nicht.

Aus der SKILL.md des Skills: ## Gotchas

Das ist ein Community-Skill von Muratcan Koylan, weder von uns noch von Anthropic geprüft. Skills können den Agenten anweisen, Code auszuführen, Dateien zu lesen oder auf das Netzwerk zuzugreifen. Lies vor der Installation seine SKILL.md und jedes Skript im Ordner und achte auf alles, was nicht zu seiner Beschreibung passt.

Was er macht

  1. Überlappende Namen und unklare Beschreibungen prüfen.
  2. Parameter, Antworten und Fehlerbehebung definieren.
  3. Auswahl und Nutzung des vorgesehenen Werkzeugs testen.

Was du bekommst

  • Werkzeugverträge, überarbeitete Beschreibungen und ein Prüfplan.

Wann er passt

  • Ein Agent wählt falsche Werkzeuge oder liefert wiederholt ungültige Argumente.

Wann er nicht passt

  • Die gesamte Architektur auswählen oder fremde Aufgaben in ein übergroßes Werkzeug pressen.

Was er braucht

  • Ein dateifähiger Agent sowie echte Werkzeugschemata, Verhalten und Fehlerfälle.
  • Der optionale Python-Generator nutzt Vorlagen und heuristische Wertungen; er belegt keine bessere reale Werkzeugauswahl.

Dateien im Skill

Datei oder OrdnerWofür sie da ist
SKILL.mdVertragsgestaltung, Beispiele und typische Entwurfsfehler.
references/best_practices.mdPython-Beschreibungsgenerator und Referenzen zu Entwurf und Konsolidierung.
scripts/description_generator.pyPython-Beschreibungsgenerator und Referenzen zu Entwurf und Konsolidierung.

Lizenz laut Repository am 2026-11-20: MIT.

Beispiel-Prompts

Gib nach der Installation einen dieser Prompts ein; wenn du den Skill beim Namen nennst, wird er sicher verwendet.

  • Überarbeite diesen Vertrag mit klaren Standardwerten und behebbaren Fehlern.
  • Prüfe diese überlappenden Werkzeugnamen vor einer Konsolidierung.
  • Entwirf knappe und ausführliche Antworten für dieselbe Suche.

So installierst du tool-design

Referenzen und Beispiele erhalten

Vollständigen Ordner kopieren. Das Plugin installiert die Sammlung; für einen einzelnen Skill die Ordnerinstallation verwenden.

Anleitung und Python-Vorlagen brauchen keinen externen Dienst. Reale Tests brauchen Agent und Werkzeuge; gehosteter Upload und API-Ausführung sind ungeprüft.

Ein Skill ist ein Ordner mit einer SKILL.md-Datei. Du installierst ihn einmal; der Agent liest zu Beginn jeder Sitzung seine kurze Beschreibung und lädt die vollständigen Anweisungen nur, wenn eine Anfrage dazu passt. Wähle die Umgebung, die du nutzt:

Claude Code: aus dem Plugin-Marketplace

  1. Starte Claude Code in einem Terminal mit claude.
  2. Füge den Marketplace hinzu (einmal pro Computer):
    /plugin marketplace add muratcankoylan/Agent-Skills-for-Context-Engineering
  3. Installiere das Plugin. Claude Code zeigt zuerst seine Details: Prüfe, was es hinzufügt (Skills, Hooks, MCP-Server), und wähle dann, ob es für dich, für alle in diesem Repository oder nur für dich in diesem Repository gilt.
    /plugin install context-engineering@context-engineering-marketplace
  4. Tippe / und suche nach /context-engineering:tool-design, oder bitte einfach um die Aufgabe.

Alternativ aus deiner Shell statt aus einer Sitzung:

claude plugin marketplace add muratcankoylan/Agent-Skills-for-Context-Engineering
claude plugin install context-engineering@context-engineering-marketplace

Das Plugin wird als Ganzes installiert, daher kommen weitere Skills mit, darunter context-fundamentals, context-degradation, context-compression, context-optimization, self-managed-context, multi-agent-patterns, long-horizon-prompting, memory-systems, filesystem-context, hosted-agents, evaluation, advanced-evaluation, harness-engineering, project-development, bdi-mental-states, latent-briefing, self-improvement-loops.

Claude Code: den Ordner in deinen Skills-Ordner kopieren

Lege den Ordner des Skills in ~/.claude/skills/ ab, um ihn in jedem Projekt auf diesem Computer zu nutzen, oder in .claude/skills/ innerhalb eines Repositorys, um ihn mit allen zu teilen, die dort arbeiten (committe ihn).

git clone --depth 1 https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering.git
mkdir -p ~/.claude/skills
cp -R Agent-Skills-for-Context-Engineering/skills/tool-design ~/.claude/skills/

Claude Code erkennt neue oder geänderte Skills in diesen Ordnern noch während der Sitzung. Falls der Skills-Ordner beim Start der Sitzung noch nicht existierte, führe einmal /reload-skills aus. Tippe dann /tool-design oder beschreib einfach die Aufgabe.

Unter Windows führst du die Befehle in Git Bash oder WSL aus oder kopierst den Ordner mit dem Datei-Explorer an dieselbe Stelle.

Codex, Gemini CLI, Cursor und GitHub Copilot

Diese Agenten lesen dieselben SKILL.md-Ordner. Der einzige Projektordner, den alle vier akzeptieren, ist .agents/skills/; daher kopiert dieser Befehl den Skill dorthin:

git clone --depth 1 https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering.git
mkdir -p .agents/skills
cp -R Agent-Skills-for-Context-Engineering/skills/tool-design .agents/skills/
AgentProjektordnerDein BenutzerordnerHinweise
OpenAI Codex
.agents/skills/
~/.agents/skills/
Tippe $ oder führe /skills aus, um einen Skill auszuwählen; Codex wählt auch selbst einen, wenn deine Aufgabe passt.
Gemini CLI
.agents/skills/
.gemini/skills/
~/.agents/skills/
~/.gemini/skills/
Oder installiere ihn mit gemini skills install <git URL> --path <folder> --consent aus Git. Google hat Gemini CLI für Nutzer der kostenlosen Stufe und von Google One am 18. Juni 2026 durch Antigravity CLI ersetzt; Antigravity nutzt .agents/skills/ im Projekt und ~/.gemini/config/skills/ für dich.
Cursor
.agents/skills/
.cursor/skills/
~/.agents/skills/
~/.cursor/skills/
Tippe im Agent-Chat /, um einen Skill auszuwählen. Cursor liest auch die .claude/skills/-Ordner von Claude Code.
GitHub Copilot
.github/skills/
.agents/skills/
.claude/skills/
~/.copilot/skills/
~/.agents/skills/
Funktioniert in Copilot CLI, im Cloud-Agenten und im Agent-Modus in VS Code, Visual Studio und JetBrains (IDE-Unterstützung hängt von der Version ab). Oder führe gh skill install OWNER/REPOSITORY SKILL aus (Public Preview, GitHub CLI 2.90.0 oder neuer).
Installiere nur Skills, denen du vertraust. Anthropic rät, Skills nur aus vertrauenswürdigen Quellen zu verwenden und bei allen anderen Skills vor der Nutzung jede Datei zu lesen: Ein Skill kann den Agenten anweisen, Befehle auszuführen, Dateien zu lesen oder Daten auf eine Weise zu senden, die seine Beschreibung nicht erwähnt.

Quellen für diese Schritte

Am 2026-11-14 mit der Dokumentation des jeweiligen Anbieters abgeglichen:

Ein Vertrag für den nächsten Schritt

Namen und Beschreibungen sollen echte Alternativen unterscheidbar machen. Standardwerte, Eingabegrenzen und Ausgabeformat ausdrücklich nennen.

Je nach Aufgabe knappe oder ausführliche Ausgaben anbieten. Fehler müssen Korrekturen ermöglichen statt blinde Wiederholungen auszulösen.

Konsolidierung an Aufgaben prüfen

Weniger Werkzeuge garantieren keine bessere Leistung. Erfolg, Argumentfehler und Wiederherstellung an denselben Aufgaben vergleichen.

Der Generator entwirft Beschreibungen. Seine Heuristiken prüfen weder Backend und Rechte noch das Verständnis des Agenten.

Fragen zu tool-design

Baut der Skill einen MCP-Server?

Nein. Er hilft beim Vertrag; Transport, Authentifizierung und Backend-Ausführung müssen implementiert werden.

Alle Werkzeuge zusammenlegen?

Nein. Verwandte Aufgaben bei Bedarf bündeln, fremde Operationen trennen und die neue Schnittstelle testen.

Was gehört in eine Fehlerantwort?

Fehlerursache und nötige Eingabe- oder Zustandsänderung vor dem nächsten Versuch, ohne vertrauliche Details.

Messen Beispielwerte die Agent-Leistung?

Nein. Sie prüfen Textmuster und Metadaten. Auswahl und Wiederherstellung mit repräsentativen Läufen testen.

Weitere KI-Skills

Ähnliche Skills

Skill-Kategorien