Index of every page on this site: llms.txt
All skills
coreyhaines31 avatar

/deep-research

@4cb94db
Run it yourself

When you want multi-source, multi-step research on a topic — competitor research before a sales call, market research for a new business idea, positioning angles, due diligence on a partnership or podcast guest, tech decision research (which DB, which auth), or any "I need to actually understand X." Combines web search, URL fetch, agent-browser, last30days (Reddit/X/YouTube/HN/web recency), memory, and Notion. Outputs a structured brief with citations, contradictions, gaps, and recommended next steps. Archives every research run to ~/.config/makerskills/deep-research/archive/ so past work is searchable. Triggers on "/deep-research," "research X," "investigate X," "do a deep dive on X," "look into X," "what's actually happening with X," "due diligence on X," "validate this market." Differs from a one-shot web search: this is multi-pass with verification. Not for standing monitoring (radar) or pulling one post or video (social-fetch, watch-video).

Requires /domain
Use this Skill: https://skilld.dev/gh/coreyhaines31/makerskills/deep-research

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈244 tokens for metadata: the name and description. ≈1.2k when used: this file.

Description uses 12.2% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈975 characters, or 12.2%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

/deep-research — Multi-source research with archive

Plans, executes, and synthesizes research from multiple sources. Archives the output so the corpus compounds.

Step 1 — Frame the question

Restate the research question in one tight sentence. If ambiguous, ask the user:

  • What's the decision this research will inform?
  • What's the minimum useful answer? (Saves over-researching.)
  • Any sources to prioritize or avoid?

Output: **Research question:** <one sentence>

Step 2 — Plan the sources

Pick from this menu based on the question type. Note which sources you'll hit and why.

Source When to use How (tool names vary by agent)
Web search (Google) Authoritative articles, docs, official statements Your agent's web search (e.g. WebSearch in Claude Code)
/last30days What people are actually saying right now — Reddit, X, YouTube, HN, web recency The last30days skill, if installed. Otherwise skip it and note the gap
Specific URLs When the user hands over starting URLs Your agent's URL fetch (e.g. WebFetch), or curl + defuddle
Browsable pages (auth-walled, JS-heavy) Pricing pages, product tours, profiles agent-browser CLI (any agent with a shell)
Memory Prior research / decisions / context the user already captured your agent's memory, or grep ${MAKERSKILLS_MEMORY:-${MAKERSKILLS_CONFIG:-$HOME/.config/makerskills}/memory}/
Notion If the topic touches a known Notion workspace Direct Notion API (key in $NOTION_API_KEY, see reference_notion_api.md)
Research archive Prior /deep-research runs that touched this topic grep ${MAKERSKILLS_CONFIG:-$HOME/.config/makerskills}/deep-research/archive/

Run discovery passes in parallel where possible. Sequential only when one source needs another's output (e.g., agent-browser a URL discovered by web search).

Step 3 — Execute discovery

Run each chosen source. For each result, capture:

  • The source (URL or system)
  • 1–3 sentence summary of what was said
  • Date / recency
  • Confidence in the source (high/medium/low)

Don't synthesize yet — just collect.

Step 4 — Synthesize

  1. Group findings by theme or sub-question
  2. Contradiction check — flag anywhere sources disagree. Don't average them; surface the disagreement.
  3. Confidence: high (multiple independent sources agree), medium (one strong source or several weak), low (single anecdote or speculation)
  4. Gaps: what would change the answer? What's NOT in the corpus?

Step 5 — Output the brief

Use this template:

# Research: <question>

**Date:** <YYYY-MM-DD>
**Decision this informs:** <one line>
**Confidence overall:** high / medium / low

## TL;DR
<2–4 sentences with the answer>

## Key findings

### 1. <Finding>
<2–4 sentences>. Sources: [1], [3], [5]

### 2. <Finding>
...

## Contradictions / uncertainty
- <where sources disagree, with each side cited>

## Gaps
- <what's missing from the corpus>
- <what to research next to close the gap>

## Recommended next steps
1. <action>
2. <action>

## Sources
[1] <Title> — <URL or system> (<date>) — <confidence>
[2] ...

Step 6 — Archive

Archives live in ${MAKERSKILLS_CONFIG:-$HOME/.config/makerskills}/deep-research/archive/ (create the directory if missing). Never write archives inside the skill's own folder — skill installs and upgrades re-sync from source and wipe anything saved there. Migration: if this skill's folder contains an old references/research-archive/ with user entries, move those files into the archive directory first.

Write the brief to <archive dir>/<YYYY-MM-DD>-<slug>.md so it's grep-able forever. Slug = kebab-case of the topic.

Also append a one-line entry to <archive dir>/INDEX.md (create if missing):

- 2026-06-15 — [<topic>](./<filename>.md) — <one-line TL;DR>

Step 7 — Surface

After archiving:

  • Show the full brief in chat
  • Tell the user the archive path
  • Offer: "Push to Notion or save to a project's docs?"

Composes with

  • business-brainstorm — calls this skill during the market validation step
  • /domain — when research includes "is the .com available"
  • /last30days — one of the data sources

Notes on quality

  • Always cite. Every claim in the brief needs a source pointer.
  • Recency matters — note dates on each source. For fast-moving topics (AI, startups), de-weight sources >12 months old.
  • Don't trust a single source for high-stakes claims. Re-search until you have at least 2 independent corroborations or surface the uncertainty.
  • No padding. If the answer is one paragraph, return one paragraph. The template is a maximum, not a minimum.

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

1 warning28d3 checks · Risk SAFE
  • Gen Agent Trust Hub28d

    The skill is a multi-source research tool that fetches data from various external platforms including social media and the open web. The primary security risk is indirect prompt injection, as malicious instructions embedded in retrieved web content could potentially influence the agent's synthesis or actions. The skill also performs local file operations and executes shell commands for data retrieval.

  • Socket28d

    No alerts

  • Snyk28d

    Risk: MEDIUM · 1 issue

Signed by skilld at 4cb94db. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated last month
metadata
{
  "version": "0.2.1"
}

README badge

README badge for coreyhaines31/makerskills/deep-research