result-figure-consistencycheck

> **Source**: [https://github.com/aipoch/medical-research-skills](https://github.com/aipoch/medical-research-skills)

## When to Use

- You converted a paper PDF to Markdown and need to verify that **Results text** matches **figure legends** (without inspecting the images).
- You want to detect **missing figure references** in the Results section (e.g., a legend describes an analysis not mentioned in text).
- You need to find **numerical/label mismatches** (e.g., group names, time points, units, n-values) between Results paragraphs and legends.
- You are preparing a revision and want an **actionable discrepancy list** down to the **panel/sub-figure** level.
- You need standardized outputs (Markdown report + CSV) for editorial or QA workflows.

## Key Features

- Compares **Results descriptions** vs **figure legend text** using the PDF-to-Markdown source (including `## Page XX` markers).
- Produces:
  - A **Markdown consistency report** (UTF-8).
  - A **CSV issue list** (UTF-8) with structured fields for tracking and revision.
- Enforces a **template-based report format** using `assets/consistency_template.md`.
- Uses a **rule/checklist reference** from `references/guide.md`.
- Text-only validation: **does not read figure images** and **does not infer visual content**.

## Dependencies

- None (no external runtime dependencies specified).
- Input prerequisite (if starting from PDF): a PDF-to-Markdown conversion step (e.g., `pdf-extract`) must be completed before running this check.

## Example Usage

### Input

Place the converted full text Markdown in your working location (example: `inputs/paper_fulltext.md`). The file should include page headers like:

```md
## Page 12
... Results text ...

Figure 3. ...
(A) ...
(B) ...
```

### Run (conceptual workflow)

1. Read the full Markdown input (PDF conversion output).
2. Identify:
   - Result paragraphs describing findings.
   - Figure legend blocks (including panel labels such as A/B/C).
3. Compare legend statements against Results statements and record discrepancies.
4. Write outputs to `outputs/`:
   - `outputs/consistency_report.md` (UTF-8)
   - `outputs/consistency_issues.csv` (UTF-8)

### Output files

**`outputs/consistency_issues.csv`** (UTF-8) columns:

```csv
Figure Number,Location/Reference,Issue Description,Suggested Revision,Priority
```

Notes:
- `Location/Reference` must contain only `Page XX`.
- Issues should be granular to the **panel/sub-figure** level when applicable.

**`outputs/consistency_report.md`** (UTF-8) must follow:

- Template: `assets/consistency_template.md`
- If no issues are found, write **"None found"** in the relevant sections.

## Implementation Details

- **Scope of comparison**
  - Only compare **main text Results descriptions** and **figure legend text** present in the Markdown input.
  - Do **not** inspect images or infer information not explicitly stated in text.

- **Rules and checklist**
  - Follow the specific checking rules and required output points defined in:
    - `references/guide.md`

- **Report formatting**
  - The Markdown report must be generated by filling:
    - `assets/consistency_template.md`
  - Ensure all outputs are saved under:
    - `outputs/` (within the skill directory)

- **Granularity and actionability**
  - Record discrepancies at the most specific level possible (e.g., Figure 2B vs Figure 2 overall).
  - Provide a concrete **Suggested Revision** whenever feasible (e.g., align terminology, correct numbers/units, add missing reference).

- **Language**
  - Default output language is **Chinese**.
  - If the user explicitly specifies another language, output in that language.