Research Synthesis skill for Codex

From a pile of findings to one defensible call. Codex inventories every source and its quality, breaks the material into atomic findings tagged by source, and clusters them into themes weighted by convergence, behaviour over opinion, sample fit and recency. Contradictions are explained or carried forward, options are compared with evidence for and against, and the recommendation states its confidence and the signal that should reverse it.

  • Research
  • $research-synthesis
  • 159 lines
  • 2 files
  • ~1,550 tokens
  • MIT
  • Updated

Install

curl -fsSL codexskills.dev/install.sh \  | sh -s -- research-synthesis

Installs to ~/.agents/skills/research-synthesis/ for every project on this machine.

104-line POSIX script. No sudo, no telemetry. Read install.sh

Use it in Codex

Start a prompt with $research-synthesis, or pick it from /skills. You can also just describe the task: Codex reads the description below and loads the playbook when your request matches.

What Codex reads before loading it

Turns a pile of findings - interview notes, survey results, papers, benchmarks, analytics, vendor research - into a decision by weighing evidence quality, reconciling contradictions, separating facts from inferences, and writing a recommendation with options, trade-offs, confidence and what would change the answer. Use when asked to synthesize research, summarize what we learned into a recommendation, combine several reports or studies, or answer "so what should we do" from existing evidence.

Use it when

  • Research is done and someone needs a recommendation from it
  • Several studies or reports point in different directions
  • A decision needs its evidence, confidence and risks made explicit

Use something else when

How to check the result

Every insight traces to findings and every finding to a source, each option lists evidence against it, and the recommendation answers the stated decision.

The mistake it prevents

Letting a few vivid quotes outweigh behavioural data, or quietly dropping the finding that contradicts the preferred option.

~/.agents/skills/research-synthesis/SKILL.md

--- name: research-synthesis description: Turns a pile of findings - interview notes, survey results, papers, benchmarks, analytics, vendor research - into a decision by weighing evidence… license: MIT ---

Synthesis is finished when a decision-maker can act on one page: the recommendation, the two or three findings it rests on, how strong that evidence is, the main risk, and what evidence would reverse it. Summarising each source in turn is not synthesis.

Inputs check

Before writing anything, inventory the evidence:

| ID | Source | Type | Date | n / scope | Quality notes |
|---|---|---|---|---|---|
| S1 | 12 customer interviews | qualitative | 2026-09 | mid-market admins | recruited from churned accounts |
| S2 | In-app survey | quantitative | 2026-10 | 840 responses, 6% rate | opt-in |
| S3 | Usage analytics | behavioural | last 90 d | all 4,100 accounts | export events only |
| S4 | Two competitor teardowns | secondary | 2026-08 | - | public pages |

Then pin the decision: what choice, by whom, by when, and what options are on the table. If no decision is defined, ask; synthesis without a decision drifts into a report.

Workflow

- [ ] 1. Inventory sources and rate their quality
- [ ] 2. Extract atomic findings with source IDs
- [ ] 3. Cluster findings into themes
- [ ] 4. Weigh: convergence, quality, relevance
- [ ] 5. Resolve or explain contradictions
- [ ] 6. Write insights (finding + implication)
- [ ] 7. Map insights to options; recommend
- [ ] 8. State confidence, risks, and reversal conditions

2. Atomic findings

One observation per line, in neutral language, tagged with its source. Keep the raw evidence pointer (quote ID, chart, table).

F1 [S1] 7 of 12 admins export to spreadsheets weekly to build reports for finance.
F2 [S3] 31% of active accounts used CSV export at least once in 90 days.
F3 [S2] "Reporting" ranked 4th of 6 in requested improvements.
F4 [S4] Both main competitors ship scheduled reports on mid-tier plans.

3-4. Themes and weighing

Group findings that point the same way. For each theme, weigh the evidence:

FactorStrongerWeaker
ConvergenceDifferent methods agree (interviews + analytics)One method only
Behaviour vs opinionWhat people did (logs, purchases)What people say they would do
SampleRepresentative of the decision’s populationConvenience or skewed recruit
RecencyAfter the last relevant product or market changeBefore it
Effect sizeLarge and practicalStatistically detectable but small
IndependenceSeparate teams, sources, methodsSame source reused

