evidence-based-review
Installation
SKILL.md
Evidence-based review
Every claim in your review must be backed by evidence the PR author can verify in seconds.
Required for every finding
- Quote the exact line or block you're talking about (use a fenced code block or
gh prinline-comment anchor). - Cite the file and line range so the author can navigate directly there.
- State the failure mode concretely: what input produces what wrong output, or what attacker action exploits what gap.
Banned phrasings
These are red flags that you're hand-waving instead of reviewing:
- "This might cause issues" → say which issue, with the input that triggers it.
- "Consider refactoring this" → either it has a bug, or it doesn't. Not your call to redesign their code.
- "This doesn't follow best practices" → cite which practice and why it matters here.
- "You should add tests" → name the specific code path that isn't covered.