skill-tester · borghei — Claude Code skill: what it does, how to install
skill-tester — a skill for Claude Code validates skill packages, runs Python checks, and scores quality. It fits workflows for building, auditing, or publishing a skill.
LicenseRef-MIT-Commons-Clause 136 installs ★ 1,183 updated 2026-11-08
npx skills add borghei/Claude-Skills --skill skill-tester -a claude-codeWhat skill-tester does
skill-tester runs with Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode. It checks directory layout, YAML frontmatter, required SKILL.md sections, and tier rules for BASIC, STANDARD, and POWERFUL packages. Python files go through AST syntax checks, import analysis, argparse and __main__ detection, plus --help and sample-data runs.
The scorer covers documentation, code quality, completeness, and usability. It produces a letter grade, improvement priorities, and either a readable report or --json output for CI/CD gates. script_tester.py executes scripts from the target skill, so a third-party package belongs in a disposable sandbox with credentials and network access removed.
What it helps with
- validate a skill directory against BASIC, STANDARD, or POWERFUL rules
- catch Python syntax errors and imports outside the standard library
- score documentation, code quality, completeness, and usability
- gate CI/CD with JSON output and meaningful exit codes
Example prompts for the agent
- Validate
engineering/my-skillas aPOWERFULskill and return the result as JSON. - Run the target skill’s Python checks, including
--help, with a 60-second timeout. - Score
engineering/my-skillin detail and set 75 as the minimum passing score.
How to install skill-tester
1Skills CLI (Vercel)
npx skills add borghei/Claude-Skills --skill skill-tester -a claude-code2Manually: put the files in place
~/.claude/skills/skill-tester/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/skill-tester/
1Skills CLI (Vercel)
npx skills add borghei/Claude-Skills --skill skill-tester -a codex2Manually: put the files in place
.agents/skills/skill-tester/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add borghei/Claude-Skills --skill skill-tester -a cursor2Manually: put the files in place
.cursor/skills/skill-tester/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install borghei/Claude-Skills engineering/skill-tester/SKILL.md2Manually: put the files in place
.github/skills/skill-tester/SKILL.md1Skills CLI (Vercel)
npx skills add borghei/Claude-Skills --skill skill-tester -a gemini-cli2Platform CLI
gemini skills install https://github.com/borghei/Claude-Skills --path engineering/skill-testerManually: put the files in place
.devin/skills/skill-tester/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add borghei/Claude-Skills --skill skill-tester -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about skill-tester
How do I install skill-tester in Claude Code?
Run npx skills add borghei/Claude-Skills --skill skill-tester -a claude-code, then check ~/.claude/skills/skill-tester/SKILL.md.
What does skill-tester do?
It validates package structure, YAML frontmatter, and Python scripts, then scores documentation, code quality, completeness, and usability. The result includes a letter grade and suggested improvements.
Does skill-tester verify that a script’s logic is correct?
No. It checks syntax, imports, command-line handling, --help, and sample runs, but it does not test business logic or algorithm accuracy.
Similar skills
All skills for Testing and QA →skill-tester by other authors comes first.