# Skills Check

> The missing quality toolkit for Agent Skills

skills-check is the quality and integrity layer for Agent Skills (SKILL.md files). It provides 10 commands covering freshness detection, security auditing, metadata linting, token budget analysis, semver verification, policy enforcement, and eval testing. Agent Skills are markdown documents with YAML frontmatter that instruct AI coding agents (Claude Code, Cursor, Codex, etc.) how to work with specific products, frameworks, and patterns. skills-check ensures these instructions are correct, safe, current, and efficient.

## Commands

- check: Detect version drift by comparing skill frontmatter against the npm registry.
- refresh: AI-assisted updates to stale skills using LLMs. Fetches changelogs and generates diffs.
- report: Generate a formatted staleness report in markdown or JSON for your team or CI.
- audit: Scan for hallucinated packages, prompt injection, dangerous commands, and dead URLs.
- lint: Validate metadata completeness, structural quality, and format in skill files.
- policy: Enforce organizational trust rules for skills via .skill-policy.yml policy-as-code.
- budget: Measure token cost per skill, detect redundancy, and track context window usage over time.
- verify: Validate that content changes between skill versions match the declared semver bump.
- test: Run eval test suites declared in skill tests/ directories for regression detection.
- fingerprint: Generate a fingerprint registry of installed skills with content hashes and watermarks.
- usage: Analyze skill telemetry events for usage patterns, cost estimation, and policy compliance.
- init: Scan a skills directory for SKILL.md files and generate a skills-check.json registry.

## Further Reading

- [Full LLM-optimized reference](https://skillscheck.ai/llms-full.txt): Complete CLI reference with options, examples, and specifications
- [Documentation](https://skillscheck.ai/docs): Human-readable documentation
- [npm package](https://www.npmjs.com/package/skills-check): Install via npm
- [GitHub repository](https://github.com/voodootikigod/skills-check): Source code and issues
- [JSON Schema](https://skillscheck.ai/schema.json): Registry file schema