agentsclimarketplace

Research brief structure

Skill Solonnikov/agent-skills/skills/research-brief-structure

Produces research briefs that answer a question — sources, synthesis, gaps, recommendation — rather than summaries that describe a topic. Use when a user needs to research a decision, investigate a market or tool, understand an unfamiliar domain quickly, or present findings to a stakeholder who wants an answer, not a report.From its SKILL.md

Install
npx -y skills add Solonnikov/agent-skills --skill research-brief-structure

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

  • no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
  • 2 stars2 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

4.8 KB, ~1.1k tokens by cl100k_base, as published. Nobody here has run it

Research Brief Structure

A brief answers a question. A summary describes a topic. Knowing the difference saves a lot of wasted effort.

When to use

  • A user needs to decide something and wants grounded reasoning, not just "read these articles."
  • Evaluating a tool, vendor, market, or competitor.
  • Onboarding into an unfamiliar domain (technology, industry, topic) quickly.
  • Preparing for a stakeholder meeting where the deliverable is a recommendation, not a literature review.

Before you start

Nail down:

  1. The question. Specific, answerable, single. "Should we use Postgres or MongoDB?" is a question. "Database research" is not.
  2. The decision or action the brief supports. A brief with no downstream decision tends to be unfocused. "Pick one by Friday" focuses it.
  3. Audience. Technical peer, exec, cross-functional? Drives depth, vocabulary, how much context to include.
  4. Timebox. 1 hour? 1 day? 1 week? Scope matches the time.
  5. What's already been done. Prior briefs, opinions already formed, earlier research — skip relitigating, build on.

Authoring workflow

  1. Restate the question at the top, precisely. If you can't pin it down in one sentence, you don't know what you're researching.
  2. Gather sources. Cast wide, include varied viewpoints. Note for each: who, what claim, how credible. See source-evaluation.md.
  3. Synthesize. Don't list sources — extract claims, note agreement / contradiction, identify gaps. See synthesis-patterns.md.
  4. Identify gaps. What did you want to know but couldn't find? What would change the recommendation if discovered?
  5. Recommend. Take a position. Use the evidence; acknowledge uncertainty.
  6. Name the trigger to revisit. If you learned X, the recommendation would flip. Spell that out so the reader can act on it later.

The brief template

# Brief: [Question] — [YYYY-MM-DD]

## Question
[Restated in one sentence. Who needs the answer and by when.]

## Recommendation
[One sentence. Specific. "Use Postgres" not "Postgres looks good." Confidence level: high / medium / low.]

## Reasoning
[3–5 bullets with the strongest evidence. Each bullet cites source.]

## Alternatives considered
- [Option B] — pros, cons, why not.
- [Option C] — pros, cons, why not.

## Risks and mitigations
- [Top 2–3 risks of the recommendation. For each: how to mitigate.]

## Gaps
- [What you couldn't confirm. What would change the answer.]

## Trigger to revisit
[Specific event or data point that would cause re-evaluation.]

## Sources
- [Title] — [author / org] — [link] — [credibility note].
- [Title] — [author / org] — [link] — [credibility note].

Non-negotiable rules

  • Start with the recommendation. Busy readers don't read to the end. Lead with the answer; back it up below.
  • Specific recommendation, not vibes. "We should probably consider..." is not a recommendation. "Use X" is.
  • Cite what you claim. Every non-obvious assertion has a source. "Industry standard" is not a source.
  • Use primary sources when possible. Official docs > blog posts > tweets about blog posts about official docs.
  • Flag uncertainty explicitly. "I couldn't find benchmarks for X at scale" is stronger than hiding the gap.
  • Include dissenting evidence. If half of sources disagree with your recommendation, say so. Pretending the disagreement doesn't exist gets caught in review.
  • Time-bound the brief. "This was researched on YYYY-MM-DD" matters. Fast-moving topics (new tech, vendor features) may be stale in 6 months.
  • Don't write in meandering paragraphs. Bullets, tables, clear sections. Briefs are read fast; structure them for skimming.

Length

  • One page for decision briefs. Forces clarity.
  • Two pages max for complex topics.
  • Appendices for methodology, raw data, long quotes — but the front page stands alone.

Output

The brief itself, plus:

  • A 2-sentence TL;DR suitable for Slack / email.
  • A 15-minute "walk me through it" talking script if the reader wants to be briefed orally.

References

  • Brief template — the full template with a worked example.
  • Source evaluation — assessing credibility, primary vs secondary, spotting bias, red flags.
  • Synthesis patterns — how to turn raw notes into a coherent brief: agree/disagree, cluster, contradict, find gaps.

What ships with it: 3 files

16.2 KB alongside SKILL.md

Gives 0 of the 12 instructions most plan spec skills give in ~1.1k tokens

Counted across 1,099 of the 1,860 authors here whose files we hold, read 2026-08-07

  • Ask one question at a timein 51 of 1099
  • Break plans into vertical slicesin 29 of 1099, across 11 files
  • Publish issues in dependency orderin 27 of 1099, across 9 files
  • Iterate until user approves the breakdownin 25 of 1099, across 7 files
  • Explore the repository to understand the codebase statein 24 of 1099, across 7 files
  • Use domain glossary vocabularyin 23 of 1099, across 5 files
  • Apply correct triage labels to published issuesin 23 of 1099, across 5 files
  • Prefer AFK slices over HITLin 22 of 1099, across 7 files
  • Write a specification before writing any codein 22 of 1099, across 14 files
  • Write failing tests before implementation codein 22 of 1099, across 20 files
  • Ask clarifying questions until requirements are concretein 21 of 1099, across 13 files
  • Respect existing architecture decision recordsin 20 of 1099, across 5 files

Said here and by no other author read

  • Define a single answerable question before researching
  • Identify the downstream decision the brief supports
  • Determine the audience and timebox before starting
  • Restate the research question at the top
  • Synthesize source claims instead of listing sources
  • Lead the brief with the recommendation

Grouped from the skills themselves: near-identical wordings counted once, and counted by distinct author, so one author publishing three of these counts once. Length counted with cl100k_base; the agent that loads this file may tokenize it differently.

Keep looking

Skills are one crate of 326,835. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.