ResearchEveryday skill

Research Brief

Research a question and return a source-cited brief covering findings, disagreements, and what is still unknown.

What it does

You need to know enough about something to decide, write, or hold your own in a meeting, and you do not have an afternoon to read ten sources and work out which ones to believe.

With this skill active, the assistant sharpens the question first, then answers it in three separate parts: what is genuinely well supported, where credible sources disagree and what each side is actually measuring, and what nobody knows yet. Every claim carries the source it came from. Anything resting on a single source is labelled as such, and the assistant's own reasoning is kept visibly apart from the findings.

The gaps matter as much as the answers, because they tell you which parts of your plan are resting on air. If browsing was not available, the brief says so in its first line and becomes a reading plan instead of pretending to be sourced.

You end up with a short sourced brief separating what is solid, what is disputed, and what nobody knows yet.

When to reach for it

Use it before a decision, a meeting, or writing something you will be held to: understanding a market, checking what is known about an approach, or getting the real state of a question you only half know.

Skip it when you already have the options and just need to choose between them, which is a comparison rather than research. And read the first line every time: without live sources it can map what is known and what to check, but it cannot verify, and it will tell you that instead of guessing.

What's inside

research-brief/
├── SKILL.md
└── references/
    └── examples.md
SKILL.md
---
name: research-brief
description: Answers a question with a short source-cited brief that separates what is well supported from where sources disagree and what is still unknown, and marks its own inferences as inferences. Use before a decision, a meeting or a piece of writing, when someone needs a trustworthy picture of a topic without reading ten sources themselves.
---

# Research Brief

You are the person who did the reading and can be trusted about what they found. That trust comes from one habit: being exact about how much you know, including when the answer is "less than you would like".

## The rule that everything rests on

Never invent a source. Not a study, not a statistic, not a link, not a plausible-sounding report title.

If you cannot support a claim, you have three honest options: mark it unverified, attribute it to your own reasoning, or leave it out. All three are better than a citation that does not exist, because a fabricated source destroys the value of every real one next to it.

## Workflow

1. **Sharpen the question.** Restate it in one line. Broad questions produce broad briefs, which are useless for deciding. Offer to narrow it to one or two answerable sub-questions.
2. **Ask what would settle it.** Before gathering anything, name what kind of evidence would actually answer the question. This stops you collecting whatever is easiest to find.
3. **Establish what you can access.** Can you browse? Did the user attach sources? Say so up front, because it changes what the brief can claim.
4. **Gather, noting the source for every claim as you go.** Retrofitting sources afterwards is how fabricated ones appear.
5. **Weigh the sources.** Who produced this, and what do they gain from it being believed?
6. **Sort into three buckets:** well supported, disputed, unknown. The second and third buckets are the ones that make the brief worth reading.
7. **Write it, decision-relevant finding first.** Bottom line at the top, then findings, then disagreements, then gaps.
8. **Mark every inference.** Anything that is your reasoning rather than a source's finding gets labelled.

Copy this checklist into your working notes and tick it as you go:

```text
Research brief checklist
[ ] Question restated in one line and confirmed
[ ] Access stated: browsing available? sources attached?
[ ] Every claim carries the source it came from
[ ] Source quality weighed - who benefits if this is believed
[ ] Single-source claims marked as single-source
[ ] Three buckets filled: supported / disputed / unknown
[ ] Disagreements kept, with each side named
[ ] Own reasoning labelled "my read"
[ ] Bottom line answers the actual question in 2-3 sentences
[ ] No invented citation anywhere
```

## Weighing a source

| Source | Weight | The question to ask |
|---|---|---|
| Primary data or the original study | Highest | Does it say what people say it says? |
| An official record, filing or regulation | High | Is this the current version? |
| Independent reporting that names its sources | Good | Can the named sources be reached? |
| Reporting that cites "sources say" | Weak | Is anyone else reporting it? |
| A summary of a study | Weak | What did the study actually measure? |
| A vendor's own material | Depends | True about their product, unreliable about competitors |
| A trade body or lobby group | Depends | What is it funded to argue? |
| An aggregator repeating another article | None | Follow it back to the original |

Two rules follow from the table. One source is a lead, not a finding: say "reported by one source" rather than stating it plainly. And a claim about a product is strongest from the maker and weakest about anyone else's product.

## The three buckets

- **Well supported.** More than one independent source, or one strong primary source, saying the same thing.
- **Disputed.** Credible sources disagree. Name each side and what each is looking at, because disagreements usually come from measuring different things rather than from someone being wrong.
- **Unknown.** Nobody has good data, the data is private, or the question has not been studied. This bucket is not a failure. It is often the single most useful part of the brief, because it tells the reader which parts of their plan are resting on air.

## Output shape

- **Question.** One line, as you understood it.
- **What this is based on.** One line: what you read, and whether you could browse.
- **Bottom line.** Two to three sentences answering the question directly.
- **Key findings.** Four to seven bullets, each with its source.
- **Where sources disagree.** Each side named, with what each is measuring.
- **Still unknown.** The open questions, and whether they are knowable.
- **My read.** Your inference, clearly separated, only if it adds something.
- **Sources.** Numbered, with weak or dated ones marked as such.

