evidence-based-review

Enforce evidence-based comments with cited code in pull request reviews.

1|Updated May 15, 2026
One-click install
npx skills add https://github.com/thrillmade/agent-skills --skill evidence-based-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: evidence-based-review
Source: https://github.com/thrillmade/agent-skills/tree/main/.claude/skills/evidence-based-review
Command: npx skills add https://github.com/thrillmade/agent-skills --skill evidence-based-review

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill addresses the challenge of vague PR reviews by enforcing concrete evidence in all review comments, ensuring a constructive and effective review process.

Core Features & Use Cases

  • Concrete Evidence Enforcement: Ensures every review claim is backed by specific code examples and references.
  • Quote and Cite Code: Requires reviewers to quote the exact lines they're addressing.
  • Clarity in Reporting: Facilitates a clear, actionable feedback loop by focusing on specific failures and their causes.
  • Use Case: When a code review is required on a pull request, this skill ensures the comments provided are grounded in reality and can be easily verified.

Quick Start

When providing a code review, use the evidence-based-review skill to comment on 'line 42-45 in file src/main/java/Service.java' with a specific explanation.

Frequently Asked Questions about evidence-based-review

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I enforce evidence-based code review comments on pull requests?

To enforce evidence-based code review comments, use a skill that requires reviewers to quote specific code lines and detail failure modes. This ensures every PR feedback claim is backed by verifiable code citations.

What's the best way to stop vague PR feedback and improve developer communication?

The best way to stop vague PR feedback is to mandate concrete evidence in review comments. This requires quoting exact lines and explaining specific failures, creating a clear and actionable developer communication loop.

How do I require exact code citations in GitHub code reviews?

You can require exact code citations in GitHub code reviews by applying an evidence-based review process. This mechanism forces reviewers to reference precise file lines, such as line 42 in src/main/java/Service.java, with specific explanations.

Does evidence-based code review work for standard GitHub pull requests?

Yes, evidence-based code review works for standard GitHub pull requests and similar platforms. It directly integrates into the PR feedback process to ensure all comments are grounded in verifiable code reality and precise claims.

Why do my code review comments lack clarity and actionable feedback?

Code review comments lack clarity when they are not evidence-based. By enforcing concrete evidence and specific failure mode reporting, you transform vague critiques into precise, verifiable claims that developers can easily act upon.

When should I require concrete evidence and code quotes in a PR review?

You should require concrete evidence and code quotes in a PR review whenever a code review is needed. This ensures comments address specific code lines and detail exact failures, preventing unverified or generalized feedback.