deep-research
The deep-research skill automates comprehensive research workflows by planning searches, reading sources, and synthesizing findings into detailed reports using the Gemini API. Use this skill for market analysis, competitive landscaping, literature reviews, technical research, and due diligence when you need cited, multi-source reports that take 2-10 minutes to complete.
git clone --depth 1 https://github.com/davila7/claude-code-templates /tmp/deep-research && cp -r /tmp/deep-research/cli-tool/components/skills/ai-research/deep-research ~/.claude/skills/deep-researchSKILL.md
# Gemini Deep Research Skill Run autonomous research tasks that plan, search, read, and synthesize information into comprehensive reports. ## When to Use This Skill Use this skill when: - Performing market analysis - Conducting competitive landscaping - Creating literature reviews - Doing technical research - Performing due diligence - Need detailed, cited research reports ## Requirements - Python 3.8+ - httpx: `pip install -r requirements.txt` - GEMINI_API_KEY environment variable ## Setup 1. Get a Gemini API key from [Google AI Studio](https://aistudio.google.com/) 2. Set the environment variable: ```bash export GEMINI_API_KEY=your-api-key-here ``` Or create a `.env` file in the skill directory. ## Usage ### Start a research task ```bash python3 scripts/research.py --query "Research the history of Kubernetes" ``` ### With structured output format ```bash python3 scripts/research.py --query "Compare Python web frameworks" \ --format "1. Executive Summary\n2. Comparison Table\n3. Recommendations" ``` ### Stream progress in real-time ```bash python3 scripts/research.py --query "Analyze EV battery market" --stream ``` ### Start without waiting ```bash python3 scripts/research.py --query "Research topic" --no-wait ``` ### Check status of running research ```bash python3 scripts/research.py --status <interaction_id> ``` ### Wait for completion ```bash python3 scripts/research.py --wait <interaction_id> ``` ### Continue from previous research ```bash python3 scripts/research.py --query "Elaborate on point 2" --continue <interaction_id> ``` ### List recent research ```bash python3 scripts/research.py --list ``` ## Output Formats - **Default**: Human-readable markdown report - **JSON** (`--json`): Structured data for programmatic use - **Raw** (`--raw`): Unprocessed API response ## Cost & Time | Metric | Value | |--------|-------| | Time | 2-10 minutes per task | | Cost | $2-5 per task (varies by complexity) | | Token usage | ~250k-900k input, ~60k-80k output | ## Best Use Cases - Market analysis and competitive landscaping - Technical literature reviews - Due diligence research - Historical research and timelines - Comparative analysis (frameworks, products, technologies) ## Workflow 1. User requests research → Run `--query "..."` 2. Inform user of estimated time (2-10 minutes) 3. Monitor with `--stream` or poll with `--status` 4. Return formatted results 5. Use `--continue` for follow-up questions ## Exit Codes - **0**: Success - **1**: Error (API error, config issue, timeout) - **130**: Cancelled by user (Ctrl+C)
Testing and benchmarking LLM agents including behavioral testing, capability assessment, reliability metrics, and production monitoring—where even top agents achieve less than 50% on real-world benchmarks Use when: agent testing, agent evaluation, benchmark agents, agent reliability, test agent.
Use this agent when creating specialized Claude Code agents for the claude-code-templates components system. Specializes in agent design, prompt engineering, domain expertise modeling, and agent best practices. Examples: <example>Context: User wants to create a new specialized agent. user: 'I need to create an agent that specializes in React performance optimization' assistant: 'I'll use the agent-expert agent to create a comprehensive React performance agent with proper domain expertise and practical examples' <commentary>Since the user needs to create a specialized agent, use the agent-expert agent for proper agent structure and implementation.</commentary></example> <example>Context: User needs help with agent prompt design. user: 'How do I create an agent that can handle both frontend and backend security?' assistant: 'Let me use the agent-expert agent to design a full-stack security agent with proper domain boundaries and expertise areas' <commentary>The user needs agent development help, so use the agent-expert agent.</commentary></example>
Create, manage, and orchestrate AI agents using the AI Maestro CLI. Use when the user asks to "create agent", "list agents", "delete agent", "hibernate agent", "wake agent", "install plugin", "show agent", "restart agent", or any agent lifecycle management task.
Manage multiple local CLI agents via tmux sessions (start/stop/monitor/assign) with cron-friendly scheduling.
A hybrid memory system that provides persistent, searchable knowledge management for AI agents (Architecture, Patterns, Decisions).
Memory is the cornerstone of intelligent agents. Without it, every interaction starts from zero. This skill covers the architecture of agent memory: short-term (context window), long-term (vector stores), and the cognitive architectures that organize them. Key insight: Memory isn't just storage - it's retrieval. A million stored facts mean nothing if you can't find the right one. Chunking, embedding, and retrieval strategies determine whether your agent remembers or forgets. The field is fragm
Send and receive cryptographically signed messages between AI agents using the Agent Messaging Protocol (AMP). Use when the user asks to "send a message to an agent", "check agent inbox", "message another agent", "reply to a message", "notify an agent", or any inter-agent communication task.
Tools are how AI agents interact with the world. A well-designed tool is the difference between an agent that works and one that hallucinates, fails silently, or costs 10x more tokens than necessary. This skill covers tool design from schema to error handling. JSON Schema best practices, description writing that actually helps the LLM, validation, and the emerging MCP standard that's becoming the lingua franca for AI tools. Key insight: Tool descriptions are more important than tool implementa