agent-interface-design
/agent-interface-design
Projektuje narzędzia, skrypty i CLI wywoływane przez agenta tak, by interfejs sam uczył użycia, np. przy budowie serwera MCP lub gdy agent myli się w używaniu narzędzia.
- Autor
- Neeeophytee ↗
- Repozytorium
- finding-unknowns-skills ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 28.09.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 1
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 28.09.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
Co robi i kiedy
Projektuje narzędzia, skrypty i CLI wywoływane przez agenta tak, by interfejs sam uczył użycia, np. przy budowie serwera MCP lub gdy agent myli się w używaniu narzędzia.
Oryginalny opis (EN)
Design tools, scripts, and CLIs that an agent will call, so the interface teaches its own use instead of a wall of prose and examples. Use when building an MCP server or tool definition, writing an agent-facing script, or when an agent keeps misusing a tool it already has.
Jak działa
- Steps
- Guardrails
Podgląd SKILL.md
--- name: agent-interface-design description: Design tools, scripts, and CLIs that an agent will call, so the interface teaches its own use instead of a wall of prose and examples. Use when building an MCP server or tool definition, writing an agent-facing script, or when an agent keeps misusing a tool it already has. --- # Agent interface design Examples teach one path and quietly fence off the others: shown three ways to call a tool, a model tends to produce those three. A well-designed interface teaches the whole space at once. The parameters say what is possible, the description says what is expected, and there is very little left to write. ## Steps 1. Find out how the tool is actually being misused before redesigning it. Read transcripts, logs, or the user's complaint. Misuse is an interface symptom first and a documentation symptom second, and the fix is usually a rename or a type, not a paragraph. 2. Push meaning into the parameters: - Enumerate instead of accepting free text. A status of `pending | in_progress | completed` teaches the whole state machine without a sentence of prose. - Name for intent rather than implementation, so the right call is the one that reads correctly. - Make invalid states unrepresentable wherever the type system allows it. A parameter that cannot express a mistake needs no warning about that mistake. 3. Put behavioral instruction in the tool's own description, at the point of use, and only there. The same guidance restated in a global preamble is how a codebase grows contradictions. 4. Treat the urge to add a usage example as a diagnostic: it usually means a parameter is underspecified. Fix the interface first. Keep an example only for a format that genuinely cannot be guessed, such as a bespoke query syntax. 5. Decide what is resident and what is discoverable. Tools needed on most turns belong in context; tools needed rarely should be findable on demand so they cost nothing until they're wanted. 6. Finish by naming the mistake the design still permits, and say whether it is cheap enough to live with or needs an explicit guardrail. ## Guardrails - A description that has to explain what a parameter means is a parameter that needs a better name. - Irreversible and high-stakes operations are the exception to all of the above: there, explicit constraint and confirmation beat elegance. - Never redesign a signature without first finding every existing caller. - Terseness is not the goal; expressiveness is. Cutting a description that carried real behavior is a worse outcome than a description that ran long.
Wersje
| Repozytorium | Wynik | Licencja |
|---|---|---|
| Ta strona · Neeeophytee/finding-unknowns-skills | 100 | MIT |
| JPeetz/agent-skills | 96 | MIT |
Identyczna treść występuje jeszcze w 1 innych folderach na GitHubie. Tu pokazujemy jedną, najlepiej ocenioną kopię.
Migawka bazy z 13.11.2026 · wersja paczki 1adc18821bb2 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100agent-tools
Projektuje i przegląda narzędzia wywoływane przez agenta LLM: definicje, schematy JSON, opisy, komunikaty błędów i serwery MCP. - 100mcp-server-development
Projektuje i wdraża serwery MCP oraz narzędzia dla agentów: projekt narzędzi, zmiany specyfikacji, OAuth, bezpieczeństwo i wybór SDK, także przy migracji serwera. - 100agent-toolkit
Znajduje, uruchamia i łączy narzędzia CLI tk zamiast serwera MCP lub jednorazowego skryptu, na przykład do API lub CI. - 100tool-design
Projektuje narzędzia wywoływane przez model: nazwy, kształt parametrów, wynik i komunikaty błędów jako instrukcje do wykonania, a także przegląd cudzych powierzchni narzędzi. - 100tool-design
Pomaga projektować narzędzia agentów, opisy i interfejsy: konsolidacja, redukcja złożoności, nazewnictwo i narzędzia MCP, bez budowy serwerów MCP. - 100tool-design
Pomaga projektować narzędzia agentów i ich opisy oraz redukować złożoność, w tym narzędzia MCP, konsolidację i konwencje nazewnicze.