Agent skill · software engineering · borghei
skill-tester
Validate and score Claude Code skill packages for quality, completeness, and best-practice compliance. Tests Python scripts, checks YAML frontmatter, and generates reports. Use when creating, validating, or auditing skill packages.
Why this skill is useful
Adds 3 executable Python scripts for validating, testing, and scoring skill packages that enhance the AI's capability to ensure quality and compliance.
What it needs
Requires python installed locally. About 4k tokens when loaded. Last updated 2026-07-21. 462 stars on the source repository.
What this skill does
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 Before validating, confirm these inputs. If any is unknown or vague, ASK — do not assume: [ ] Target skill path — the skill directory to validate, test, and score (the subject of all three tools) [ ] Target tier — BASIC / STANDARD / POWERFUL (--tier; sets the required sections, script count, and structural thresholds) [ ] Pass bar — the minimum quality score / whether failures gate CI (--minimum-score, exit codes) Stop rule: ask only the 2-3 that most change the output. If the user says "just draft it," proceed and list your assumptions at the top of the artifact. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills borghei/skill-tester