skill-versions

Freshness checker for Agent Skills
Like npm outdated for skill knowledge

npx skill-versions check

The problem

Agent skills are snapshots of knowledge at a point in time. They don’t update themselves. They don’t know when upstream products ship breaking changes. They just sit there, slowly becoming wrong.

⚠

Silent staleness

A renamed package, a deprecated API, a missing parameter — stale skills don’t always fail loudly. Sometimes they just quietly produce worse outcomes.

📦

Code has dependency management. Skills don’t.

npm outdated tells you when packages are behind. Dependabot opens PRs. But for agent knowledge? Nothing. Your skill files are flying blind.

✅

skill-versions fixes this

A product registry, version checker, frontmatter convention, and AI-assisted refresh — everything you need to keep agent skills current, automatically.

Read the full story: Your Agent’s Knowledge Has a Shelf Life→

Quickstart

Four commands to keep your agent skills fresh.

1

Scan your skills directory

Discover SKILL.md files and map them to npm packages.

npx skill-versions init
2

Check for staleness

Compare verified versions against the npm registry.

npx skill-versions check
3

Generate a report

Get a full markdown report for your team or CI pipeline.

npx skill-versions report
4

AI-assisted refresh

Use an LLM to propose targeted updates to stale skill files.

npx skill-versions refresh