---
name: Claim Matrix Rewriter
slug: claim-matrix-rewriter
category: AI Engineering
description: Claim Matrix Rewriter rewrites outline/claim_evidence_matrix.md as a bullet-only index driven by evidence packs instead of outline placeholders. Use it when you need the matrix to preserve the legacy claim/evidence format while reflecting evidence-first inputs.
github: "https://github.com/WILLOSCAR/research-units-pipeline-skills/tree/main/.codex/skills/claim-matrix-rewriter"
language: Python
stars: 499
forks: 39
install: "npx degit https://github.com/WILLOSCAR/research-units-pipeline-skills/tree/main/.codex/skills/claim-matrix-rewriter ~/.claude/skills/claim-matrix-rewriter"
installs_to: ~/.claude/skills/claim-matrix-rewriter
source_path: .codex/skills/claim-matrix-rewriter/SKILL.md
collection_size: 25
category_size: 2451
collection_url: "https://dirskills.com/collections/WILLOSCAR/research-units-pipeline-skills"
added: 2026-08-26T05:12:54.390Z
last_synced: 2026-08-26T05:12:54.390Z
canonical_url: "https://dirskills.com/skills/claim-matrix-rewriter"
---

# Claim Matrix Rewriter

Claim Matrix Rewriter rewrites outline/claim_evidence_matrix.md as a bullet-only index driven by evidence packs instead of outline placeholders. Use it when you need the matrix to preserve the legacy claim/evidence format while reflecting evidence-first inputs.

**Install:**

```bash
npx degit https://github.com/WILLOSCAR/research-units-pipeline-skills/tree/main/.codex/skills/claim-matrix-rewriter ~/.claude/skills/claim-matrix-rewriter
```

## README

# Claim Matrix Rewriter (Evidence-first, NO PROSE)

Purpose: make `outline/claim_evidence_matrix.md` a **navigation/index layer** that is driven by evidence packs (not by outline bullets).

Key property: keep the **legacy, gate-checked format** so downstream QA can rely on stable markers:

- `- Claim:` (one per subsection)
- `  - Evidence:` (>=2 per subsection)

## Inputs

- `outline/subsection_briefs.jsonl`
- `outline/evidence_drafts.jsonl`
- `citations/ref.bib`

## Outputs

- `outline/claim_evidence_matrix.md`

## Non-negotiables

- NO PROSE: bullets only.
- No placeholders: no `...`, unicode ellipsis (`…`), `TODO`, `(placeholder)`, or `<!-- SCAFFOLD -->`.
- Claims are evidence-aware:
  - fulltext-backed: may summarize comparisons
  - abstract-only/title-only: must be provisional (no strong “dominant trade-offs” language)

## Helper script

- `uv run python .codex/skills/claim-matrix-rewriter/scripts/run.py --help`
- `uv run python .codex/skills/claim-matrix-rewriter/scripts/run.py --workspace <workspace>`

## Script

### Quick Start

- `uv run python .codex/skills/claim-matrix-rewriter/scripts/run.py --help`
- `uv run python .codex/skills/claim-matrix-rewriter/scripts/run.py --workspace <workspace>`

### All Options

- See `--help`.
- Requires: `outline/subsection_briefs.jsonl`, `outline/evidence_drafts.jsonl`, `citations/ref.bib`.

### Examples

- Rewrite the matrix from evidence packs:
  - Ensure `outline/subsection_briefs.jsonl` and `outline/evidence_drafts.jsonl` exist and `blocking_missing` is empty.
  - Ensure `citations/ref.bib` exists and contains the cited keys.
  - Run: `uv run python .codex/skills/claim-matrix-rewriter/scripts/run.py --workspace <workspace>`

## Troubleshooting

### Issue: cited keys are missing from `citations/ref.bib`

**Fix**:
- Run `citation-verifier` (or fix the upstream notes) so every referenced key exists before rewriting.

### Issue: evidence packs still have `blocking_missing`

**Fix**:
- Fix upstream evidence (`paper-notes` / `evidence-draft`) first; the matrix should not “paper over” missing evidence.