research

# Research Skill Conduct deep research on any topic using Gemini CLI via a spawned sub-agent. Uses your Google AI subscription instead of Claude tokens — perfect for long research tasks that would otherwise eat your Clawdbot usage. ## How It Works **When user says "Research: [topic]" or asks for deep research:** ### Step 1: Clarifying Questions (Always) Before running any research, ask 2-3 quick questions to focus the work: **Start with the goal:** > "Before I dive in - what's your goal here? Are you learning about this topic, making a decision, writing something, or just curious?" **Then adapt based on their answer:** If learning/curious: - "Any specific aspect you're most interested in?" - "How technical should I go? (High-level overview vs deep technical detail)" If decision-making: - "What decision are you trying to make?" - "Any specific criteria or constraints I should focus on?" If writing/creating: - "What's the output? (Blog post, report, presentation?)" - "Who's the audience?" **Keep it natural — 2-3 questions max.** Don't interrogate. ### Step 2: Spawn Research Agent Once you have context, use `sessions_spawn` to run the research: ``` sessions_spawn( task: "Research: [FULL TOPIC WITH CONTEXT] Use Gemini CLI to research this topic. Run: gemini --yolo \"[RESEARCH PROMPT]\" The research prompt should ask Gemini to cover: 1. Overview & Core Concepts - what is this, terminology, why it matters 2. Current State - latest developments, major players 3. Technical Deep Dive - how it works, mechanisms, key techniques 4. Practical Applications - real-world use cases, tools available 5. Challenges & Open Problems - technical, ethical, barriers 6. Future Outlook - trends, predictions, emerging areas 7. Resources - key papers, researchers, communities, courses Save the output to: ~/clawd/research/[slug]/research.md Be thorough (aim for 500+ lines). Include specific examples and citations. IMPORTANT - When research is complete: 1. Send a wake event to notify the main agent immediately: cron(action: 'wake', text: '🔬 Research complete: [TOPIC]. Key findings: [2-3 bullet points]. Full report: ~/clawd/research/[slug]/research.md', mode: 'now') 2. When asked to produce an announce message, reply exactly: ANNOUNCE_SKIP", label: "research-[slug]" ) ``` **Important:** Include all context from your conversation in the task so the sub-agent understands the full picture. ### Step 3: When You Receive Wake Event You'll receive a wake with the research summary. Then: - Share the findings with the user - Offer to read the full report or dive deeper on sections ## Output Location Research saved to: ``` ~/clawd/research/<slug>/research.md ``` ## Tips - Research typically takes 3-8 minutes depending on complexity - Gemini CLI uses your Google AI subscription quota - The `--yolo` flag auto-approves file operations (non-interactive) - Check `~/clawd/research/` for all past research - Always include conversation context in the spawn task for better results