Przejdź do treści
Biblioteka skilli
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.

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

  1. Goal
  2. Steps
  3. 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

RepozytoriumWynikLicencja
Ta strona · andreibesleaga/gabbe100CC-BY-4.0
tibursocampos/agent-dev-toolkit100MIT

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.

Uwagi i zgłoszenia

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