Przejdź do treści
Biblioteka skilli
AI i agenci · Budowanie i kod

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.

Licencja
MIT
Ostatnia zmiana repozytorium
28.09.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 28.09.2026, bez odwołań do wycofanych modeli i API.

Licencja

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

  1. Steps
  2. Guardrails
Sekcje z nagłówków SKILL.md, w oryginale · 24 linii, 381 słów
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

RepozytoriumWynikLicencja
Ta strona · Neeeophytee/finding-unknowns-skills100MIT
JPeetz/agent-skills96MIT

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.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.