Triangulation is the core move: a theme supported by behavioural data and qualitative explanation from different sources is worth more than ten quotes saying the same thing.

5. Contradictions

When findings conflict (survey ranks reporting low; interviews say it is painful):

  1. Check populations: do the sources describe the same people? (S1 recruited churned accounts; S2 is active users.)
  2. Check measures: stated priority vs observed workaround behaviour measure different things.
  3. Check timing and definitions.
  4. If explained, state the explanation as an insight. If not, carry it forward as an open question with the evidence that would settle it.

Never drop the inconvenient finding.

6. Insights

An insight pairs a finding with why it matters for the decision:

**Reporting pain drives churn among admins who answer to finance, not the general base.**
Workaround exports are common (31% of accounts, F2) and interviewees describe them as a
weekly chore (F1), yet active users rank reporting 4th (F3). The pain concentrates in
accounts with a finance stakeholder, the segment over-represented in churned interviews.
Confidence: moderate (two methods; interview sample skewed toward churned accounts).

Label inferences as inferences. Keep facts (“31% exported”) separate from interpretations (“they export because reports are missing”).

7. Options and recommendation

Lay out 2-4 real options, including “do nothing” when plausible, against the criteria that matter for this decision:

OptionAddressesCost / effortRiskEvidence forEvidence against
A Scheduled reportsF1, F2, F4~6 weeksLow adoption outside finance-linked accountsS1, S3S2
B Better CSV exportF2~1 weekLeaves the chore in placeS3S1
C Do nothing-0Continued churn in that segment-S1

Recommend one, say why it beats the runner-up, and name the cheapest way to test it before full commitment (pilot, fake door, limited rollout).

8. Confidence and reversal

  • Overall confidence: high / moderate / low, with the one or two reasons.
  • Key assumption: the belief that, if false, changes the recommendation.
  • Reversal signal: the observation that should make the team change course, and when to check for it.

Gotchas

  • Frequency is not importance: the most mentioned theme may be the easiest to articulate, not the costliest problem.
  • Vivid quotes persuade beyond their weight. Use them to illustrate a theme already supported by broader evidence, never as the evidence.
  • Confirmation pull: list the evidence against the recommendation explicitly; if that column is empty, look again.
  • Mixing segments hides the signal; split findings by segment when sources differ.
  • Stale research: findings from before a major product or market change need re-checking.
  • For a formal decision document format, hand the result to $decision-memos; for interview-specific affinity mapping use $user-research-synthesis.

Verification

  • Every insight cites findings, and every finding cites a source ID.
  • Each option row lists evidence for and against.
  • A reader who disagrees can see exactly which finding they would need to dispute.
  • The recommendation answers the decision stated at the start, by the stated deadline.

Output template

# <Decision>: synthesis and recommendation
**Recommendation:** <option> - <one-sentence why>  **Confidence:** moderate
**Decide by:** <date> | **Owner:** <name>

## What we know (insights)
1. <Insight> (F#, F#) - confidence
2. ...

## Where evidence conflicts

## Options compared
<table>

## Risks and the assumption that matters most
## What would change this recommendation
## Next step to de-risk
## Appendix: sources and findings

What the zip contains

SKILL.md plus the interface file below. Nothing runs on install.

agents/openai.yamlgenerated from this page

Gives the Codex app a display name, a one-line description and a starter prompt for this skill.

interface:
  display_name: "Research Synthesis"
  short_description: "From a pile of findings to one defensible call"
  default_prompt: "$research-synthesis Synthesise these interview notes, the survey export and our usage data into a recommendation"

About this skill

Written and maintained by the Codex Skills editors to the same editorial standard as every skill here: a selective description, a real workflow, known pitfalls and a way to verify the work. First published , last updated . MIT licensed. Something wrong or out of date? Tell us.

esc
New

Introducing Codex Skills Pro

79 professional skills that take Codex through complete engagements, each with its own scripts, references and a report that verifies the result.

All-AccessOne-time payment, no subscription
$49
Get All-AccessOr browse individual skills from $2.99 →

Secure checkout by Creem