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

agent-api-designer

/agent-api-designer

Projektuje API REST i GraphQL zgodnie z dobrymi praktykami, recenzuje projekt API i pisze specyfikacje OpenAPI.

Repozytorium
.claude ↗
Licencja
MIT
Ostatnia zmiana repozytorium
25.10.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 25.10.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 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

  1. REST API Principles
  2. GraphQL Principles
  3. OpenAPI Specification
  4. API Documentation
  5. Security Considerations
  6. Your task
Sekcje z nagłówków SKILL.md, w oryginale · 114 linii, 324 słów
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.

Uwagi i zgłoszenia

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