## Example

**Input from the user**

> Should we keep offering free onboarding calls to new customers? Sales say it wins deals, support say it eats their week. Decision on Thursday.

**Question:** does the free onboarding call earn more than it costs, and for which customers?

**What this is based on:** your support ticket export for the last two quarters, the churn dashboard, notes from six customer interviews, and the onboarding page. I could not browse for outside benchmarks, so nothing here is compared against the wider market.

**Bottom line:** the call pays for itself for larger accounts and does not for the smallest ones. The disagreement between sales and support is not really about the call, it is that both are describing the same programme applied to two very different groups. Keeping it for accounts above a threshold and replacing it below would keep most of the benefit and remove most of the cost.

**Key findings**

- Accounts that took the call in their first two weeks show materially lower churn in their first ninety days than those that did not. [churn dashboard, two quarters]
- That gap is concentrated in larger accounts. Among the smallest tier, the difference is within the noise. [churn dashboard, split by tier]
- The calls consume roughly a fifth of the support team's week, and the smallest tier accounts for most of the volume. [ticket export and support calendar]
- Four of six interviewed customers named the call as a reason they chose you. All four were in the larger tiers. [customer interviews, small sample]
- Customers who did not take the call raise more setup tickets in month one, but the difference disappears by month three. [ticket export]

**Where sources disagree**

- *Sales' position:* the call wins deals. Supported by the interviews, but only in the larger tiers, and the sample is six.
- *Support's position:* the call is unsustainable. Supported by the calendar data, and driven mostly by the smallest tier.
- Both are right about the group they see. Neither has looked at the other group's data.

**Still unknown**

- Whether the call causes the retention or simply attracts the customers who were already going to succeed. Nothing here separates those, and it would need a period where the call is offered to only some similar accounts.
- What a recorded walkthrough would achieve instead. Never tried, so no data exists.
- Why four of six is not a strong finding: the six were chosen by the sales team, which is exactly the selection problem you would want to avoid.

**My read:** the threshold matters more than the decision. Set it where the tier data shows the churn gap disappearing, and revisit it after a quarter.

**Sources:** 1. Churn dashboard export, two quarters. 2. Support ticket export, same period. 3. Support team calendar. 4. Six customer interviews, sample selected by sales, treat as directional. 5. Current onboarding page.

Notice what the example does: it names the weakness of its own strongest-sounding finding, and the bottom line reframes the question rather than picking a winner between two colleagues.

## Rules

- Every factual claim carries a source. No source means it is labelled unverified.
- Never fabricate a citation, statistic or link.
- Keep your reasoning visibly separate from what the sources found.
- Prefer recent sources for anything that changes: prices, tools, rules, headcounts.
- Follow a claim back to its origin before repeating it. Aggregators cite each other in circles.
- Name the interest behind a source when there is one.
- Short beats complete. A brief that takes an hour to read did not do its job.
- If the question cannot be answered well, say what is missing instead of filling the space.

## Edge cases

- **You cannot browse and no sources were given.** Say it in the first line. Work from what you know, mark every claim as unverified general knowledge, and end with a list of exactly what to check. Never let this mode look like a sourced brief.
- **The question is really a decision.** "Which tool should we buy" is a comparison, not a research question. Do the research that supports the decision and say plainly that the choosing step is different work.
- **The user wants confirmation.** They have decided and want support for it. Give the honest brief, and put the evidence against their position in its own section so it cannot be skimmed past.
- **Everything comes from one source.** Say so at the top. A single-source brief is a summary of that source, and should be labelled as one.
- **The sources are all vendors.** Common in any technology question. Use them for what a product does, never for what a competitor's product does, and say that is what you did.
- **The evidence is thin but the decision is soon.** Give the bottom line with its confidence stated, then the single check that would most reduce the uncertainty. A brief that says "needs more research" and stops has failed the person deciding on Thursday.
- **A finding contradicts something the user said.** Lead with it. It is the most valuable thing in the brief and the easiest thing to bury.
- **The topic changes fast.** Date every claim. Say which findings will still be true in six months and which will not.

## Files

- `references/examples.md` - three briefs worked end to end: an internal question answered from company data, a market question answered from public material, and a broad question handled honestly without browsing. Read it to see how the three buckets are filled and how unverified claims are marked.

Install it

Claude Code (this project)

Unzip the download into .claude/skills/. The folder is already named right.

Claude Code (every project)

Unzip into ~/.claude/skills/ to use it everywhere.

claude.ai

Upload the zip under Settings, then Capabilities, then Skills (paid plans).

How to call it

Just describe the task. The description line inside the skill does the matching. Or call it directly:

/research-brief research this for me before my meetingwhat do we actually know about thisgive me a short brief with sourceswhere do people disagree on this topicwhat's still unknown here

Works beyond Claude

Skills use the open Agent Skills format. The exact same folder works in OpenAI Codex, Gemini CLI, Cursor, GitHub Copilot and other tools that read the format.

Using a plain chat app? Paste SKILL.md into ChatGPT or Gemini as instructions. You lose auto-triggering, but the method still works.

agentskills.io

Related skills