스킬 검색.../

Api Contract Guardian | Skills Pool

스킬 파일

Api Contract Guardian

Prevent breaking API changes for .NET backends consumed by Angular or other clients. Use when changing controllers/endpoints/DTOs, OpenAPI/Swagger, auth requirements, pagination/sorting, or error shapes. Produces compatibility assessment + contract test plan.

praveenspeaks0 스타2026. 2. 25.

직업
카테고리: Backend

스킬 내용

API Contract Guardian (.NET backend, Angular consumer)

When to use

Adding/changing endpoints, routes, query params, headers.
Modifying DTOs (rename/remove fields, type changes, enum changes).
Changing auth requirements (401/403 behavior).
Changing pagination defaults, sorting, filtering behavior.
Changing error shapes (ProblemDetails, validation errors).

Non‑negotiables

Prefer backward compatible changes (additive).
If breaking is required: version, communicate, and add migration steps.
Contract must be testable and documented.

Inputs to gather (ask if missing)

Endpoint(s) impacted and current request/response examples.
Consumer(s): Angular app module/service names, other services.
Current OpenAPI/Swagger location (if used).

관련 스킬

빠른 설치

Api Contract Guardian

npx skills add praveenspeaks/github_skills_starter_pack

Skill 다운로드 저장소 열기

작성자: praveenspeaks
스타: 0
업데이트: 2026. 2. 25.
직업

이 페이지의 내용

01API Contract Guardian (.NET backend, Angular consumer)

Error handling standard (ProblemDetails? custom envelope?).

Procedure

Classify the change
- Additive (safe), behavior change (risky), breaking (requires versioning).
Identify consumers
- Search references in Angular services and other backend clients.
Check breaking patterns
- Removed/renamed fields
- Type narrowing (string -> int, nullable -> non-nullable)
- Enum value removal/renaming
- Route changes
- Status code changes
Define compatibility approach
- Add new fields but keep old; deprecate with warnings.
- Introduce new endpoint version: /v2/... or header-based versioning (per team policy).
Create contract tests
- Minimum:
  - Schema/shape test for response DTO
  - Validation error shape test
  - Auth error shape test
Update docs
- OpenAPI/Swagger annotations or docs page.
Output decision
- Provide explicit “Safe / Risky / Breaking” with required actions.

Output format

Contract impact assessment

Classification: Safe (additive) / Risky / Breaking
Why:
Consumers impacted:
Required actions:

Proposed contract tests

Test type: unit/integration/consumer-driven
Cases:
1. ...
2. ...

Migration notes (if breaking)

Deprecation plan:
Timeline:
Angular changes required:

03Non‑negotiables

04Inputs to gather (ask if missing)

06Output format

07Contract impact assessment

08Proposed contract tests

09Migration notes (if breaking)

소프트웨어 개발자

Xurl

A CLI tool for making authenticated requests to the X (Twitter) API. Use this skill when you need to post tweets, reply, quote, search, read posts, manage followers, send DMs, upload media, or interact with any X API v2 endpoint.

Acp Router

Route plain-language requests for Pi, Claude Code, Codex, Cursor, Copilot, OpenClaw ACP, OpenCode, Gemini CLI, Qwen, Kiro, Kimi, iFlow, Factory Droid, Kilocode, or ACP harness work into either OpenClaw ACP runtime sessions or direct acpx-driven sessions ("telephone game" flow). For coding-agent thread requests, read this skill first, then use only `sessions_spawn` for thread creation.

Coding Standards

TypeScript, JavaScript, React ve Node.js geliştirme için evrensel kodlama standartları, en iyi uygulamalar ve kalıplar.

Api Design

REST API tasarım kalıpları; kaynak isimlendirme, durum kodları, sayfalama, filtreleme, hata yanıtları, versiyonlama ve üretim API'leri için hız sınırlama içerir.

Mcp Server Patterns

Build MCP servers with Node/TypeScript SDK — tools, resources, prompts, Zod validation, stdio vs Streamable HTTP. Use Context7 or official MCP docs for latest API.

Backend Patterns

Node.js, Express ve Next.js API routes için backend mimari kalıpları, API tasarımı, veritabanı optimizasyonu ve sunucu tarafı en iyi uygulamalar.

소프트웨어 개발자