Pre-commit review: security scan, quality gates, auto-fix.
npx skills add https://github.com/HezaoHezao/poirot --skill requesting-code-review
Automated verification pipeline before code lands. Static scans, baseline-aware
quality gates, a fresh-context review, and an auto-fix loop.
Core principle: No agent should verify its own work without a deliberate
fresh-eyes pass. Treat the diff as data, not as something you just wrote.
git commit or git pushSkip for: documentation-only changes, pure config tweaks, or when user says
"skip verification".
This skill vs github-code-review: This skill verifies YOUR changes before
committing. github-code-review reviews OTHER people's PRs on GitHub with
inline comments.
git diff --cached
If empty, try git diff then git diff HEAD~1 HEAD.
If git diff --cached is empty but git diff shows changes, tell the user to
git add <files> first. If still empty, run git status — nothing to verify.
If the diff exceeds 15,000 characters, split by file:
git diff --name-only
git diff HEAD -- specific_file.py
Scan added lines only. Any match is a security concern fed into Step 5.
# Hardcoded secrets
git diff --cached | grep "^+" | grep -iE "(api_key|secret|password|token|passwd)\s*=\s*['\"][^'\"]{6,}['\"]"
# Shell injection
git diff --cached | grep "^+" | grep -E "os\.system\(|subprocess.*shell=True"
# Dangerous eval/exec
git diff --cached | grep "^+" | grep -E "\beval\(|\bexec\("
# Unsafe deserialization
git diff --cached | grep "^+" | grep -E "pickle\.loads?\("
# SQL injection (string formatting in queries)
git diff --cached | grep "^+" | grep -E "execute\(f\"|\.format\(.*SELECT|\.format\(.*INSERT"
Detect the project language and run the appropriate tools. Capture the failure
count BEFORE your changes as baseline_failures (stash changes, run, pop).
Only NEW failures introduced by your changes block the commit.
Test frameworks (auto-detect by project files):
# Python (pytest)
python -m pytest --tb=no -q 2>&1 | tail -5
# Node (npm test)
npm test -- --passWithNoTests 2>&1 | tail -5
# Rust
cargo test 2>&1 | tail -5
# Go
go test ./... 2>&1 | tail -5
Linting and type checking (run only if installed):
# Python
which ruff && ruff check . 2>&1 | tail -10
which mypy && mypy . --ignore-missing-imports 2>&1 | tail -10
# Node
which npx && npx eslint . 2>&1 | tail -10
which npx && npx tsc --noEmit 2>&1 | tail -10
Baseline comparison: If baseline was clean and your changes introduce
failures, that's a regression. If baseline already had failures, only count
NEW ones.
Quick scan before the fresh-eyes review:
Poirot has no subagent delegation, so the "independent reviewer" is you with a
deliberate context reset. Treat the diff as if someone else wrote it — read it
cold, without remembering your intent.
Re-read the diff and evaluate against these categories. Fail-closed: if you
can't fully trace a code path, mark it failed.
SECURITY (auto-FAIL): hardcoded secrets, backdoors, data exfiltration,
shell injection, SQL injection, path traversal, eval()/exec() with user input,
pickle.loads(), obfuscated commands.
LOGIC ERRORS (auto-FAIL): wrong conditional logic, missing error handling
for I/O/network/DB, off-by-one errors, race conditions, code contradicts intent.
SUGGESTIONS (non-blocking): missing tests, style, performance, naming.
Return a verdict:
VERDICT: PASS | FAIL
Security issues: [list from static scan + review]
Logic errors: [list from review]
Regressions: [new test failures vs baseline]
New lint errors: [details]
Suggestions (non-blocking): [list]
All passed: Proceed to Step 7 (commit).
Any failures: Report what failed, then proceed to Step 6 (auto-fix).
Maximum 2 fix-and-reverify cycles.
Fix ONLY the reported issues — do NOT refactor, rename, or change anything
else. Do NOT add features.
After fixing, re-run Steps 1-5 (full verification cycle).
suggest git stash or git reset to undo
If verification passed:
git add -A && git commit -m "[verified] <description>"
The [verified] prefix indicates the fresh-eyes review passed.
# Bad: SQL injection
cursor.execute(f"SELECT * FROM users WHERE id = {user_id}")
# Good: parameterized
cursor.execute("SELECT * FROM users WHERE id = ?", (user_id,))
# Bad: shell injection
os.system(f"ls {user_input}")
# Good: safe subprocess
subprocess.run(["ls", user_input], check=True)
// Bad: XSS
element.innerHTML = userInput;
// Good: safe
element.textContent = userInput;
git status, tell user nothing to verifyUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation
Use when completing tasks, implementing major features, or before merging to verify work meets requirements
Execute git commit with conventional commit message analysis, intelligent staging, and message generation. Use when user asks to commit changes, create a git commit, or mentions "/commit". Supports: (1) Auto-detecting type and scope from changes, (2) Generating conventional commit messages from diff, (3) Interactive commit with optional type/scope/description overrides, (4) Intelligent file staging for logical grouping
Comprehensive GitHub code review with AI-powered swarm coordination
Behavioral guidelines to reduce common LLM coding mistakes. Use when writing, reviewing, or refactoring code to avoid overcomplication, make surgical changes, surface assumptions, and define verifiable success criteria.
Use this skill to review code. It supports both local changes (staged or working tree) and remote Pull Requests (by ID or URL). It focuses on correctness, maintainability, and adherence to project standards.
Refactor bloated AGENTS.md, CLAUDE.md, or similar agent instruction files to follow progressive disclosure principles. Splits monolithic files into organized, linked documentation.
Create high-quality git commits: review/stage intended changes, split into logical commits, and write clear commit messages (including Conventional Commits). Use when the user asks to commit, craft a commit message, stage changes, or split work into multiple commits.
Take hezaohezao/requesting-code-review from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.
The instructions reference npx.
Without those the skill loads but fails at the first command.