Agent-Skills.md

Agent Skills: Protocol Writer

Use when `evidence-review` needs an operational protocol before screening and extraction.

UncategorizedID: willoscar/research-units-pipeline-skills/protocol-writer
51039

Install this agent skill to your local

pnpm dlx add-skill https://github.com/WILLOSCAR/research-units-pipeline-skills/tree/HEAD/.codex/skills/protocol-writer

Skill Files

Browse the full folder contents for protocol-writer.

Download Skill

Loading file tree…

.codex/skills/protocol-writer/SKILL.md

Skill Metadata

Name
protocol-writer
Description
"Use when `evidence-review` needs an operational protocol before screening and extraction."

Protocol Writer

Triggers & routing

  • Trigger: protocol, PRISMA, systematic review, inclusion/exclusion, 检索式, 纳入排除.
  • Use when: evidence-review pipeline 的起点（C1），需要先锁定 protocol 再开始 screening/extraction。
  • Skip if: 不是做 evidence/systematic review（或 protocol 已经锁定且不允许修改）。
  • Network: none.
  • Guardrail: protocol 必须包含可执行的检索与筛选规则；需要 HUMAN 签字后才能进入 screening。

Transforms the review question into an executable evidence-review protocol.

Inputs

Required:

  • STATUS.md

Optional:

  • GOAL.md
  • DECISIONS.md
  • queries.md

Output

  • output/PROTOCOL.md

Contract

The protocol must contain:

  • review questions
  • source/search specification
  • inclusion and exclusion clauses with stable IDs
  • screening plan
  • extraction schema
  • bias plan
  • explicit HUMAN approval note

Script boundary

scripts/run.py should:

  • read current review context
  • materialize an operational protocol
  • write a stable extraction schema and clause IDs

It should not perform retrieval or screening itself.

Acceptance

  • output/PROTOCOL.md exists
  • includes extraction schema and protocol clause IDs
  • is operational enough for downstream screening

Non-goals

  • writing final synthesis prose
  • screening candidate papers