deep-research

Conducts multi-source research and synthesizes findings into cited, archived briefs.

Updated Aug 13, 2026
One-click install
npx skills add https://github.com/imMamdouhaboammar/marketing-skills --skill deep-research-immamdouhaboammar
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: deep-research
Source: https://github.com/imMamdouhaboammar/marketing-skills/tree/main/skills/deep-research
Command: npx skills add https://github.com/imMamdouhaboammar/marketing-skills --skill deep-research-immamdouhaboammar

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? One-shot web searches give shallow, unverified answers. This Skill runs multi-pass research across web search, social recency sources, memory, and Notion, then synthesizes findings with citations, contradictions, and confidence levels so decisions rest on corroborated evidence. ## Core Features & Use Cases - Multi-source discovery: Combines WebSearch, WebFetch, agent-browser, /last30days (Reddit/X/YouTube/HN), local memory, and Notion, running independent passes in parallel. - Structured synthesis: Groups findings by theme, flags contradictions between sources, assigns confidence levels, and lists gaps and recommended next steps. - Persistent archive: Writes every brief to a dated, grep-able archive directory with an INDEX.md so past research compounds and stays searchable. - Use Case: Before a sales call, ask for a deep dive on a competitor and receive a cited brief covering their positioning, recent community sentiment, and open questions. ## Quick Start Ask the agent to do a deep dive on a topic, for example: research the current state of vector databases and tell me which one fits a small startup.

Frequently Asked Questions about deep-research

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run multi-source research with an AI agent?

Invoke the deep-research skill with a topic, such as "research X" or "do a deep dive on X". It plans sources, runs discovery passes across web search, social recency, memory, and Notion, then returns a cited brief with confidence levels.

What sources does deep research use for competitor analysis?

It combines WebSearch for authoritative articles, WebFetch for specific URLs, agent-browser for JS-heavy or auth-walled pages, /last30days for Reddit, X, YouTube, and HN recency, plus local memory and Notion workspaces.

How is deep research different from a single web search?

A single WebSearch is one-shot and unverified. Deep research is multi-pass: it cross-checks claims across at least two independent sources, surfaces contradictions instead of averaging them, and assigns confidence ratings to each finding.

Where are deep research briefs saved and archived?

Briefs are written to ~/.config/makerskills/deep-research/archive/ as dated markdown files with a kebab-case slug, plus a one-line entry in INDEX.md. Archives never live inside the skill folder, so upgrades do not wipe them.

Does deep research require a Notion API key?

No, Notion is optional. It is only queried when the topic touches a known Notion workspace and a NOTION_API_KEY environment variable is set. All other sources work without it.

When should I not use multi-step deep research?

Skip it for quick factual lookups answerable by one search. The skill itself warns against over-researching: if the minimum useful answer is a single paragraph, a one-shot WebSearch is the right tool.