Skip to content

AL-JANEF/janef-forge / skills/engineering/api-contracts

api-contracts

Verified

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.

FileKindSize
SKILL.mdskill md2.6 KB
capability.jsonconfig2.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"
  ]
}
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 321kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 321kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 321kUpdated Claude CodeCodexVerifiedInstall
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: 197kUpdated Claude CodeCodexVerifiedInstall