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 --help and 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 --json for 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.

Clarify First

Installs
133
GitHub Stars
492
First Seen
Feb 28, 2026
skill-tester — borghei/claude-skills