a27e3b8e43
Optimized the root .gitignore to exclude virtual environments, node modules, and temp folders to ensure clean and lightweight version tracking. Co-authored-by: Cursor <cursoragent@cursor.com>
4.9 KiB
Deep Research Skill - Quick Start Guide
What is This?
A comprehensive research engine for Claude Code that matches and exceeds Claude Desktop's "Advanced Research" feature. It conducts enterprise-grade deep research with extended reasoning, multi-source synthesis, and citation-backed reports.
How to Use
Simple Invocation (Recommended)
Just ask Claude Code to use deep research:
Use deep research to analyze the current state of AI agent frameworks in 2025
Deep research: Should we migrate from PostgreSQL to Supabase?
Use deep research in ultradeep mode to review recent advances in longevity science
Direct CLI Usage
# Standard research (6 phases, ~5-10 minutes)
python3 ~/.claude/skills/deep-research/research_engine.py \
--query "Your research question" \
--mode standard
# Deep research (8 phases, ~10-20 minutes)
python3 ~/.claude/skills/deep-research/research_engine.py \
--query "Your research question" \
--mode deep
# Quick research (3 phases, ~2-5 minutes)
python3 ~/.claude/skills/deep-research/research_engine.py \
--query "Your research question" \
--mode quick
# Ultra-deep research (8+ phases, ~20-45 minutes)
python3 ~/.claude/skills/deep-research/research_engine.py \
--query "Your research question" \
--mode ultradeep
Research Modes Explained
| Mode | Phases | Time | Use When |
|---|---|---|---|
| Quick | 3 | 2-5 min | Initial exploration, simple questions |
| Standard | 6 | 5-10 min | Most research needs (default) |
| Deep | 8 | 10-20 min | Complex topics, important decisions |
| UltraDeep | 8+ | 20-45 min | Critical analysis, comprehensive reports |
What You Get
Every research report includes:
- Executive Summary - Key findings in 3-5 bullets
- Detailed Analysis - With full citations [1], [2], [3]
- Synthesis & Insights - Novel insights beyond sources
- Limitations & Caveats - What's uncertain or missing
- Recommendations - Actionable next steps
- Full Bibliography - All sources with credibility scores
- Methodology Appendix - How research was conducted
Output Location
All research is saved to:
~/.claude/research_output/
Format: research_report_YYYYMMDD_HHMMSS.md
Features That Beat Claude Desktop Research
✅ 8-Phase Pipeline - More thorough than Claude Desktop's approach ✅ Multiple Research Modes - Choose depth vs speed ✅ Source Credibility Scoring - Evaluates each source (0-100 score) ✅ Graph-of-Thoughts - Non-linear exploration with branching reasoning ✅ Citation Management - Automatic tracking and bibliography generation ✅ Critique Phase - Built-in red-team analysis of findings ✅ Refine Phase - Addresses gaps before finalizing ✅ Local File Integration - Can search your codebase/docs ✅ Code Execution - Can run analyses and validations
Example Use Cases
Technology Evaluation
Use deep research to compare Next.js 15 vs Remix vs Astro for my project
Market Analysis
Deep research: What are the key trends in longevity biotech funding 2023-2025?
Technical Decision
Use deep research to help me choose between Auth0, Clerk, and Supabase Auth
Scientific Review
Use deep research in ultradeep mode to summarize senolytics research progress
Competitive Intelligence
Deep research: Who are the top 5 competitors in the AI code assistant space?
Quality Standards
Every report guarantees:
- ✅ 10+ distinct sources (unless highly specialized topic)
- ✅ 3+ source verification for major claims
- ✅ Full citation tracking
- ✅ Credibility assessment for each source
- ✅ Limitations documented
- ✅ Methodology explained
Tips for Best Results
- Be Specific - "Compare X vs Y for use case Z" is better than "Tell me about X"
- State Your Goal - "Help me decide..." vs "Give me an overview..."
- Choose Right Mode - Use Quick for exploration, Deep for decisions
- Check Scope First - Review Phase 1 output to ensure on track
- Use Citations - Drill deeper by asking about specific sources [1], [2], etc.
Architecture
deep-research/
├── SKILL.md # Main skill definition (11KB)
├── research_engine.py # Core engine (16KB)
├── utils/
│ ├── citation_manager.py # Citation tracking (6KB)
│ └── source_evaluator.py # Credibility scoring (8KB)
├── README.md # Full documentation
├── QUICK_START.md # This guide
└── requirements.txt # No external deps needed!
No Dependencies Required!
The skill uses only Python standard library - no pip install needed for basic usage.
Version
v1.0 - Released 2025-11-04
Built to match and exceed Claude Desktop's Advanced Research feature.
Ready to use? Just type:
Use deep research to [your question here]
Claude Code will automatically load this skill and execute the research pipeline!