A research report skill with a fact-check before writing

---
name: research-report
description: Researches a question from four angles in parallel, fact-checks every claim against its source in a fresh context, and writes a sourced report.
spec: skill-graph/1
topology:
  nodes:
    - id: goal
      type: input
      label: RESEARCH QUESTION
    - id: splitter
      type: orchestrator
      label: SPLIT
      model: sonnet
      tools:
        - Read
    - id: sources
      type: worker
      label: Primary Sources
      model: haiku
      tools:
        - Read
        - WebSearch
        - WebFetch
    - id: figures
      type: worker
      label: Figures & Data
      model: haiku
      tools:
        - Read
        - WebSearch
        - WebFetch
    - id: counterpoints
      type: worker
      label: Counterpoints
      model: haiku
      tools:
        - Read
        - WebSearch
        - WebFetch
    - id: open_questions
      type: worker
      label: Open Questions
      model: haiku
      tools:
        - Read
        - WebSearch
        - WebFetch
    - id: verifier
      type: verifier
      label: VERIFIER (Fresh Context)
      isolated_context: true
      model: opus
      tools:
        - Read
        - Grep
        - Glob
      gate: Every kept claim names a source that says it, and every figure has a date.
      on_fail: retry
      max_retries: 1
    - id: merger
      type: synthesizer
      label: FINAL ANSWER
      model: sonnet
      tools:
        - Read
  edges:
    - from: goal
      to: splitter
    - from: splitter
      to:
        - sources
        - figures
        - counterpoints
        - open_questions
      contract: subtask_json
    - from:
        - sources
        - figures
        - counterpoints
        - open_questions
      to: verifier
      contract: research_findings
    - from: verifier
      to: merger
      contract: checked_findings
contracts:
  subtask_json:
    format: json
    description: One key per worker id; each value is that worker's task.
  research_findings:
    format: markdown
    description: A numbered list of claims; every claim has its source, a short quote and a confidence of high, medium or low.
  checked_findings:
    format: markdown
    description: Only the claims a cited source supports, then the rejected claims with the reason.
---

# Node Prompts & Edge Contracts

## @node: splitter
You are the research lead. Turn the question into four research tasks, one per angle, each saying what to look for and how recent it must be.

Input:
{{goal}}

Output strictly as JSON with one key per worker: `sources`, `figures`, `counterpoints`, `open_questions`. Each value is the exact task for that worker.

## @node: sources
Find ONLY primary sources: official documents, papers, datasets and first-hand accounts, with what each one says.

Your task: {{splitter.sources}}

Return findings as a numbered list. For each one give the source (title and URL), what it says in a short quote, and a confidence of high, medium or low.

## @node: figures
Collect ONLY figures: statistics, dates, prices and measurements, each with where it comes from and how recent it is.

Your task: {{splitter.figures}}

Return findings as a numbered list. For each one give the source (title and URL), what it says in a short quote, and a confidence of high, medium or low.

## @node: counterpoints
Look ONLY for disagreement: credible sources that contradict the obvious answer, and the reasons they give.

Your task: {{splitter.counterpoints}}

Return findings as a numbered list. For each one give the source (title and URL), what it says in a short quote, and a confidence of high, medium or low.

## @node: open_questions
Find ONLY what is unknown or disputed: gaps in the evidence and claims that nobody has checked.

Your task: {{splitter.open_questions}}

Return findings as a numbered list. For each one give the source (title and URL), what it says in a short quote, and a confidence of high, medium or low.

## @node: verifier
You are a fact-checker. Check each claim against the source it cites; reject claims whose source does not say it or is not named.

You only see the raw worker outputs below, not their reasoning. Drop any claim without concrete evidence, merge duplicates, and mark what you rejected and why.

Original input: {{goal}}

Worker outputs:
{{workers.output}}

## @node: merger
Write the research report in Markdown: the answer in two sentences, Key findings with their sources, Where sources disagree, Open questions, and a list of Sources.

{{verifier.output}}