← All commands
⚑
Freshness & Currency

report

Produce a comprehensive staleness report summarizing which skills are current, which are stale, and by how much. Output as markdown for issues or JSON for automation.

Why it matters

Teams need visibility into skill health across their entire fleet. A weekly report in a GitHub issue or Slack message keeps everyone aware of drift without requiring manual checks.

What it does

  • Runs a full version check against the npm registry
  • Generates a formatted report with current vs. latest versions
  • Groups results by status (stale, current, error)
  • Outputs markdown suitable for GitHub issues or JSON for pipelines

Usage

npx skills-check report [options]

Options

FlagDescription
--registry <path>Path to skills-check.json
--format <type>Output format: markdown or json

Examples

Markdown report

npx skills-check report

JSON for automation

npx skills-check report --format json

CI tip

The GitHub Action automatically generates a report and opens/updates a GitHub issue when staleness is detected. Use the report output for custom Slack or email notifications.

Full CLI reference →