↻
Freshness & Currency
refresh
Automatically update stale skill files by fetching changelogs, analyzing breaking changes, and generating targeted diffs using LLMs. Review, approve, or auto-apply.
Why it matters
Manually updating skills after every dependency release is tedious and error-prone. Refresh automates the grunt work — it reads the changelog, understands what changed, and proposes precise edits to your skill files so agents always have current instructions.
What it does
- Identifies stale skills by running check internally
- Fetches changelogs and release notes from GitHub for each stale product
- Sends the current skill content + changelog to an LLM to generate a targeted update
- Presents a diff for review in interactive mode, or auto-applies with -y
- Preserves your skill's structure and style — only changes what's outdated
Usage
npx skills-check refresh [skills-dir] [options]Options
| Flag | Description |
|---|---|
-y, --yes | Auto-apply all changes without prompting |
--dry-run | Preview changes without writing files |
--provider <name> | LLM provider: anthropic, openai, or google |
--model <name> | Specific model ID to use |
-p, --product <name> | Refresh a single product |
Examples
Interactive review
npx skills-check refresh ./skillsAuto-apply
npx skills-check refresh -yPreview only
npx skills-check refresh --dry-runSpecific provider
npx skills-check refresh --provider anthropic --model claude-sonnet-4-20250514CI tip
Run refresh in --dry-run mode as a CI check to surface which skills need updates, then handle updates in a separate PR workflow.