AI Newsletter Digest improvements: fixed QP soft line break decoding, URL extraction, and content cleaning

archive/inactive-skills/research/SKILL.md

@@ -0,0 +1,93 @@
+---
+name: research
+description: Deep research via Gemini CLI — runs in background sub-agent so you don't burn your Claude tokens.
+homepage: https://github.com/google/gemini-cli
+metadata: {"clawdbot":{"emoji":"🔬","requires":{"bins":["gemini"]}}}
+---
+
+# 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