# skill-tester

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.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 136 installs · ★ 1183 repo stars
- Author: borghei
- License: LicenseRef-MIT-Commons-Clause · policy=link-only · description only; the file stays with the author
- Source: https://github.com/borghei/Claude-Skills/tree/HEAD/engineering/skill-tester/SKILL.md
- Updated: 2026-11-08
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/borghei-skill-tester

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill skill-tester -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/skill-tester/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/skill-tester/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill skill-tester -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/skill-tester/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill skill-tester -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/skill-tester/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install borghei/Claude-Skills engineering/skill-tester/SKILL.md
```

2. **Manually: put the files in place**
- File: `.github/skills/skill-tester/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill skill-tester -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/borghei/Claude-Skills --path engineering/skill-tester
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/skill-tester/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill skill-tester -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/borghei/Claude-Skills/tree/HEAD/engineering/skill-tester/SKILL.md

## When to use it
- 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
- Validate `engineering/my-skill` as a `POWERFUL` skill and return the result as JSON.
- Run the target skill’s Python checks, including `--help`, with a 60-second timeout.
- Score `engineering/my-skill` in detail and set 75 as the minimum passing score.

## Similar
- [skill-check](https://affpapa.org/en/nevibecode/skills/skill-check.md) — skill · ★ 45 repo stars
- [visual-regression-tester](https://affpapa.org/en/nevibecode/skills/visual-regression-tester.md) — skill · 351 installs
- [skill-integration-tester](https://affpapa.org/en/nevibecode/skills/skill-integration-tester.md) — skill · 3500 installs
- [session-analyzer](https://affpapa.org/en/nevibecode/skills/session-analyzer.md) — skill · 1300 installs
- [skill-creator](https://affpapa.org/en/nevibecode/skills/sickn33-skill-creator.md) — skill · 988 installs
- [skill-evaluator](https://affpapa.org/en/nevibecode/skills/skill-evaluator.md) — skill · ★ 423 repo stars

## Other versions with the same name
- [skill-tester · alirezarezvani](https://affpapa.org/en/nevibecode/skills/skill-tester.md) — 608 installs

From the same set: [borghei/claude-skills](https://affpapa.org/en/nevibecode/by/borghei/claude-skills.md) — 120 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
