Tool-Design-Skill
Werkzeugschnittstellen mit klaren Eingaben, Ausgaben, Auswahlhinweisen und behebbaren Fehlern entwerfen.
Community · Muratcan Koylan| Autor | Muratcan Koylan |
|---|---|
| Lizenz | MIT |
| Quelle | muratcankoylan/Agent-Skills-for-Context-Engineering · SKILL.md auf GitHub |
| Funktioniert in | Claude 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
Was er macht
- Überlappende Namen und unklare Beschreibungen prüfen.
- Parameter, Antworten und Fehlerbehebung definieren.
- 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 Ordner | Wofür sie da ist |
|---|---|
SKILL.md | Vertragsgestaltung, Beispiele und typische Entwurfsfehler. |
references/best_practices.md | Python-Beschreibungsgenerator und Referenzen zu Entwurf und Konsolidierung. |
scripts/description_generator.py | Python-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
- Starte Claude Code in einem Terminal mit
claude. - Füge den Marketplace hinzu (einmal pro Computer):
/plugin marketplace add muratcankoylan/Agent-Skills-for-Context-Engineering - 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 - 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-marketplaceDas 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/| Agent | Projektordner | Dein Benutzerordner | Hinweise |
|---|---|---|---|
| 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). |
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
Dev-Browser-Skill
Community · Sawyer HoodChrome mit dauerhaften benannten Seiten, Puppeteer-Skripten und lokalem Kommandozeilendienst automatisieren.Agent-Evaluation-Skill
Community · Muratcan KoylanRegressionen mit deterministischen Prüfungen, getrennten Qualitätsdimensionen und versionierten Referenzen planen.Context-Degradation-Skill
Community · Muratcan KoylanFehler langer Kontexte diagnostizieren und Wiederherstellung anhand belegter Fakten und aufgabenspezifischer Vergleiche planen.Advanced-Evaluation-Skill
Community · Muratcan KoylanLLM-Richter mit belegbasierten Rastern, vertauschten Paarvergleichen und menschlicher Kalibrierung entwerfen.Brainstorming-Skill
Community · Jesse Vincent / Prime RadiantEntwickle eine erste Idee vor dem Programmieren zum abgestimmten Entwurf.Writing-Plans-Skill
Community · Jesse Vincent / Prime RadiantMache aus einem freigegebenen Entwurf prüfbare Aufgaben mit Schnittstellen und Verifikation.