✓
Freshness & Currency
check
Compare the product-version in your SKILL.md frontmatter against the latest version on npm. Instantly know which skills are stale and by how much.
Why it matters
Agent skills that reference outdated APIs lead to hallucinated code, broken builds, and wasted developer time. A skill written for React 18 won't generate correct React 19 Server Component patterns. Version drift is the #1 source of skill quality decay.
What it does
- Reads your skills-check.json registry to map products to npm packages
- Fetches the latest version from the npm registry for each product
- Compares it against the product-version declared in each skill's frontmatter
- Reports stale products with the exact version gap (e.g. 4.2.0 → 4.5.1)
- Exits with code 1 in CI mode when staleness is detected
Usage
npx skills-check check [options]Options
| Flag | Description |
|---|---|
--registry <path> | Path to skills-check.json (default: skills-check.json) |
--json | Output results as JSON |
--ci | CI mode — exit code 1 if stale products found |
-p, --product <name> | Check a single product |
Examples
Check all products
npx skills-check checkJSON output for scripts
npx skills-check check --jsonCI gate
npx skills-check check --ciCheck one product
npx skills-check check -p ai-sdkCI tip
Pair with the GitHub Action to automatically open issues when skills go stale. Set fail-on-stale: true to block merges until skills are updated.