agentsclimarketplace

Api contract review

Skill ldilov/harness-forge/skills/api-contract-review

AI coding agent runtime that makes LLMs understand your codebase with repository-aware context, memory, and continuous learning

Install
npx -y skills add ldilov/harness-forge --skill api-contract-review

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 3 stars3 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

review request, response, event, and schema contracts for compatibility and consumer safety. use when http, openapi, asyncapi, protobuf, json schema, generated clients, or external integration behavior changes.

SKILL.md

2.6 KB, as published. Nobody here has run it

API Contract Review

Trigger Signals

  • the task changes HTTP routes, request or response shapes, headers, auth semantics, examples, or client SDKs
  • the repo edits OpenAPI, AsyncAPI, Protobuf, JSON Schema, or generated contract code
  • a versioning, deprecation, or compatibility question exists across providers and consumers

Inspect First

  • source-of-truth specs and the runtime handlers that implement them
  • schema validators, generated clients, examples, docs, and error-shape helpers
  • versioning and deprecation notes, auth requirements, and pagination or idempotency behavior
  • consumer code, integration tests, and release notes when a public contract changed

Workflow

  1. identify the canonical contract surface and compare it to the implementation
  2. classify the change by protocol: HTTP, event, schema-only, or wire-level
  3. evaluate backward compatibility for required fields, enums, defaults, errors, and behavior semantics
  4. verify examples, validation rules, and generated artifacts stay in sync
  5. emit a consumer-centered review with specific remediation or rollout guidance

Output Contract

  • changed contract summary grouped by endpoint, message, or schema
  • compatibility verdict with the precise breaking edges called out
  • consumer impact notes covering clients, codegen, docs, and deployment sequencing
  • follow-up actions for linting, versioning, deprecation, migration guides, or tests

Failure Modes

  • the runtime contract diverges from the checked-in spec and the source of truth is unclear
  • examples, docs, or generated clients are stale enough that contract behavior cannot be trusted
  • behavior semantics changed without any schema diff to explain it

Escalation

  • escalate when a breaking change lacks versioning, deprecation, or migration guidance
  • escalate when error semantics, auth requirements, or event-delivery guarantees change silently
  • escalate when wire compatibility for protobuf or event consumers is uncertain

References

  • skills/api-contract-review/references/http-contract-checklist.md
  • skills/api-contract-review/references/schema-compatibility.md
  • skills/api-contract-review/references/event-and-async-contracts.md
  • skills/api-contract-review/references/protobuf-and-buf.md
  • skills/api-contract-review/references/style-and-linting.md
  • skills/api-contract-review/references/review-template.md
  • skills/api-contract-review/references/examples.md

Keep looking

Skills are one crate of 328,083. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.