AL-JANEF/janef-forge / skills/engineering/api-contracts
api-contracts
VerifiedDesign and change REST, GraphQL, RPC, and webhook contracts and the backend services and jobs behind them: validation, authorization scope, error semantics, pagination, idempotency, rate limits, retries, timeouts, versioning, and contract tests. Use for any endpoint, external integration, worker, or queue consumer.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 2.6 KB |
| capability.json | config | 2.2 KB |
capability.json
View on GitHub{
"id": "api-contracts",
"name": "API Contracts & Backend Services",
"version": "2.0.0",
"domain": "engineering",
"description": "Design and change REST, GraphQL, RPC, and webhook contracts and the backend services and jobs behind them: validation, authorization scope, error semantics, pagination, idempotency, rate limits, retries, timeouts, versioning, and contract tests. Use for any endpoint, external integration, worker, or queue consumer.",
"triggers": [
"api",
"apis",
"endpoint",
"endpoints",
"rest",
"restful",
"graphql",
"grpc",
"rpc",
"webhook",
"webhooks",
"openapi",
"swagger",
"request validation",
"response shape",
"pagination",
"paginate",
"idempotency",
"idempotent",
"rate limit",
"rate limiting",
"rate-limit",
"backend",
"backend service",
"server-side",
"worker",
"background job",
"background jobs",
"job queue",
"queue",
"queues",
"cron",
"scheduler",
"external integration",
"third-party api",
"third party api",
"http client",
"retry",
"retries",
"backoff",
"versioning",
"api version",
"breaking change",
"contract",
"contracts",
"payment provider",
"external provider",
"provider integration",
"job",
"jobs",
"nightly job",
"rate limiter",
"token bucket"
],
"negative_triggers": [
"api key",
"api keys",
"api docs",
"api documentation"
],
"risk_level": "medium",
"context_cost": "small",
"requires": [],
"optional_with": [
"database-integrity",
"auth-hardening",
"testing-verification"
],
"conflicts_with": [],
"verification_requirements": [
"contract or integration test for material changes",
"validation, unauthorized, and duplicate/retry paths exercised",
"error responses reviewed for information leakage"
],
"supported_hosts": [
"claude-code",
"codex"
],
"references": [],
"status": "stable",
"responsibilities": [
"api-contract-design",
"backend-service-reliability",
"webhook-handling"
],
"priority": 57,
"provenance": [
"agent-engineering-stack 1.1.0 api-contracts",
"lean-code-engineer 0.1.0 modules/backend"
]
}
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |