qa-reviewer

Reviews investment report drafts against source findings and emits verdicts with structured fix lists.

Updated May 9, 2026
One-click install
npx skills add https://github.com/122yjs/invest_harness --skill qa-reviewer-122yjs
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: qa-reviewer
Source: https://github.com/122yjs/invest_harness/tree/main/plugins/vertical-plugins/invest-research/skills/qa-reviewer
Command: npx skills add https://github.com/122yjs/invest_harness --skill qa-reviewer-122yjs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Investment research reports assembled from multiple analyst findings often contain citation gaps, numeric conflicts, missing sections, and tone violations that are hard to catch manually. This Skill systematically audits a draft report against its source findings and evidence ledger, then produces a verdict and an actionable fix list. ## Core Features & Use Cases - Structural and Source Audit: Verifies all 18 required report sections exist and that key figures carry sources, dates, currencies, and accounting periods. - Numeric Recalculation: Recomputes market cap, PER, PBR, EV/EBITDA, FCF Yield, DCF divergence, and implied upside/downside against the market price snapshot. - Claim-Evidence Verification: Validates that every claim in claim-evidence-map.json maps to real entries in the evidence ledger, flagging dangling or empty references. - Fix-List Emission: Emits a machine-readable YAML fix list with classification (numeric_conflict, missing_evidence_link, source_violation, structural_gap, tone_violation) for orchestrator-driven rework. - Use Case: After analysts produce findings and a draft report in the workspace, run this Skill to decide whether the draft can be approved, needs fixes, or requires re-review before finalization. ## Quick Start Review the draft report at 07_draft/report.md against all analyst findings and write the QA verdict, fix list, and final check into the 09_qa workspace directory.

Frequently Asked Questions about qa-reviewer

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

FAQPage Schema
How do I QA an investment research report draft before finalizing it?▼

Run the qa-reviewer Skill after the draft report and all analyst findings exist in the workspace. It checks structure, sources, numeric consistency, and claim-evidence links, then writes a verdict, fix list, and final check to the 09_qa directory.

What does the QA review check in an equity research report?▼

It verifies all 18 required sections, source and date attribution for key figures, recalculated valuation metrics like PER and EV/EBITDA, Rating and Price Target consistency, source-claim boundary violations, and Korean formal report tone compliance.

How are numeric conflicts between the draft and source findings handled?▼

Conflicts are recorded with both the draft and source locations, then emitted as fix-list entries classified as numeric_conflict. The orchestrator can queue a targeted re-run or escalate to a full reconciliation step.

What happens when a claim has no supporting evidence?▼

Claims with empty evidence_ids arrays or references missing from the evidence ledger are automatically registered in the fix list as missing_evidence_link entries, and the verdict cannot be approval until resolved.

When does the QA reviewer reject a report draft?▼

The verdict is never approval when critical defects exist, required input files are missing, the claim-evidence map is absent, or divergent reconciliation claims appear in the draft. Such cases receive a needs-fix or re-review verdict.