---
canonical: https://docs.jentic.com/cli/api-scorecard-skill/
representation: markdown-alternate
# Canonical page: https://docs.jentic.com/cli/api-scorecard-skill/
# This is the Markdown alternate of the page above.
---

<!-- Auto-generated from README.md via scripts/extract-docs.js. Do not edit manually. -->

# API Scorecard – Agent Skill (Scoring)

The `jentic-api-scorecard` **agent skill** teaches AI coding agents how to use the scoring CLI correctly — installing it, scoring files and URLs, producing JSON/HTML reports, wiring it into CI, and interpreting exit codes. Install it through whichever path fits your agent.

---

## jentic-api-scorecard

A versioned [agent skill](https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md)
that teaches AI coding agents how to use the CLI correctly — installing it, scoring
files and URLs, producing JSON/HTML, wiring it into CI, enabling LLM analysis, and
interpreting exit codes.

### Claude Code

[Claude Code](https://docs.claude.com/en/docs/claude-code/overview) users install it
as a [plugin](https://docs.claude.com/en/docs/claude-code/plugins) — this repository
doubles as a plugin marketplace:

```
/plugin marketplace add jentic/jentic-api-scorecard
/plugin install api-scorecard@jentic-api-scorecard
```

The `install` argument is `<plugin>@<marketplace>`: the marketplace is always
`jentic-api-scorecard`, and the part before the `@` is the plugin name — `api-scorecard`
here, or `api-improve` for the [improve skill](./api-improve-skill.md#jentic-api-improve).

Once installed, the skill loads automatically when you ask Claude to score an OpenAPI document —
no explicit invocation needed:

```
> Score ./openapi.yaml for AI-readiness
> How AI-ready is https://petstore3.swagger.io/api/v3/openapi.json?
```

To force it into context regardless of phrasing, invoke it explicitly with
`/api-scorecard:jentic-api-scorecard`.

### Vercel `skills` CLI

Install it straight from this repository with the
[`skills` CLI](https://github.com/vercel-labs/skills):

```bash
npx skills add jentic/jentic-api-scorecard --skill jentic-api-scorecard
```

It's also listed in the [skills.sh directory](https://skills.sh/jentic/jentic-api-scorecard).

### TanStack Intent

The `@jentic/api-scorecard-cli` npm package also ships this skill inside its published
tarball, so it's discoverable by [TanStack Intent](https://tanstack.com/intent) for
projects that already depend on the CLI and want version-aligned agent guidance.

---

## Related links

* [CLI Reference](./api-scorecard.md)
* [Agent Skill (Improvements)](./api-improve-skill.md)
* [GitHub Action](./api-scorecard-action.md)
* [API Scoring – Getting Started](../getting-started/api-scoring.md)
* [Skill definition (SKILL.md)](https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md)