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

api-design-engineering

/api-design-engineering

Projektuje, przegląda i naprawia kontrakty API oraz komunikację usług, w tym autoryzację, kompatybilność i niezawodność.

Licencja
MIT
Ostatnia zmiana repozytorium
30.10.2026

Ocena i bezpieczeństwo

85/ 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ść20 / 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
8
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 30.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, przegląda i naprawia kontrakty API oraz komunikację usług, w tym autoryzację, kompatybilność i niezawodność.

Oryginalny opis (EN)

Design, review, implement, or troubleshoot API contracts and service communication, including authorization, compatibility, and reliability. Use for endpoint or integration engineering; skip backend work that does not affect an API boundary.

Jak działa

  1. Establish the decision context
  2. Load only useful guidance
  3. Make the contract and implementation agree
  4. Verify the consumer outcome
Sekcje z nagłówków SKILL.md, w oryginale · 45 linii, 780 słów
Podgląd SKILL.md
---
name: api-design-engineering
description: Design, review, implement, or troubleshoot API contracts and service communication, including authorization, compatibility, and reliability. Use for endpoint or integration engineering; skip backend work that does not affect an API boundary.
---

# API Design & Engineering

Deliver a contract consumers can use correctly and an implementation whose security, consistency, and failure behavior match that contract. Scale the work to the requested change and its consequences. Explicit user requirements take precedence over this skill's defaults.

## Establish the decision context

Identify whether the request is a new design, extension, review, targeted repair, performance investigation, migration, or communication-style decision. For a repair, follow the failing request through the affected layers; do not turn it into a general redesign.

Inspect the relevant instructions, routes/resolvers/RPC definitions, schemas, middleware, authorization, data operations, tests, and actual consumers. Check dependency and tool versions before relying on framework behavior. Read enough to establish the boundary, rather than surveying the whole repository by default. With no repository, give a concrete design using stated assumptions; do not invent existing components.

Establish the facts that affect the decision: consumer ownership and upgrade control (including mobile/offline clients), trust and tenant boundaries, sensitive side effects, consistency needs, expected workload, latency budget, and deployment constraints. Infer from evidence where possible; ask only for unresolved facts that materially change correctness or compatibility. Continue independent work while those answers are pending.

For nontrivial decisions, briefly state the root problem, the required invariant, and the selected approach with its main tradeoff. Distinguish observed facts, assumptions, and proposed behavior. Prefer a sound existing pattern. A new protocol, gateway, version, queue, cache, service, middleware layer, or dependency needs a concrete benefit that outweighs its operating and migration costs.

## Load only useful guidance

Choose references by the question being answered; do not read the entire bundle for every endpoint.

| Current decision | Read |
| --- | --- |
| HTTP methods, schemas, errors, lists, OpenAPI, consumer compatibility, deprecation | [Contracts and evolution](references/contracts.md) |
| Identity, permissions, tenant isolation, credentials, browser boundaries, untrusted input or destinations | [Security boundaries](references/security.md) |
| Duplicate effects, races, dependency failures, async acceptance, latency, caching, operational verification | [Reliability and performance](references/reliability.md) |
| Choosing communication style; GraphQL, gRPC, webhooks, events, streaming | [Protocols and integrations](references/protocols.md) |
| Verifying a standard, version, draft status, or a disputed recommendation | [Source register](references/sources.md) |

Before a major architecture/security/reliability decision or use of unfamiliar or evolving technology, verify the applicable official specification and the installed implementation's documentation. Follow the relevant links, check status/errata and tooling support, and research the uncertain point instead of conducting a broad survey every time. The references are a dated synthesis, not a substitute for current project evidence. If browsing is unavailable, disclose what remains unverified and avoid asserting a current version or draft as settled fact.

## Make the contract and implementation agree

For the affected operation, settle the observable behavior: inputs and limits, identity and permissions, outputs and errors, state transition, and retry/concurrency behavior. Include only dimensions that matter to this task. Preserve names, response shapes, status behavior, defaults, and client expectations unless changing them is necessary; an aesthetic preference is not a migration justification.

Use existing handlers, validators, persistence primitives, instrumentation, and test tools where they satisfy the invariants. Enforce access and tenant scope on every data path, including batches, async results, and caches. Put duplicate prevention and concurrent-state protection at the authoritative shared boundary; a process-local check or a transaction alone does not establish either guarantee. A timeout or cancellation does not prove a remote mutation failed.

For a design request, produce an implementable contract and explain consequential failure cases. For an implementation request, carry the focused change through the relevant contract, code, consumers/docs, and verification within the authorized scope. For a review, lead with actionable findings tied to code/contract evidence, impact, and a practical correction; distinguish confirmed defects from questions.

## Verify the consumer outcome

Choose tests from the actual risks. Alongside the ordinary request, exercise relevant permission boundaries, malformed/oversized inputs, duplicate or concurrent requests, lost responses, dependency failures, and older consumers. Use real database semantics for concurrency claims where practical; mock success does not prove atomicity. Verify negative cases leave no unauthorized side effects. Check a failed mutation's state as well as its status code.

Run the project's relevant tests, contract/schema checks, client generation/type checks, and builds when affected. Measure performance claims against a representative workload. Prefer focused regression coverage and existing tools over building a new validation framework. Contract validation cannot establish authorization or distributed-system correctness.

Finish the authorized work once meaningful checks pass; expand testing when a failure, new change, or unresolved risk warrants it. Report the decision, changes or findings, compatibility/rollout implications, executed evidence, and genuine residual uncertainty. Keep proposed tests distinct from tests actually run. For a public or independently deployed consumer change, include a viable migration and recovery path before calling it ready.
Pliki w paczce (8)
  • LICENSE 1 KB
  • SKILL.md 6 KB
  • agents/openai.yaml 1 KB
  • references/contracts.md 8 KB
  • references/protocols.md 6 KB
  • references/reliability.md 8 KB
  • references/security.md 7 KB
  • references/sources.md 9 KB

Wersje

W bazie nie ma innych skilli o nazwie api-design-engineering.

Migawka bazy z 13.11.2026 · wersja paczki 6acc52afbf4d (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-design
    Projektuje, dokumentuje i przegląda kontrakty HTTP, RPC, webhooków i zdarzeń: integracje, zmiany schematu, wersje i autoryzację.
  • 90backend-engineering
    Projektuje, buduje lub sprawdza zachowanie backendu: trasy API, logikę domenową, zapis danych, uwierzytelnianie i zadania w tle.
  • 95wicked-garden-engineering-integration
    Projektuje kontrakty API, granice usług i wzorce integracji między komponentami, w tym REST, GraphQL i zdarzenia.
  • 90bec-api-design
    Projektuje lub przegląda semantykę API usług: żądania, odpowiedzi, stronicowanie, idempotencję i kontrakty błędów.
  • 90uds-backend
    Pomaga zmieniać operacje biznesowe po stronie serwera, API HTTP, integracje, autoryzację i niezawodność backendu.
  • 100flutter-app-engineering
    Buduje, przegląda i ulepsza aplikacje Flutter: stan, nawigację, sesje, integrację natywną i niezawodność wydań.

Uwagi i zgłoszenia

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