mcpField
P
protocol-writer

protocol-writer

github.com/willoscarProductivity51745 installsUpdated 3w ago
Repository

About protocol-writer

protocol-writer is a skill for turning a systematic-review question and review context into an operational protocol. It defines searchable sources, screening rules, extraction fields, and a human approval checkpoint before screening.

Key features

  1. 01Builds executable review protocols
  2. 02Defines search and screening rules
  3. 03Assigns stable clause IDs
  4. 04Specifies extraction and bias plans
  5. 05Requires human approval

Use cases

  1. 01Set review criteria before paper screening
  2. 02Prepare a protocol for evidence-review
  3. 03Standardize extraction across a review

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/willoscar/research-units-pipeline-skills --skill protocol-writer

After installing, type/protocol-writerin Claude Code to confirm it loaded.

Bundled filesscripts/run.py

Details

From the project README

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

Comments

Markdown supported