rv — Claude Code slash command: review gate before push
rv runs the local checks you would otherwise skip before a push: workflow linting, a Python syntax pass, README link checking.
MIT ★ 907 updated 2025-11-12
.claude/commands/rv.mdWhat rv does
One pass of checks before you push. The command starts by having you commit work in progress so the tree holds only intended changes, then runs yamllint over .github/workflows with the line limit raised to 160 and validates the same files against the github-workflow schema with check-jsonschema.
Python code gets a syntax pass through python -m compileall across claude-skills-examples, generated-skills and generated-hooks, and markdown-link-check walks the links in README.md. Dependency audit is the optional part: safety check runs per file, and only when requirements*.txt exists.
Tooling install is a separate first-run step: pip install for yamllint==1.35.1, check-jsonschema==0.28.4 and safety==3.2.4, plus a global npm install of [email protected]. Skip that step and the rest of the run fails on missing binaries. Results land in the Testing section of the commit template, and failures are meant to be fixed before you carry on.
What it helps with
- lint GitHub Actions workflows before a commit
- catch a Python syntax error without running the scripts
- find dead links in the README
- audit requirements files for known vulnerabilities
- fill the Testing section of the commit template
Example prompts for the agent
/rvbefore I push, please- Run
/rvand fix whatever fails - Use
/rv, then put the summary into the Testing section of the commit message
How to install rv
Manually: put the files in place
.claude/commands/rv.mdCall it with /rv. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/rv.mdCall it with /prompts:rv. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/rv.prompt.mdManually: put the files in place
.gemini/commands/rv.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about rv
How to install rv in Claude Code?
Copy the command file into .claude/commands/rv.md in your project, then call /rv in the Claude session.
What does rv do?
A single local review pass before pushing: yamllint and check-jsonschema on workflows, compileall on Python, markdown-link-check on the README, plus an optional safety audit.
What does rv need to run?
On the first run it installs yamllint==1.35.1, check-jsonschema==0.28.4 and safety==3.2.4 with pip, and [email protected] globally with npm.
Source text
rv.md · MIT
--- description: Run the local review gate before pushing. --- Perform a complete review pass: 1. Save work in progress and ensure the working tree is clean except for intentional changes. 2. Install tooling (only first run): ```bash pip install --upgrade pip pip install yamllint==1.35.1 check-jsonschema==0.28.4 safety==3.2.4 npm install --global [email protected] ``` 3. Lint GitHub workflows: ```bash yamllint -d '{extends: default, rules: {line-length: {max: 160}}}' .github/workflows check-jsonschema --schema github-workflow --base-dir . .github/workflows/*.yml ``` 4. Python syntax check: ```bash python -m compileall claude-skills-examples generated-skills generated-hooks ``` 5. Markdown sanity check: ```bash markdown-link-check README.md ``` 6. Optional dependency audit (if `requirements*.txt` present): ```bash for f in $(ls **/requirements*.txt 2>/dev/null); do safety check --full-report --file "$f" done ``` 7. Summarize results in the commit template’s Testing section. Fix any failures before continuing.
© alirezarezvani · MIT · alirezarezvani/claude-code-skill-factory