--- name: last30days version: "2.9.2" description: "Research a topic from the last 30 days. Also triggered by 'last30'. Sources: Reddit, X, YouTube, TikTok, Instagram, Hacker News, Polymarket, web. Become an expert and write copy-paste-ready prompts." argument-hint: 'last30 AI video tools, last30 best project management tools' allowed-tools: Bash, Read, Write, AskUserQuestion, WebSearch homepage: https://github.com/mvanhorn/last30days-skill repository: https://github.com/mvanhorn/last30days-skill author: mvanhorn license: MIT user-invocable: true metadata: openclaw: emoji: "📰" requires: env: - SCRAPECREATORS_API_KEY optionalEnv: - OPENAI_API_KEY - XAI_API_KEY - OPENROUTER_API_KEY - PARALLEL_API_KEY - BRAVE_API_KEY - APIFY_API_TOKEN - AUTH_TOKEN - CT0 bins: - node - python3 primaryEnv: SCRAPECREATORS_API_KEY files: - "scripts/*" homepage: https://github.com/mvanhorn/last30days-skill tags: - research - reddit - x - youtube - tiktok - instagram - hackernews - polymarket - trends - prompts ---

last30days v2.9.4: Research Any Topic from the Last 30 Days

> Permissions overview: Reads public web/platform data and optionally saves research briefings to ~/Documents/Last30Days/. X/Twitter search uses optional user-provided tokens (AUTH_TOKEN/CT0 env vars) — no browser session access. All credential usage and data writes are documented in the Security & Permissions section.

Research ANY topic across Reddit, X, YouTube, TikTok, Hacker News, Polymarket, and the web. Surface what people are actually discussing, recommending, betting on, and debating right now.

CRITICAL: Parse User Intent

Before doing anything, parse the user's input for:

1. TOPIC: What they want to learn about (e.g., "web app mockups", "Claude Code skills", "image generation")
2. TARGET TOOL (if specified): Where they'll use the prompts (e.g., "Nano Banana Pro", "ChatGPT", "Midjourney")
3. QUERY TYPE: What kind of research they want:

- PROMPTING - "X prompts", "prompting for X", "X best practices" → User wants to learn techniques and get copy-paste prompts - RECOMMENDATIONS - "best X", "top X", "what X should I use", "recommended X" → User wants a LIST of specific things - NEWS - "what's happening with X", "X news", "latest on X" → User wants current events/updates - GENERAL - anything else → User wants broad understanding of the topic

Common patterns:

• [topic] for [tool] → "web mockups for Nano Banana Pro" → TOOL IS SPECIFIED
• [topic] prompts for [tool] → "UI design prompts for Midjourney" → TOOL IS SPECIFIED
• Just [topic] → "iOS design mockups" → TOOL NOT SPECIFIED, that's OK
• "best [topic]" or "top [topic]" → QUERY_TYPE = RECOMMENDATIONS
• "what are the best [topic]" → QUERY_TYPE = RECOMMENDATIONS

IMPORTANT: Do NOT ask about target tool before research.

• If tool is specified in the query, use it
• If tool is NOT specified, run research first, then ask AFTER showing results

Store these variables:

• TOPIC = [extracted topic]
• TARGET_TOOL = [extracted tool, or "unknown" if not specified]
• QUERY_TYPE = [RECOMMENDATIONS | NEWS | HOW-TO | GENERAL]

DISPLAY your parsing to the user. Before running any tools, output:

I'll research {TOPIC} across Reddit, X, TikTok, and the web to find what's been discussed in the last 30 days.

Parsed intent:
- TOPIC = {TOPIC}
- TARGET_TOOL = {TARGET_TOOL or "unknown"}
- QUERY_TYPE = {QUERY_TYPE}

Research typically takes 2-8 minutes (niche topics take longer). Starting now.

If TARGET_TOOL is known, mention it in the intro: "...to find {QUERY_TYPE}-style content for use in {TARGET_TOOL}."

This text MUST appear before you call any tools. It confirms to the user that you understood their request.

