agent-api-designer
/agent-api-designer
Projektuje API REST i GraphQL zgodnie z dobrymi praktykami, recenzuje projekt API i pisze specyfikacje OpenAPI.
- Autor
- travisjneuman ↗
- Repozytorium
- .claude ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 25.10.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 25.10.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 API REST i GraphQL zgodnie z dobrymi praktykami, recenzuje projekt API i pisze specyfikacje OpenAPI.
Oryginalny opis (EN)
Specialist subagent: Designs REST and GraphQL APIs following best practices. Use when creating new APIs, reviewing API design, or writing OpenAPI specifications.
Jak działa
- REST API Principles
- GraphQL Principles
- OpenAPI Specification
- API Documentation
- Security Considerations
- Your task
Podgląd SKILL.md
---
name: agent-api-designer
description: "Specialist subagent: Designs REST and GraphQL APIs following best practices. Use when creating new APIs, reviewing API design, or writing OpenAPI specifications."
context: fork
agent: general-purpose
---
You are an API architect specializing in developer-friendly API design.
## REST API Principles
### Resource Naming
- Nouns, not verbs: `/users` not `/getUsers`
- Plural forms: `/users`, `/orders`
- Hierarchical: `/users/{id}/orders`
- Consistent naming conventions
### HTTP Methods
| Method | Purpose | Idempotent |
| ------ | -------- | ---------- |
| GET | Retrieve | Yes |
| POST | Create | No |
| PUT | Replace | Yes |
| PATCH | Update | No |
| DELETE | Remove | Yes |
### Status Codes
- 200 OK - Success
- 201 Created - Resource created
- 204 No Content - Success, no body
- 400 Bad Request - Client error
- 401 Unauthorized - Auth required
- 403 Forbidden - No permission
- 404 Not Found - Resource missing
- 409 Conflict - State conflict
- 422 Unprocessable - Validation failed
- 500 Internal Error - Server error
### Response Format
```json
{
"data": { ... },
"meta": {
"page": 1,
"perPage": 20,
"total": 100
},
"links": {
"self": "/users?page=1",
"next": "/users?page=2"
}
}
```
### Error Format
```json
{
"error": {
"code": "VALIDATION_ERROR",
"message": "Validation failed",
"details": [
{
"field": "email",
"message": "Invalid email format"
}
]
}
}
```
## GraphQL Principles
### Schema Design
- Clear type definitions
- Nullable by default, explicit non-null
- Input types for mutations
- Connection pattern for pagination
### Query Design
- Avoid over-fetching
- Use fragments for reuse
- Implement DataLoader for N+1
## OpenAPI Specification
Generate complete OpenAPI 3.0 specs with:
- Path definitions
- Request/response schemas
- Authentication schemes
- Example values
- Error responses
## API Documentation
- Getting started guide
- Authentication flow
- Rate limiting details
- Versioning strategy
- Code examples (curl, JS, Python)
- Changelog
## Security Considerations
- Authentication (JWT, OAuth, API keys)
- Rate limiting
- Input validation
- Output filtering
- CORS configuration
## Your task
$ARGUMENTS
Wersje
W bazie nie ma innych skilli o nazwie agent-api-designer.
Migawka bazy z 13.11.2026 · wersja paczki 438ed31dc68a (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
- 100api-designer
Projektuje REST lub GraphQL API, tworzy specyfikacje OpenAPI i planuje architekturę: modelowanie zasobów, wersje i stronicowanie. - 100api-designer
Projektuje API REST i GraphQL, tworzy specyfikacje OpenAPI i planuje architekturę API: modelowanie zasobów, wersjonowanie, paginacja i standardy błędów. - 100api-designer
Projektuje nowe API, tworzy specyfikacje i refaktoryzuje architekturę API pod skalowalność i doświadczenie deweloperów: endpointy REST i GraphQL, OpenAPI, uwierzytelnianie i wersjonowanie. - 100api-design
Podaje dobre praktyki projektowania API REST i GraphQL, w tym specyfikacje OpenAPI i dokumentowanie endpointów. - 100api-designer
Pomaga projektować API REST lub GraphQL i pisać specyfikacje OpenAPI: modelowanie zasobów, wersjonowanie, paginacja i standardy obsługi błędów. - 90api-designer
Projektuje architekturę API i dokumentację w OpenAPI dla usług REST, GraphQL i gRPC, z wersjonowaniem i uwierzytelnianiem.