Skip to main content
command CX Codex

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

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/commands/rv.md
Open on GitHub

What 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

  • /rv before I push, please
  • Run /rv and 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.md

Call it with /rv. For all projects use ~/.claude/commands/

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

Similar slash commands

All slash commands for Code review and refactoring →

From the same set36

The whole set →

Project sponsors

Companies that keep this analytics open