📦

tool-design

Name: tool-design
Author: muratcankoylan

Inhaltsrevision r2 Sicher ⚡ Enthält Skripte⚙️ Externe Befehle🌐 Netzwerkzugriff

Agent-Tools entwickeln, die Modelle zuverlässig nutzen

Agent-Tools scheitern, wenn Beschreibungen, Schemas und Fehlermeldungen mehrdeutig sind. Diese Skill bietet praktische Muster für klarere Tool-APIs, sicherere Konsolidierung und bessere Tests.

Unterstützt: Claude Codex Code(CC)

🥈 80 Silber

Mit meinem Agent installieren

Kopieren Sie diese Anfrage in Ihren Agent. Sie enthält die maßgebliche Skill-Seite und das Manifest.

Agent-Anfrage

Review the Skillstore skill "tool-design" from https://skillstore.io/skills/muratcankoylan-tool-design.md and its manifest at https://skillstore.io/api/skills/muratcankoylan-tool-design/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.

Ihr Agent sollte weiterhin seinen Plan anzeigen und alle von der Sicherheitsrichtlinie verlangten Bestätigungen anfordern.

Agent-lesbare Ressourcen

Verwenden Sie diese Links, wenn ein KI-Agent, Crawler oder Skript sauberen Kontext benötigt, statt die vollständige Seite zu lesen.

Markdown-Detailseite GET /skills/muratcankoylan-tool-design.md Signiertes manifest GET /api/skills/muratcankoylan-tool-design/manifest Signiertes lockfile GET /api/skills/muratcankoylan-tool-design/lockfile

Testen

„tool-design“ wird verwendet. Ein Support-Agent hat separate Tools zum Finden von Kunden, Auflisten von Bestellungen und Ausstellen von Rückerstattungen.

Erwartetes Ergebnis:

Kunden- und Bestellabfrage kombinieren, wenn sie einem einzigen Support-Workflow dienen.
Rückerstattungsautorisierung getrennt halten, weil sie den Kontostatus ändert.
Die Übergabe von Abfrageergebnissen zur Rückerstattungsprüfung dokumentieren.

„tool-design“ wird verwendet. Ein Datenbankabfrage-Tool gibt große Datensätze und generische Fehler zurück.

Erwartetes Ergebnis:

Knappe und detaillierte Antwortmodi für unterschiedliche Aufgabenanforderungen hinzufügen.
Generische Fehler durch spezifische Ursachen und Hinweise zum erneuten Versuch ersetzen.
Beispiele für gültige Identifikatoren und erwartete Ergebnisse einschließen.

„tool-design“ wird verwendet. Eine MCP-Integration hat mehrdeutige Tool-Namen über mehrere Server hinweg.

Erwartetes Ergebnis:

Serverbezogene Namen in Prompts und Dokumentation verwenden.
Verwandte Tools unter klaren Namespaces gruppieren.
Beispiele hinzufügen, die das beabsichtigte Tool für jeden Workflow zeigen.

Sicherheitsaudit

Sicher

v8 • 9.8.2026 Versionsbericht öffnen

All 49 static findings are false positives from documentation markup, ordinary prose, or sandboxed command examples. The Python utility performs no network or process execution.

Gescannte Dateien

1,214

Analysierte Zeilen

Prüfelemente

Falschmeldungen ignoriert

Risikofaktoren

⚡ Enthält Skripte (2)

references/architectural_reduction.md:48 references/architectural_reduction.md:124

⚙️ Externe Befehle (35)

🌐 Netzwerkzugriff (3)

references/best_practices.md:7 SKILL.md:40 SKILL.md:93

Das letzte abgeschlossene statische und semantische Audit erkannte keine bestätigten Sicherheitsbefunde. Dies beweist nicht, dass der Skill keine Nebenwirkungen hat.

Geprüft von: codex Audit-Verlauf anzeigen →

Diesen Bericht teilen & zitieren

Teile den versionierten Bewertungsbericht, das neutrale Badge, die Einbettungskarte und Zitate. Skillstore berichtet Nachweise, ohne zu entscheiden, ob dieser Skill sicher ist.

Versionsbericht öffnen

Berichtslink kopieren

https://skillstore.io/skills/muratcankoylan-tool-design/audits/8?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

Markdown-Badge

