skill-tester
Installation
SKILL.md
Skill Tester
Validate skill packages for structure compliance, test Python scripts for syntax and stdlib-only imports, and score quality across four dimensions (documentation, code quality, completeness, usability) with letter grades and improvement recommendations. Supports BASIC, STANDARD, and POWERFUL tier classification.
Core Capabilities
- Structure validation — check required files, directory layout, YAML frontmatter, and required SKILL.md sections against tier thresholds.
- Script testing — AST syntax checks, stdlib-only import analysis, argparse and
__main__-guard detection, runtime--helpand sample-data execution. - Quality scoring — four equally weighted dimensions producing an overall score, letter grade (A+ through F), and a prioritized improvement roadmap.
- Tier classification — BASIC / STANDARD / POWERFUL requirements for SKILL.md depth, script count/LOC, argparse, output formats, and error handling.
- Dual output — human-readable reports and
--jsonfor CI/CD gating with meaningful exit codes.
When to Use
- Creating a new skill and validating it before publishing.
- Auditing an existing skill's structure, scripts, and quality.
- Embedding a quality gate into a CI/CD pipeline.