evidence-based-responses

Cite documentation, code references, and test results in code review responses.

Updated Aug 8, 2021
One-click install
npx skills add https://github.com/luanzeba/dotfiles --skill evidence-based-responses
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: evidence-based-responses
Source: https://github.com/luanzeba/dotfiles/tree/main/skills/evidence-based-responses
Command: npx skills add https://github.com/luanzeba/dotfiles --skill evidence-based-responses

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Never make a technical claim in reviews without backing evidence. This guide helps researchers gather documentation, code references, and test results to support every statement.

Core Features & Use Cases

  • Gather and verify sources from official docs, code comments, and test results before replying.
  • Structure responses with clear citations using permalink-style links and concrete examples.
  • Use the workflow: understand the concern, research, document evidence, and craft a precise, citation-backed reply.

Quick Start

Provide a code-review concern and I will draft an evidence-backed response with links to documentation, code references, and tests.

Frequently Asked Questions about evidence-based-responses

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

FAQPage Schema
How do I back claims with evidence in code reviews?

To back claims with evidence in code reviews, gather and verify sources from official docs, code references, and test results before replying. Structure your response using permalink-style links and concrete examples to justify every technical statement.

What is the best way to respond to reviewer feedback during technical discussions?

The best way to respond to reviewer feedback is to follow a structured workflow: understand the concern, research the topic, document the evidence, and craft a precise reply. Support every statement with citations from official documentation or test results.

How do I cite official documentation and code references in PR reviews?

To cite official documentation in PR reviews, use permalink-style links that point directly to specific code references, docs, or test results. This structured justification ensures your technical claims are verifiable and grounded in concrete examples.

Can I use test results to support technical claims in reviewer debates?

Yes, you can use test results to support technical claims in reviewer debates. Valid evidence includes official documentation, specific code references, and test outcomes, which must be presented with permalinks to ensure structured justification.

What are the limitations of using permalink citations for code review comments?

The primary limitation of using permalink citations is that it requires gathering and verifying sources from official docs, code comments, and test results beforehand. You must manually ensure every claim is backed by a structured justification before replying.