review-plugin — Claude Code command: what it does, how to install
review-plugin audits a plugin directory for script flaws and project standard violations, automatically fixing detected issues.
CC-BY-SA-4.0 ★ 540 updated 2026-07-14
.claude/commands/review-plugin.mdWhat review-plugin 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.
What it helps with
- 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 for the agent
- /review-plugin plugins/my-tool/
- /review-plugin plugins/ghidra-headless/
How to install review-plugin
Manually: put the files in place
.claude/commands/review-plugin.mdCall it with /review-plugin. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/review-plugin.mdCall it with /prompts:review-plugin. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/review-plugin.prompt.mdManually: put the files in place
.gemini/commands/review-plugin.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about review-plugin
How to install review-plugin in Claude Code?
Save the command definition file at .claude/commands/review-plugin.md. Once saved, execute it directly inside your Claude Code session.
What does review-plugin do?
It audits a plugin directory across script execution, documentation fidelity, style standards, and basic security checks. The command automatically applies safe fixes and prints a summary table.
What external tools are required for the review?
Shell script evaluation depends on shellcheck and shfmt. Python script checks and formatting require ruff in your environment.