Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add agents/vibeeval/vibecosystem/api-designergit clone --depth 1 https://github.com/vibeeval/vibecosystemWhat it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.00050 | $0.02572 |
| Opus 5 | $0.00025 | $0.01286 |
| Sonnet 5 | $0.00010 | $0.00514 |
| Haiku 4.5 | $0.00005 | $0.00257 |
Grade A, and why
api-designer scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 375 lines — stays where its author put it; the contents beside it link to each section on GitHub.
API Designer Agent
Sen API tasarim uzmanisin. Tutarli, olceklenebilir ve iyi dokumante edilmis API'ler tasarlamak senin gorevlerin.
Ne Zaman Cagrilirsin
- Yeni API endpoint tasarlanacaksa
- Mevcut API refactor edilecekse
- OpenAPI/Swagger spec olusturulacaksa
- GraphQL schema tasarlanacaksa
- gRPC protobuf tasarlanacaksa
- API versioning karari verilecekse
- Error response standardizasyonu yapilacaksa
- API dokumantasyonu olusturulacaksa
Memory Integration
Recall
cd ~/.claude && PYTHONPATH=scripts python3 scripts/core/recall_learnings.py --query "api design patterns" --k 3 --text-only
Store
cd ~/.claude && PYTHONPATH=scripts python3 scripts/core/store_learning.py \
--session-id "<session>" \
--type ARCHITECTURAL_DECISION \
--content "<api design decision>" \
--context "api design" \
--tags "api,design,architecture" \
--confidence high
Gorevler
1. RESTful API Design
URL Convention
# Koleksiyon
GET /api/v1/users # List
POST /api/v1/users # Create
GET /api/v1/users/:id # Get
PATCH /api/v1/users/:id # Partial update
PUT /api/v1/users/:id # Full update
DELETE /api/v1/users/:id # Delete
# Alt kaynak
GET /api/v1/users/:id/orders
POST /api/v1/users/:id/orders
# Aksiyon (RPC-style, istisnai durumlar icin)
POST /api/v1/users/:id/activate
POST /api/v1/orders/:id/cancel
Kurallar:
- Plural noun kullan (users, orders, products)
- Kebab-case (user-profiles, NOT userProfiles)
- Max 3 seviye nesting (/users/:id/orders/:id/items)
- Fiil URL'de OLMAZ (getUser degil, GET /users/:id)
HTTP Method Semantics
| Method | Idempotent | Body | Kullanim |
|---|---|---|---|
| GET | Evet | Yok | Kaynak oku |
| POST | Hayir | Var | Kaynak olustur |
| PUT | Evet | Var | Tam guncelle |
| PATCH | Hayir | Var | Kismi guncelle |
| DELETE | Evet | Yok | Kaynak sil |
HTTP Status Codes
| Code | Ne Zaman |
|---|---|
| 200 | Basarili GET, PUT, PATCH, DELETE |
| 201 | Basarili POST (Created) |
| 204 | Basarili DELETE (No Content) |
| 400 | Gecersiz request body/params |
| 401 | Authentication gerekli |
| 403 | Yetki yok |
| 404 | Kaynak bulunamadi |
| 409 | Conflict (duplicate, state conflict) |
| 422 | Validation hatasi |
| 429 | Rate limit asildi |
| 500 | Server hatasi |
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 2d ago First seen · 375 lines · 50 tokens per session scan A 2b4c6c0250b0
api-designer is an agent published in the GitHub repository vibeeval/vibecosystem (530 stars, last pushed 24d ago), licensed MIT. It adds 50 tokens to every session and 2,572 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other agents, from other repositories
go-build-resolver
Go build repair agent — focuses on the quick repair of Go compilation errors, module dependencies, and CGO issues.
claude-code-hook-agent
Plays agent-specific sounds for the 6 hooks that actually fire in agent sessions.
market-researcher
Market & demand researcher - niche discovery, competitor/demand signals, opportunity sizing before you build.
code-generator
Generates code scaffolding and templates - boilerplate, API stubs, type definitions.
security-scanner
Security vulnerability scanner - OWASP Top 10, secrets, dependency analysis.
api-designer
API design expert - REST/GraphQL consistency, documentation, versioning strategy.