# review-tool

The review-tool skill checks tool configuration files against project schemas and reports violations. Use it when you need a full scan that continues after errors appear.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 155 repo stars
- Author: serpro69
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/serpro69/claude-toolbox/tree/HEAD/kodex-plugin/skills/diff-skill/evals/clean-refactor/test-files/before/SKILL.md
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/review-tool

## What it does

The skill loads the project schemas before inspecting configuration files. It checks for `name`, `version`, and `entrypoint`, flags the obsolete `legacy_mode` and `compat_shim` fields, and validates version strings against semver. The scan starts only after the schemas have been read.

For each issue, it records the file path, field, and violation type, then keeps scanning and separates blocking errors from warnings. It writes a report under `docs/reports/`, returns pass and fail counts, and indexes blocking findings under `kk:review-findings`. For Claude Code, the install command uses `before` as the skill name; the resulting file path is `~/.claude/skills/before/SKILL.md`.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add serpro69/claude-toolbox --skill review-tool -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add serpro69/claude-toolbox --skill review-tool -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add serpro69/claude-toolbox --skill review-tool -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install serpro69/claude-toolbox kodex-plugin/skills/diff-skill/evals/clean-refactor/test-files/before
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add serpro69/claude-toolbox --skill review-tool -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/serpro69/claude-toolbox --path kodex-plugin/skills/diff-skill/evals/clean-refactor/test-files/before
```

### Windsurf (Devin Desktop)

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

### 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/serpro69/claude-toolbox/tree/HEAD/kodex-plugin/skills/diff-skill/evals/clean-refactor/test-files/before/SKILL.md

## When to use it
- check required fields in tool configurations
- find obsolete fields across configuration files
- validate version string formats
- sort findings into blocking errors and warnings
- write a report with validation counts

## Example prompts
- Check the tool configurations against the project schemas and save the report under `docs/reports/`.
- Scan every configuration for obsolete fields and keep going after the first error.
- Validate required fields and version formats, then group blocking findings separately from warnings.

## Similar
- [config-validate](https://affpapa.org/en/nevibecode/commands/config-validate.md) — command · ★ 42780 repo stars
- [microsoft-extensions-configuration](https://affpapa.org/en/nevibecode/skills/microsoft-extensions-configuration.md) — skill · 621 installs
- [om-code-review](https://affpapa.org/en/nevibecode/skills/om-code-review.md) — skill · 4200 installs
- [pr-review](https://affpapa.org/en/nevibecode/skills/pr-review.md) — skill · 1800 installs
- [review-hog-validation-criteria](https://affpapa.org/en/nevibecode/skills/review-hog-validation-criteria.md) — skill · 187 installs
- [review-hog-perspective-contracts-security](https://affpapa.org/en/nevibecode/skills/review-hog-perspective-contracts-security.md) — skill · 187 installs

From the same set: [serpro69/claude-toolbox](https://affpapa.org/en/nevibecode/by/serpro69/claude-toolbox.md) — 30 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
