Matt Van Horn
71903b596f
Handle resolution was only triggering for "person/brand" topics. Products and tools like "Nano Banana Pro" or "Seedance" can also have X accounts (@nanobanana, @seedanceai) but were being skipped. Changes: - Broadened trigger: people, brands, products, tools, companies, communities - Added parody/fan account verification guidance - Added site:x.com to WebSearch query for better results - Updated both SKILL.md and OpenClaw variant Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
150 lines
4.4 KiB
Markdown
150 lines
4.4 KiB
Markdown
# One-Shot Research Mode
|
|
|
|
Research ANY topic across Reddit, X, YouTube, and the web. Surface what people are actually discussing, recommending, and debating right now.
|
|
|
|
## Parse User Intent
|
|
|
|
Before doing anything, parse the user's input for:
|
|
|
|
1. **TOPIC**: What they want to learn about
|
|
2. **TARGET TOOL** (if specified): Where they'll use the prompts
|
|
3. **QUERY TYPE**:
|
|
- **PROMPTING** — "X prompts", "prompting for X" → copy-paste prompts
|
|
- **RECOMMENDATIONS** — "best X", "top X" → list of specific things
|
|
- **NEWS** — "what's happening with X" → current events
|
|
- **GENERAL** — anything else → broad understanding
|
|
|
|
**Do NOT ask about target tool before research.** Run research first, ask after.
|
|
|
|
**Display your parsing** before calling tools:
|
|
|
|
```
|
|
I'll research {TOPIC} across Reddit, X, YouTube, and the web.
|
|
|
|
Parsed intent:
|
|
- TOPIC = {TOPIC}
|
|
- TARGET_TOOL = {TARGET_TOOL or "unknown"}
|
|
- QUERY_TYPE = {QUERY_TYPE}
|
|
|
|
Research typically takes 2-8 minutes. Starting now.
|
|
```
|
|
|
|
---
|
|
|
|
## Step 0.5: Resolve X Handle (if topic could have an X account)
|
|
|
|
If TOPIC looks like it could have its own X account - **people, creators, brands, products, tools, companies** (e.g., "Dor Brothers", "Nano Banana Pro", "Seedance"), do ONE quick WebSearch:
|
|
|
|
```
|
|
WebSearch("{TOPIC} X twitter handle site:x.com")
|
|
```
|
|
|
|
Extract their X handle from results (look for `x.com/{handle}` URLs or "@handle" mentions). **Verify it's the real account, not a parody/fan page** - check for verified status, official website links, consistent naming. If found, pass as `--x-handle={handle}` (no @). Skip if TOPIC is a generic concept (not an entity), already has @, uses `--quick`, or no official account exists.
|
|
|
|
---
|
|
|
|
## Research Execution
|
|
|
|
**Step 1: Run the research script (FOREGROUND)**
|
|
|
|
```bash
|
|
python3 "${SKILL_ROOT}/scripts/last30days.py" "$ARGUMENTS" --emit=compact --store 2>&1 # Add --x-handle=HANDLE if resolved
|
|
```
|
|
|
|
Use a **timeout of 300000** (5 minutes). The `--store` flag persists findings for watchlist/briefing integration.
|
|
|
|
The script auto-detects: API keys, Bird CLI, yt-dlp, web search backends.
|
|
|
|
**Read the ENTIRE output.** It contains Reddit, X, YouTube, AND web sections.
|
|
|
|
---
|
|
|
|
**Step 2: WebSearch (supplement)**
|
|
|
|
After the script finishes, use your WebSearch tool for additional coverage.
|
|
|
|
Choose queries based on QUERY_TYPE:
|
|
|
|
- **RECOMMENDATIONS**: `best {TOPIC} recommendations`, `{TOPIC} list examples`
|
|
- **NEWS**: `{TOPIC} news 2026`, `{TOPIC} announcement update`
|
|
- **PROMPTING**: `{TOPIC} prompts examples 2026`, `{TOPIC} techniques tips`
|
|
- **GENERAL**: `{TOPIC} 2026`, `{TOPIC} discussion`
|
|
|
|
Rules:
|
|
- **USE THE USER'S EXACT TERMINOLOGY**
|
|
- EXCLUDE reddit.com, x.com, twitter.com (covered by script)
|
|
- Do NOT output "Sources:" list
|
|
|
|
---
|
|
|
|
## Synthesis
|
|
|
|
**Judge Agent rules:**
|
|
1. Weight Reddit/X HIGHER (engagement signals)
|
|
2. Weight YouTube HIGH (views + transcript content)
|
|
3. Weight web LOWER (no engagement data)
|
|
4. Identify cross-source patterns (strongest signals)
|
|
5. Extract top 3-5 actionable insights
|
|
|
|
**Ground synthesis in ACTUAL research, not pre-existing knowledge.**
|
|
|
|
### Citation Rules
|
|
|
|
- Cite sparingly: 1-2 sources per topic
|
|
- Priority: @handles > r/subreddits > YouTube channels > web sources
|
|
- Use publication names, never raw URLs
|
|
- Lead with people, not publications
|
|
|
|
---
|
|
|
|
## Display Results
|
|
|
|
**1. "What I learned"** (format depends on QUERY_TYPE)
|
|
|
|
**If RECOMMENDATIONS** — show specific items with sources:
|
|
```
|
|
Most mentioned:
|
|
|
|
[Name] - {n}x mentions
|
|
Use Case: [what it does]
|
|
Sources: @handle1, r/sub, blog.com
|
|
```
|
|
|
|
**If PROMPTING/NEWS/GENERAL** — show synthesis:
|
|
```
|
|
What I learned:
|
|
|
|
**{Topic 1}** — [1-2 sentences, per @handle or r/sub]
|
|
|
|
KEY PATTERNS:
|
|
1. [Pattern] — per @handle
|
|
2. [Pattern] — per r/sub
|
|
```
|
|
|
|
**2. Stats box** (calculate from actual output):
|
|
```
|
|
---
|
|
All agents reported back!
|
|
|- Reddit: {N} threads | {N} upvotes | {N} comments
|
|
|- X: {N} posts | {N} likes | {N} reposts
|
|
|- YouTube: {N} videos | {N} views | {N} with transcripts
|
|
|- Web: {N} pages (supplementary)
|
|
|- Top voices: @{handle1}, @{handle2} | r/{sub1}, r/{sub2}
|
|
---
|
|
```
|
|
|
|
**3. Invitation** with 2-3 specific follow-up suggestions based on research.
|
|
|
|
---
|
|
|
|
## Follow-Up
|
|
|
|
After research, you are an **EXPERT** on this topic.
|
|
|
|
- **QUESTION** → Answer from research (no new searches)
|
|
- **GO DEEPER** → Elaborate from findings
|
|
- **CREATE/PROMPT** → Write ONE prompt using research insights
|
|
- **Different topic** → Run new research
|
|
|
|
When writing prompts, match the FORMAT the research recommends (JSON, structured, etc.).
|