v0.1.0: first public release

Skill Doctor 0.1.0

Skill Doctor is a static diagnostics CLI for agent skills.

This first public release brings the core analyzer, a polished terminal UI inspired by React Doctor, and both npm and GitHub Action support for running skill health checks in local workflows and CI.

Highlights

• Static analysis for agent skills and skill workspaces
• Validation for SKILL.md structure, metadata, and linked resources
• Trigger-quality and instruction-hygiene checks
• Evals validation for skill packages that include eval definitions
• Clear terminal reporting with workspace score, findings, and per-skill summaries
• JSON output for automation and CI integrations
• GitHub Action support via action.yml
• npm publishing via Trusted Publisher

Install

npm install -g skill-doctor

CLI usage

skill-doctor .
skill-doctor /path/to/skills --verbose
skill-doctor /path/to/skills --json

GitHub Action

- uses: marian2js/skill-doctor@v0.1.0
  with:
    directory: .

Notes

This is the initial public release, so the focus is on strong static checks, fast feedback, and an excellent CLI experience. Future releases will expand rule coverage, improve diagnostics, and add more automation-friendly workflows.