Skip to content

Releases: moonrunnerkc/skillcheck

v0.2.0

12 Mar 01:28
@moonrunnerkc moonrunnerkc
v0.2.0
0e79839

Choose a tag to compare

View all tags
v0.2.0 Latest
Latest

What's new in 0.2.0

First feature release. Adds cross-agent compatibility checks, file reference validation, progressive disclosure budgeting, description quality scoring, and a drop-in GitHub Action.

Highlights

GitHub Action -- three lines of YAML to add skillcheck to any CI pipeline. PR annotations, job summary table, and JSON output included. See the README for setup.

Cross-agent compatibility warnings -- flags Claude Code-only fields, VS Code directory-name requirements, and fields with unverified behavior in Codex and Cursor. Full compatibility matrix across four agents.

File reference validation -- parses markdown links and frontmatter directives, verifies referenced files exist on disk, catches symlink escapes (CWE-59), and warns when references go deeper than one directory level.

Progressive disclosure budget -- three-tier token budgeting (metadata at ~100 tokens, body at <5,000, resources on demand). Flags oversized code blocks, large tables, and embedded base64.

Description quality scoring -- scores 0-100 for agent discoverability. Checks action verbs, trigger phrases, keyword density, specificity, and length. Enforce a minimum with --min-desc-score N.

YAML type coercion detection -- catches when yaml.safe_load silently converts bare values like true, 123, or null into non-string types. Clear fix advice included.

New CLI flags

  • --strict-vscode promotes VS Code compatibility issues from INFO to ERROR
  • --target-agent {claude,vscode,all} scopes checks to a specific agent
  • --skip-dirname-check and --skip-ref-check for CI without filesystem context
  • -q/--quiet suppresses all output (exit code only)
  • --min-desc-score N enforces a minimum description quality threshold

Bug fixes

  • Fixed duplicate diagnostics for ../../ reference paths (both depth-exceeded and traverses-above fired; now only the most specific one does)
  • Corrected sizing rule descriptions in the README

Install

pip install skillcheck==0.2.0

Full changelog: CHANGELOG.md

Assets 2
Loading