Przejdź do treści
Biblioteka skilli
Programowanie · Nauka i wyjaśnianie

api-design-principles

/api-design-principles

Przekazuje zasady projektowania API REST i GraphQL, które dają intuicyjne, skalowalne i utrzymywalne interfejsy, przy nowych API, przeglądzie specyfikacji i ustalaniu standardów.

Repozytorium
rei-skills ↗
Licencja
MIT
Ostatnia zmiana repozytorium
27.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
6
Skrypty
1
Komentarze HTML
0
Adresy URL w SKILL.md
1
Przestarzałość

Brak sygnałów. Repozytorium zmienione 27.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 sprawdzić przed instalacją
  • 1 skrypt w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.

Skrypty: assets/rest-api-template.py

Co robi i kiedy

Przekazuje zasady projektowania API REST i GraphQL, które dają intuicyjne, skalowalne i utrzymywalne interfejsy, przy nowych API, przeglądzie specyfikacji i ustalaniu standardów.

Oryginalny opis (EN)

Master REST and GraphQL API design principles to build intuitive, scalable, and maintainable APIs that delight developers. Use when designing new APIs, reviewing API specifications, or establishing...

Jak działa

  1. Use this skill when
  2. Do not use this skill when
  3. Instructions
  4. Resources
Sekcje z nagłówków SKILL.md, w oryginale · 39 linii, 192 słów
Podgląd SKILL.md
---
name: api-design-principles
description: "Master REST and GraphQL API design principles to build intuitive, scalable, and maintainable APIs that delight developers. Use when designing new APIs, reviewing API specifications, or establishing..."
risk: unknown
source: rootcastle-rei
---

# API Design Principles

Master REST and GraphQL API design principles to build intuitive, scalable, and maintainable APIs that delight developers and stand the test of time.

## Use this skill when

- Designing new REST or GraphQL APIs
- Refactoring existing APIs for better usability
- Establishing API design standards for your team
- Reviewing API specifications before implementation
- Migrating between API paradigms (REST to GraphQL, etc.)
- Creating developer-friendly API documentation
- Optimizing APIs for specific use cases (mobile, third-party integrations)

## Do not use this skill when

- You only need implementation guidance for a specific framework
- You are doing infrastructure-only work without API contracts
- You cannot change or version public interfaces

## Instructions

1. Define consumers, use cases, and constraints.
2. Choose API style and model resources or types.
3. Specify errors, versioning, pagination, and auth strategy.
4. Validate with examples and review for consistency.

Refer to `resources/implementation-playbook.md` for detailed patterns, checklists, and templates.

## Resources

- `resources/implementation-playbook.md` for detailed patterns, checklists, and templates.

---

> 🏰 **Rei Skills** — Curated by [Rootcastle Engineering & Innovation](https://www.rootcastle.com) | Batuhan Ayrıbaş  
> Engineering Beyond Boundaries | admin@rootcastle.com
Pliki w paczce (6)
  • SKILL.md 2 KB
  • assets/api-design-checklist.md 4 KB
  • assets/rest-api-template.py 5 KB
  • references/graphql-schema-design.md 9 KB
  • references/rest-best-practices.md 7 KB
  • resources/implementation-playbook.md 13 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · rootcastleco/rei-skills100MIT
rmyndharis/antigravity-skills100MIT
wshobson/agents100MIT
secondsky/claude-skills100MIT
aipoch/medical-research-skills100MIT
poly-gents/syncolab-skills100Apache-2.0
coco-research/coco95MIT
HermeticOrmus/LibreUIUX-Claude-Code95MIT
HK-hub/AgentSkills95MIT

Migawka bazy z 13.11.2026 · wersja paczki 89a8fb00e655 (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 odporne i skalowalne API REST i GraphQL, zarówno nowe, jak i ulepszane.
  • 100api-design-expert
    Wspiera projektowanie API na poziomie eksperckim: REST, GraphQL, wersjonowanie i bezpieczeństwo, style API i dokumentacja.
  • 100api-design
    Podaje dobre praktyki projektowania API REST i GraphQL, w tym specyfikacje OpenAPI i dokumentowanie endpointów.
  • 100designing-apis
    Projektuje API REST i GraphQL, w tym endpointy, obsługę błędów, wersjonowanie i dokumentację, oraz ocenia kontrakty API.
  • 100rest-api
    Opisuje zasady projektowania REST API: zasoby, metody i kody statusu, przy projektowaniu lub przeglądzie API.
  • 100design-api
    Projektuje API REST i GraphQL: nazewnictwo, wersjonowanie, kształt błędów i uwierzytelnianie.

Uwagi i zgłoszenia

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