---

Step 0.5: Resolve X Handle (if topic could have an X account)

If TOPIC looks like it could have its own X/Twitter account - people, creators, brands, products, tools, companies, communities (e.g., "Dor Brothers", "Jason Calacanis", "Nano Banana Pro", "Seedance", "Midjourney"), do ONE quick WebSearch:

WebSearch("{TOPIC} X twitter handle site:x.com")

From the results, extract their X/Twitter handle. Look for:

• Verified profile URLs like x.com/{handle} or twitter.com/{handle}
• Mentions like "@handle" in bios, articles, or social profiles
• "Follow @handle on X" patterns

Verify the account is real, not a parody/fan account. Check for:

• Verified/blue checkmark in the search results
• Official website linking to the X account
• Consistent naming (e.g., @thedorbrothers for "The Dor Brothers", not @DorBrosFan)
• If results only show fan/parody/news accounts (not the entity's own account), skip - the entity may not have an X presence

If you find a clear, verified handle, pass it as --x-handle={handle} (without @). This searches that account's posts directly - finding content they posted that doesn't mention their own name.

Skip this step if:

• TOPIC is clearly a generic concept, not an entity (e.g., "best rap songs 2026", "how to use Docker", "AI ethics debate")
• TOPIC already contains @ (user provided the handle directly)
• Using --quick depth
• WebSearch shows no official X account exists for this entity

Store: RESOLVED_HANDLE = {handle or empty}

---

Agent Mode (--agent flag)

If --agent appears in ARGUMENTS (e.g., /last30days plaud granola --agent):

1. Skip the intro display block ("I'll research X across Reddit...")
2. Skip any AskUserQuestion calls - use TARGET_TOOL = "unknown" if not specified
3. Run the research script and WebSearch exactly as normal
4. Skip the "WAIT FOR USER RESPONSE" pause
5. Skip the follow-up invitation ("I'm now an expert on X...")
6. Output the complete research report and stop - do not wait for further input

Agent mode saves raw research data to ~/Documents/Last30Days/ automatically via --save-dir (handled by the script, no extra tool calls).

Agent mode report format:

## Research Report: {TOPIC}
Generated: {date} | Sources: Reddit, X, YouTube, TikTok, HN, Polymarket, Web

### Key Findings
[3-5 bullet points, highest-signal insights with citations]

### What I learned
{The full "What I learned" synthesis from normal output}

### Stats
{The standard stats block}

---

Research Execution

Step 1: Run the research script (FOREGROUND — do NOT background this)

CRITICAL: Run this command in the FOREGROUND with a 5-minute timeout. Do NOT use run_in_background. The full output contains Reddit, X, AND YouTube data that you need to read completely.

IMPORTANT: The script handles API key/Codex auth detection automatically. Run it and check the output to determine mode.

# Find skill root — works in repo checkout, Claude Code, or Codex install
for dir in \
  "." \
  "${CLAUDE_PLUGIN_ROOT:-}" \
  "$HOME/.claude/skills/last30days" \
  "$HOME/.agents/skills/last30days" \
  "$HOME/.codex/skills/last30days"; do
  [ -n "$dir" ] && [ -f "$dir/scripts/last30days.py" ] && SKILL_ROOT="$dir" && break
done

if [ -z "${SKILL_ROOT:-}" ]; then
  echo "ERROR: Could not find scripts/last30days.py" >&2
  exit 1
fi

python3 "${SKILL_ROOT}/scripts/last30days.py" "$ARGUMENTS" --emit=compact --no-native-web --save-dir=~/Documents/Last30Days  # Add --x-handle=HANDLE if RESOLVED_HANDLE is set

Use a timeout of 300000 (5 minutes) on the Bash call. The script typically takes 1-3 minutes.

The script will automatically:

• Detect available API keys
• Run Reddit/X/YouTube/TikTok/Instagram/Hacker News/Polymarket searches
• Output ALL results including YouTube transcripts, TikTok captions, Instagram captions, HN comments, and prediction market odds

...