Skill Doctor

Version updated for https://github.com/marian2js/skill-doctor to version v0.1.0.

  • This action is used across all versions by 0 repositories.

Action Type

This is a Composite action.

Go to the GitHub Marketplace to find the latest changes.

Action Summary

The GitHub Action skill-doctor automates the static analysis of coding agent skill packages to identify issues such as metadata errors, broken resource links, weak trigger descriptions, and malformed evaluation files. It provides a comprehensive diagnostic score (0-100) with actionable insights, ensuring skill packages meet quality standards for routing, onboarding, and evaluations. This tool simplifies quality assurance and improves the reliability of agent skills through automated validation and scoring.

Release notes

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.