API Scorecard – Agent Skill (Improvements)¶
The jentic-api-improve agent skill closes the loop on scoring: it raises an OpenAPI document’s JAIRF score with non-breaking improvements and produces an improved spec, a reusable OpenAPI Overlay, and a before/after changelog. Install it through whichever path fits your agent.
jentic-api-improve¶
Scoring tells you what to fix; the jentic-api-improve skill closes the loop and fixes it. Point an AI coding agent at an OpenAPI document and it runs a baseline score, identifies the weak dimensions and the semantic diagnostics, applies non-breaking improvements (adding summary/description/example/tags — never changing existing paths, parameters, or response shapes), and produces three artifacts: an improved spec, an OpenAPI Overlay (the reusable, non-breaking delta), and a changelog with before/after scores.
This skill orchestrates the scorecard CLI plus a few extra command-line tools, so it needs more than the CLI alone. In addition to the scorecard CLI's Requirements (Node.js ≥ 20.19, a running Docker daemon, and a JENTIC_API_KEY for local-file scoring), install:
pipx install jentic-openapi-tools # validation
pipx install jentic-apitools-cli # overlay verification (command: jentic-apitools)
pipx install check-jsonschema # overlay schema validation
# plus python3 and jq, which most systems already have
Install the skill through whichever path fits your agent — the same three channels as the scoring skill:
Claude Code¶
The improve skill is a separate plugin in this repository's marketplace:
/plugin marketplace add jentic/jentic-api-scorecard
/plugin install api-improve@jentic-api-scorecard
Installing the plugin also registers the companion jentic-api-improve subagent (used for multi-iteration improvement loops). Once installed, ask Claude to improve a spec:
> Improve ./openapi.yaml for AI-readiness
> Raise the JAIRF score of my API and give me an overlay
Vercel skills CLI¶
npx skills add jentic/jentic-api-scorecard --skill jentic-api-improve
TanStack Intent¶
The @jentic/api-scorecard-cli npm package ships this skill (and the companion agent definition) inside its published tarball, so it's discoverable by TanStack Intent for projects that already depend on the CLI. The agent file lands at agents/jentic-api-improve.md; copy it into your .claude/agents/ to enable the declarative subagent (optional — the skill falls back to spawning a subagent from an inline brief).
Contact Us