claim-matrix-rewriter
installsforks
How to install claim-matrix-rewriter?
willoscar/research-units-pipeline-skills/claim-matrix-rewriter
$npx -y skills add WILLOSCAR/research-units-pipeline-skills --skill claim-matrix-rewriterRewrite outline/claim_evidence_matrix.md as a projection/index of evidence packs (NO PROSE), so claims/axes are driven by outline/evidence_drafts.jsonl rather than outline placeholders. Trigger: claim matrix rewriter, rewrite claim-evidence matrix, evidence-first claim ma
SKILL.md
| 1 | # Claim Matrix Rewriter (Evidence-first, NO PROSE) |
| 2 | |
| 3 | Purpose: make `outline/claim_evidence_matrix.md` a **navigation/index layer** that is driven by evidence packs (not by outline bullets). |
| 4 | |
| 5 | Key property: keep the **legacy, gate-checked format** so downstream QA can rely on stable markers: |
| 6 | |
| 7 | - `- Claim:` (one per subsection) |
| 8 | - ` - Evidence:` (>=2 per subsection) |
| 9 | |
| 10 | ## Inputs |
| 11 | |
| 12 | - `outline/subsection_briefs.jsonl` |
| 13 | - `outline/evidence_drafts.jsonl` |
| 14 | - `citations/ref.bib` |
| 15 | |
| 16 | ## Outputs |
| 17 | |
| 18 | - `outline/claim_evidence_matrix.md` |
| 19 | |
| 20 | ## Non-negotiables |
| 21 | |
| 22 | - NO PROSE: bullets only. |
| 23 | - No placeholders: no `...`, unicode ellipsis (`…`), `TODO`, `(placeholder)`, or `<!-- SCAFFOLD -->`. |
| 24 | - Claims are evidence-aware: |
| 25 | - fulltext-backed: may summarize comparisons |
| 26 | - abstract-only/title-only: must be provisional (no strong “dominant trade-offs” language) |
| 27 | |
| 28 | ## Helper script |
| 29 | |
| 30 | - `uv run python .codex/skills/claim-matrix-rewriter/scripts/run.py --help` |
| 31 | - `uv run python .codex/skills/claim-matrix-rewriter/scripts/run.py --workspace <workspace>` |
| 32 | |
| 33 | ## Script |
| 34 | |
| 35 | ### Quick Start |
| 36 | |
| 37 | - `uv run python .codex/skills/claim-matrix-rewriter/scripts/run.py --help` |
| 38 | - `uv run python .codex/skills/claim-matrix-rewriter/scripts/run.py --workspace <workspace>` |
| 39 | |
| 40 | ### All Options |
| 41 | |
| 42 | - See `--help`. |
| 43 | - Requires: `outline/subsection_briefs.jsonl`, `outline/evidence_drafts.jsonl`, `citations/ref.bib`. |
| 44 | |
| 45 | ### Examples |
| 46 | |
| 47 | - Rewrite the matrix from evidence packs: |
| 48 | - Ensure `outline/subsection_briefs.jsonl` and `outline/evidence_drafts.jsonl` exist and `blocking_missing` is empty. |
| 49 | - Ensure `citations/ref.bib` exists and contains the cited keys. |
| 50 | - Run: `uv run python .codex/skills/claim-matrix-rewriter/scripts/run.py --workspace <workspace>` |
| 51 | |
| 52 | ## Troubleshooting |
| 53 | |
| 54 | ### Issue: cited keys are missing from `citations/ref.bib` |
| 55 | |
| 56 | **Fix**: |
| 57 | - Run `citation-verifier` (or fix the upstream notes) so every referenced key exists before rewriting. |
| 58 | |
| 59 | ### Issue: evidence packs still have `blocking_missing` |
| 60 | |
| 61 | **Fix**: |
| 62 | - Fix upstream evidence (`paper-notes` / `evidence-draft`) first; the matrix should not “paper over” missing evidence. |
People who liked this also viewed
6 picksType
- find-skillsHelps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skSkillsJul 2026
- grill-meA relentless interview to sharpen a plan or design.SkillsJul 2026
- vercel-react-best-practicesVercel's official collection of agent skillsSkillsJul 2026
- improve-codebase-architectureScan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.SkillsJul 2026
- setup-matt-pocock-skillsConfigure this repo for the engineering skills — set up its issue tracker, triage label vocabulary, and domain doc layout. Run once before first use of the other engineering skills.SkillsJul 2026
- triageMove issues and external PRs through a state machine of triage roles — categorise, verify, grill if needed, and write agent-ready briefs.SkillsJul 2026
