# Synthesis Writer

Use when `evidence-review` has completed extraction and needs a bounded narrative...

- Repository: https://github.com/WILLOSCAR/research-units-pipeline-skills (517 stars)
- Category: Engineering
- License: see repository
- Last updated: 2026-10-05
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add WILLOSCAR/research-units-pipeline-skills --skill synthesis-writer -g -a claude-code -y`
Codex: `npx skills add WILLOSCAR/research-units-pipeline-skills --skill synthesis-writer -g -a codex -y`
Cursor: `npx skills add WILLOSCAR/research-units-pipeline-skills --skill synthesis-writer -g -a cursor -y`
Gemini CLI: `npx skills add WILLOSCAR/research-units-pipeline-skills --skill synthesis-writer -g -a gemini-cli -y`

## Description

Use when `evidence-review` has completed extraction and needs a bounded narrative synthesis.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Synthesis Writer

## Triggers & routing

- **Trigger**: synthesis, evidence synthesis, systematic review writing, 综合写作, SYNTHESIS.md.
- **Use when**: `evidence-review` 完成 screening+extraction（含 bias 评估）后进入写作阶段（C5）。
- **Skip if**: 还没有 `papers/extraction_table.csv`（或 protocol/screening 尚未完成）。
- **Network**: none.
- **Guardrail**: 以 extraction table 为证据底座；明确局限性与偏倚；不要在无数据支撑时扩写结论。


Transforms the extraction table into the final `evidence-review` narrative.

## Input

- `papers/extraction_table.csv`

Optional:
- `output/PROTOCOL.md`
- `DECISIONS.md`

## Output

- `output/SYNTHESIS.md`

## Contract

The synthesis must include stable sections:
- `## Included studies summary`
- `## Findings by theme`
- `## Risk of bias`
- `## Supported conclusions`
- `## Needs more evidence`

## Script boundary

`scripts/run.py` should:
- summarize extracted evidence conservatively
- keep conclusions bounded by table contents
- render the stable section structure

It should not invent findings not grounded in the extraction table.

## Acceptance

- output exists
- includes all stable sections
- stays table-grounded and bounded

## Non-goals

- upstream extraction repair
- free-form speculative discussion