[![Skillstore security assessment](https://skillstore.io/badges/skills/muratcankoylan-tool-design/security.svg)](https://skillstore.io/skills/muratcankoylan-tool-design?utm_source=security_passport_badge)

HTML-Badge

<a href="https://skillstore.io/skills/muratcankoylan-tool-design?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/muratcankoylan-tool-design/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

Einbettungskarte

<iframe src="https://skillstore.io/embed/skills/muratcankoylan-tool-design.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>

Wissenschaftliche Zitate (APA · BibTeX · CFF)

APA-Zitat

muratcankoylan. (2026). tool-design security audit report (audit version 8) [Author version unspecified]. Skillstore. https://skillstore.io/skills/muratcankoylan-tool-design/audits/8

BibTeX-Zitat

@techreport{muratcankoylan-muratcankoylan-tool-design-2026,
  author = {muratcankoylan},
  title = {tool-design security audit report (audit version 8)},
  institution = {Skillstore},
  year = {2026},
  number = {8},
  url = {https://skillstore.io/skills/muratcankoylan-tool-design/audits/8},
  note = {Author version unspecified}
}

CITATION.cff

cff-version: 1.2.0
message: "If you use this Skill, cite its author and this versioned security audit report."
title: "tool-design security audit report (audit version 8)"
version: "unspecified"
type: report
authors:
  - name: "muratcankoylan"
date-released: "2026-08-09"
url: "https://skillstore.io/skills/muratcankoylan-tool-design/audits/8"
identifiers:
  - type: other
    value: "skillstore:muratcankoylan-tool-design:audit:8"
    description: "Skillstore immutable audit report identifier"

Varianten vergleichen

4 installierbare Varianten

Jeder Autor bleibt ein eigener installierbarer Skill. Die empfohlene Variante wird nach Skillstore-Nachweisen bewertet.

Warum diese Variante zuerst steht

Höchster Skillstore-Score

Autor / Quelle Skillstore-Score Evidenzvertrauen Skillstore-Nutzung Aktualisiert

Asmayaseen Empfohlen

asmayaseen-tool-design

Skillstore-Score 81

Evidenzvertrauen Hoch

Skillstore-Nutzung 23

Aktualisiert

2026-09-09

ChakshuGautam

chakshugautam-tool-design

Skillstore-Score 80

Evidenzvertrauen Hoch

Skillstore-Nutzung 16

Aktualisiert

2026-09-09

muratcankoylan Aktuell

muratcankoylan-tool-design

Skillstore-Score 80

Evidenzvertrauen Hoch

Skillstore-Nutzung 15

Aktualisiert

2026-09-09

sickn33

sickn33-tool-design

Skillstore-Score 78

Evidenzvertrauen Hoch

Skillstore-Nutzung 68

Aktualisiert

2026-09-09

Skillstore-Score

Warum dieser Score Evidenzvertrauen: Hoch

Architektur

Wartbarkeit

Inhalt

Gemeinschaft

Spezifikationskonformität

Was Sie erstellen können

Agent-Tool-APIs standardisieren

Namens-, Parameter- und Antwortkonventionen für einen gemeinsamen Tool-Katalog definieren.

Verwirrung bei der Tool-Auswahl reduzieren

Überlappende Tools identifizieren und Workflows konsolidieren, die Auswahlfehler verursachen.

Wiederherstellung nach Tool-Fehlern verbessern

Fehler so umschreiben, dass Agents wissen, was fehlgeschlagen ist und wie sie es erneut versuchen können.

Diese Prompts ausprobieren

Eine Tool-Beschreibung prüfen

Prüfe diese Tool-Beschreibung auf Klarheit, fehlende Eingaben, Rückgaben und Fehlerhinweise. Schlage knappe Verbesserungen vor: [paste tool description].

Einen Tool-Vertrag erstellen

Entwirf einen Tool-Vertrag für diesen Workflow. Enthalten sein sollen Name, wann es verwendet wird, Parameter, Rückgabeform und behebbare Fehler: [describe workflow].

Ein Tool-Set konsolidieren

Analysiere diese Tools auf Überschneidungen und Auswahlmehrdeutigkeit. Empfiehl, welche Tools zusammengeführt, getrennt beibehalten oder per Namespace organisiert werden sollten: [paste tool list].

Ein Tool-System entwerfen und testen

Erstelle einen Tool-Designplan für dieses Agent-System. Enthalten sein sollen Tool-Grenzen, MCP-Namensgebung, Antwortformate, Fehlerbehebung, Testfälle und Deployment-Risiken: [describe system].

Bewährte Praktiken

Dokumentieren, was das Tool tut, wann es verwendet wird, welche Eingaben erwartet werden, welche Daten zurückgegeben werden und welche Fehler behebbar sind.
Tools nur konsolidieren, wenn sie einen klaren Workflow unterstützen und keine wichtigen Sicherheitsgrenzen verbergen.
Beschreibungen mit repräsentativen Agent-Anfragen testen und anhand beobachteter Fehlermuster überarbeiten.

Vermeiden

Vage Namen oder Beschreibungen verwenden, die den Agent zwingen, den Zweck des Tools zu erraten.
Nicht verwandte Tools nur zusammenführen, um die Tool-Anzahl zu reduzieren.
Standardmäßig ausführliche Daten zurückgeben, wenn ein knappes Format die Aufgabe beantworten würde.