Programowanie · Przegląd i audyt
api-standards
/api-standards
Egzekwuje standardy projektowania i nadzoru nad API REST i GraphQL: projekt API, przegląd standardów i governance.
- Autor
- andreibesleaga ↗
- Repozytorium
- gabbe ↗
- Licencja
- CC-BY-4.0
- Ostatnia zmiana repozytorium
- 24.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
- 2
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Przestarzałość
Brak sygnałów. Repozytorium zmienione 24.10.2026, bez odwołań do wycofanych modeli i API.
Licencja
CC-BY-4.0, otwarta.
Co robi i kiedy
Egzekwuje standardy projektowania i nadzoru nad API REST i GraphQL: projekt API, przegląd standardów i governance.
Oryginalny opis (EN)
Enforce REST/GraphQL API design and governance standards. Use when: design api, review api standards, enforce api governance.
Jak działa
- Goal
- Steps
- Security & Guardrails
Sekcje z nagłówków SKILL.md, w oryginale · 25 linii, 208 słów
Podgląd SKILL.md
--- name: api-standards description: "Enforce REST/GraphQL API design and governance standards. Use when: design api, review api standards, enforce api governance." license: CC-BY-SA-4.0 metadata: source: "agents/skills/architecture/api-standards.skill.md" tags: "architecture" core: "false" context_cost: "medium" --- # api-standards ## Goal Design, enforce, and validate enterprise API standards (REST, GraphQL, gRPC), ensuring consistent versioning, pagination, and error handling. ## Steps 1. **Analyze Schema**: Review existing OpenAPI/GraphQL schemas. 2. **Apply Standards**: Enforce naming conventions, HTTP status codes, and hypermedia (HATEOAS) links if required. 3. **Verify Governance**: Ensure backwards compatibility via standard versioning rules (e.g., URI versioning or header versioning). 4. **Output**: Generate or update the `INTEGRATION_SPEC_TEMPLATE.md` with explicit payload examples. ## Security & Guardrails ### 1. Skill Security - **Schema Poisoning**: Validate all external API specs (Swagger/OpenAPI files) against strict parsers before digesting them into context. - **Resource Exhaustion**: Cap the size of API spec files the agent is allowed to process to prevent out-of-memory crashes. ### 2. System Integration Security - **Auth Enforcement**: Every designed endpoint *must* explicitly define its Authentication (e.g., JWT) and Authorization (RBAC/ABAC) schemes. - **Data Exposure**: Prevent the accidental inclusion of internal database IDs or PII fields in public API response schemas. ### 3. LLM & Agent Guardrails - **Hallucinated Endpoints**: The LLM must not invent API endpoints for third-party services that don't exist in the official documentation. - **Protocol Downgrade**: If asked to "simplify" security, the LLM must refuse to transition from secure protocols (HTTPS/OAuth2) to insecure ones (HTTP/Basic Auth).
Pliki w paczce (2)
- INTEGRATION_SPEC_TEMPLATE.md 1 KB
- SKILL.md 2 KB
Wersje
| Repozytorium | Wynik | Licencja |
|---|---|---|
| Ta strona · andreibesleaga/gabbe | 100 | CC-BY-4.0 |
| tibursocampos/agent-dev-toolkit | 100 | MIT |
Migawka bazy z 13.11.2026 · wersja paczki c5850cc1010c (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
- 95api-design-principles
Pomaga projektować nowe API REST lub GraphQL, recenzować specyfikację przed implementacją, ustalać standardy zespołu i migrować z REST do GraphQL. - 100api-design-principles
Uczy zasad projektowania API REST i GraphQL tak, by były intuicyjne, skalowalne i utrzymywalne: nowe API, przegląd specyfikacji i standardy projektowe. - 100design-api
Projektuje API REST i GraphQL: nazewnictwo, wersjonowanie, kształt błędów i uwierzytelnianie. - 90api-design-principles
Podpowiada zasady projektowania API REST i GraphQL: intuicyjność, rozszerzalność, łatwość utrzymania i standardy zespołu. - 100create-api-design
Projektuje API REST lub GraphQL na podstawie specyfikacji funkcji: endpointy, kontrakt API i zasoby. - 100api-design
Podaje dobre praktyki projektowania API REST i GraphQL, w tym specyfikacje OpenAPI i dokumentowanie endpointów.