# review-plugin

review-plugin audits a plugin directory for script flaws and project standard violations, automatically fixing detected issues.

- command · `type=command` · Claude Code, Codex, GitHub Copilot, Gemini CLI · ★ 540 repo stars
- Author: trailofbits
- License: CC-BY-SA-4.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/trailofbits/skills-curated/tree/HEAD/.claude/commands/review-plugin.md
- Updated: 2026-07-14
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/commands/review-plugin

## What it does

The command inspects a target plugin directory across five review areas: script runtime safety, documentation accuracy, project standards, code consistency, and security hygiene. It tags findings as either critical blockers or warnings. The agent immediately patches critical blockers. Warnings receive fixes only when the solution is unambiguous and safe.

Under the hood, it orchestrates standard CLI inspection tools. Shell scripts undergo checks for strict execution flags, Bash 3.2 empty array expansion traps, executable bits, and formatting via `shfmt` and `shellcheck`. Python files require PEP 723 dependency headers and undergo linting with `ruff`. In documentation, all mentioned file paths and artifact names are verified against actual directory contents.

Running this check without `shellcheck` or `ruff` installed on your machine will break the automated linting phase.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/commands/review-plugin.md` — Call it with /review-plugin. For all projects use ~/.claude/commands/

### Codex

**Manually: put the files in place**
- File: `~/.codex/prompts/review-plugin.md` — Call it with /prompts:review-plugin. Codex marks this format deprecated in favour of skills

### GitHub Copilot

**Manually: put the files in place**
- File: `.github/prompts/review-plugin.prompt.md`

### Gemini CLI

**Manually: put the files in place**
- File: `.gemini/commands/review-plugin.toml` — Gemini stores commands as TOML: the prompt text goes into the prompt field

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/trailofbits/skills-curated/tree/HEAD/.claude/commands/review-plugin.md

## When to use it
- detect unquoted array expansions and missing error traps in shell scripts
- verify that file paths and parameters in documentation actually exist
- find hardcoded credentials and unsafe dynamic execution calls
- format Python and shell files to enforce consistent repository styling

## Example prompts
- /review-plugin plugins/my-tool/
- /review-plugin plugins/ghidra-headless/

## Similar
- [shellcheck](https://affpapa.org/en/nevibecode/skills/shellcheck.md) — skill · 129 installs
- [skill-review](https://affpapa.org/en/nevibecode/skills/skill-review.md) — skill · 2400 installs
- [qt-cpp-review](https://affpapa.org/en/nevibecode/skills/qt-cpp-review.md) — skill · 1200 installs
- [ruff](https://affpapa.org/en/nevibecode/skills/ruff.md) — skill · 3700 installs
- [lint-and-validate](https://affpapa.org/en/nevibecode/skills/sickn33-lint-and-validate.md) — skill · 1300 installs
- [ruff-linting](https://affpapa.org/en/nevibecode/skills/ruff-linting.md) — skill · 529 installs

From the same set: [trailofbits/skills-curated](https://affpapa.org/en/nevibecode/by/trailofbits/skills-curated.md) — 51 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
