Trending-skills last30days-research-skill

```markdown

install

source · Clone the upstream repo

git clone https://github.com/Aradotso/trending-skills

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/Aradotso/trending-skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/last30days-research-skill" ~/.claude/skills/aradotso-trending-skills-last30days-research-skill && rm -rf "$T"

manifest: skills/last30days-research-skill/SKILL.md

source content

---
name: last30days-research-skill
description: AI agent skill for researching any topic across Reddit, X, YouTube, HN, Polymarket, and the web to synthesize grounded, citation-backed summaries from the last 30 days
triggers:
  - research what people are saying about
  - find recent discussions about
  - what's trending in the last 30 days
  - summarize community sentiment on
  - research across reddit and twitter about
  - find what people are actually saying about
  - deep research current opinions on
  - last30days investigate topic
---

# /last30days Research Skill

> Skill by [ara.so](https://ara.so) — Daily 2026 Skills collection.

`/last30days` is a multi-source research skill that scans Reddit, X (Twitter), Bluesky, YouTube, TikTok, Instagram, Hacker News, Polymarket, and the web for discussions from the last 30 days, scores and deduplicates results across a composite relevance pipeline, and synthesizes a grounded narrative with real citations. One command surfaces what people who are paying attention already know.

---

## Installation

### Claude Code Plugin (Recommended)

```bash
/plugin marketplace add mvanhorn/last30days-skill
/plugin install last30days@last30days-skill

ClawHub

clawhub install last30days-official

Gemini CLI

gemini extensions install https://github.com/mvanhorn/last30days-skill.git

Manual Install (Claude Code / Codex CLI)

# Clone into Claude Code skills directory
git clone https://github.com/mvanhorn/last30days-skill.git ~/.claude/skills/last30days

# For Codex CLI, use the agents directory instead
git clone https://github.com/mvanhorn/last30days-skill.git ~/.agents/skills/last30days

Configuration

Create a global config file at

~/.config/last30days/.env

mkdir -p ~/.config/last30days
cat > ~/.config/last30days/.env << 'EOF'
# Reddit + TikTok + Instagram — one key covers all three
SCRAPECREATORS_API_KEY=...

# X (Twitter) cookie-based auth — copy from browser dev tools while logged into x.com
AUTH_TOKEN=...
CT0=...

# xAI fallback if you don't want cookie-based X auth
XAI_API_KEY=...

# Bluesky (optional)
BSKY_HANDLE=you.bsky.social
BSKY_APP_PASSWORD=xxxx-xxxx-xxxx

# Web search backends (optional, open variant)
PARALLEL_API_KEY=...
BRAVE_API_KEY=...
OPENROUTER_API_KEY=...

# OpenAI (optional legacy Reddit fallback)
OPENAI_API_KEY=...
EOF
chmod 600 ~/.config/last30days/.env

Per-Project Config Override

Drop a

.claude/last30days.env

in any project root. It overrides the global config for that project only:

# .claude/last30days.env
SCRAPECREATORS_API_KEY=...
AUTH_TOKEN=...
CT0=...

Setting Up X Authentication

Log into x.com in your browser
Open Dev Tools → Application → Cookies →
```
x.com
```
Copy
```
auth_token
```
→ save as
```
AUTH_TOKEN
```
Copy
```
ct0
```
→ save as
```
CT0
```
Verify it works:

node ~/.claude/skills/last30days/scripts/lib/vendor/bird-search/bird-search.mjs --whoami

Note: Node.js 22+ is required for the bundled Twitter GraphQL client.

Setting Up Bluesky

Go to
```
bsky.app/settings/app-passwords
```
Create an app password
Add
```
BSKY_HANDLE
```
and
```
BSKY_APP_PASSWORD
```
to your
```
.env
```

Usage

Basic Syntax

/last30days [topic]
/last30days [topic] for [tool]

Example Queries

# Prompt research for a specific tool
/last30days prompting techniques for ChatGPT for legal questions

# Tool best practices
/last30days remotion animations for Claude Code

# Trend discovery
/last30days what are the best rap songs lately

# Product research
/last30days what do people think of the new M4 MacBook

# Comparative mode (v2.9.5+)
/last30days cursor vs windsurf

# Handle resolution — finds @thedorbrothers and searches their posts
/last30days Dor Brothers

# Scoped time window
/last30days AI video tools --days=7

# Quick mode (speed over thoroughness)
/last30days AI video tools --quick

# Diagnose which sources are configured
python3 ~/.claude/skills/last30days/scripts/last30days.py --diagnose

Key Features

Multi-Source Research Pipeline

Sources searched in parallel, results scored and deduplicated:

Source	Auth Required	Notes
Reddit	`SCRAPECREATORS_API_KEY`	Smart subreddit discovery, top comments scored
X / Twitter	`AUTH_TOKEN` + `CT0` or `XAI_API_KEY`	Handle resolution for people/brands
Bluesky	`BSKY_HANDLE` + `BSKY_APP_PASSWORD`	Full AT Protocol pipeline
YouTube	None (transcripts)	Video transcripts as signal source
TikTok	`SCRAPECREATORS_API_KEY`	Same key as Reddit + Instagram
Instagram Reels	`SCRAPECREATORS_API_KEY`	Same key as Reddit + TikTok
Hacker News	None	Stories, Show HN, comment insights
Polymarket	None	Real-money prediction markets
Web	Optional ( `PARALLEL_API_KEY` , `BRAVE_API_KEY` , etc.)	Open variant

Composite Relevance Scoring

Every result runs through:

Bidirectional text similarity with synonym expansion and token overlap
Engagement velocity normalization
Source authority weighting
Cross-platform convergence detection (hybrid trigram-token Jaccard similarity)
Temporal recency decay

Polymarket markets use a 5-factor weighted composite:

Text relevance (30%)
24-hour volume (30%)
Liquidity depth (15%)
Price movement velocity (15%)
Outcome competitiveness (10%)

Comparative Mode

Ask

X vs Y

to trigger 3 parallel research passes with a side-by-side comparison:

/last30days cursor vs windsurf
# Returns: strengths, weaknesses, head-to-head table, data-driven verdict

Auto-Save to Documents

Every run saves a

.md

briefing to

~/Documents/Last30Days/[topic].md

automatically — builds a personal research library over time.

Watchlist / Open Variant

For always-on bots and scheduled research (designed for Open Claw):

# Switch to open variant
cp ~/.claude/skills/last30days/variants/open/SKILL.md ~/.claude/skills/last30days/SKILL.md

Watchlist Commands

# Add topics to watchlist
last30 watch my biggest competitor every week
last30 watch Peter Steinberger every 30 days
last30 watch AI video tools monthly

# Run research manually (or wire to cron)
last30 run all my watched topics
last30 run one "AI video tools"

# Query accumulated knowledge
last30 what have you found about AI video?

Cron Integration

# Run all watched topics daily at 8am
0 8 * * * python3 ~/.claude/skills/last30days/scripts/last30days.py watchlist run-all

Important: The watchlist stores schedules as metadata but does NOT trigger runs automatically. You need an external scheduler (cron, launchd, or an always-on bot) to call
watchlist.py run-all
on a timer.

Python Engine — Direct Usage

import subprocess
import json

# Run a research query programmatically
result = subprocess.run(
    ["python3", "~/.claude/skills/last30days/scripts/last30days.py",
     "--topic", "Claude Code AI agents",
     "--days", "30",
     "--format", "json"],
    capture_output=True,
    text=True
)

data = json.loads(result.stdout)
print(data["summary"])
print(data["sources"])

Diagnose Source Availability

import subprocess

result = subprocess.run(
    ["python3", "~/.claude/skills/last30days/scripts/last30days.py", "--diagnose"],
    capture_output=True,
    text=True
)
print(result.stdout)
# Output: which sources are configured and available

Check Bluesky Auth

import subprocess

result = subprocess.run(
    ["python3", "~/.claude/skills/last30days/scripts/lib/bluesky.py", "--check"],
    capture_output=True,
    text=True
)
print(result.stdout)

Common Patterns

Prompt Research Workflow

Best use case: discover what prompting techniques work for any AI tool by learning from real community discussions.

# Find what works for image generation
/last30days nano banana pro prompting

# Find legal AI prompting techniques
/last30days prompting techniques for ChatGPT for legal questions

# Find coding agent workflows
/last30days Claude Code agentic workflows best practices

Trend Discovery

# Music / culture
/last30days best rap songs lately

# Viral AI techniques
/last30days dog as human trend ChatGPT

# Tech product launches
/last30days Seedance 2.0 access

Competitive Intelligence

# Compare two products
/last30days linear vs jira 2025

# Track a competitor
last30 watch CompetitorName weekly   # open variant

# Find community sentiment on a product
/last30days what do people think of Cursor AI

Prediction Market Research

# Sports betting odds from Polymarket
/last30days Arizona Basketball

# Geopolitical markets
/last30days Iran War

# Tech market outcomes
/last30days OpenAI GPT-5 release

Troubleshooting

X Search Not Working

# Verify your cookies are valid
node ~/.claude/skills/last30days/scripts/lib/vendor/bird-search/bird-search.mjs --whoami

# If expired, re-copy auth_token and ct0 from browser dev tools at x.com
# Then update ~/.config/last30days/.env

Reddit Returning No Results

# Confirm SCRAPECREATORS_API_KEY is set
python3 ~/.claude/skills/last30days/scripts/last30days.py --diagnose

# Check key is exported
echo $SCRAPECREATORS_API_KEY

Bluesky Auth Failing

# Ensure you're using an App Password, NOT your account password
# Create one at: bsky.app/settings/app-passwords

# Verify format in .env:
# BSKY_HANDLE=yourhandle.bsky.social
# BSKY_APP_PASSWORD=xxxx-xxxx-xxxx-xxxx

Node.js Version Error

# Check version — must be 22+
node --version

# Upgrade via nvm
nvm install 22
nvm use 22

Slow Results

# Use quick mode for faster (less thorough) results
/last30days [topic] --quick

# Narrow the time window
/last30days [topic] --days=7

Config Not Loading

# Check global config exists and has correct permissions
ls -la ~/.config/last30days/.env   # should be -rw-------

# Check per-project override
ls -la .claude/last30days.env

# SessionStart config check (v2.9.5+) runs automatically when Claude Code starts

Source Summary

ScrapeCreators (
```
scrapecreators.com
```
) — one API key covers Reddit, TikTok, Instagram
Bird Search — bundled Node.js Twitter GraphQL client for X, requires
```
AUTH_TOKEN
```
+
```
CT0
```
xAI — alternative X backend if you don't want cookie-based auth
Bluesky AT Protocol — native search via app password
Polymarket — public API, no auth required
Hacker News — public Algolia API, no auth required
YouTube — transcript extraction, no auth required for public videos
Web Search — optional: Parallel AI, Brave Search, OpenRouter/Perplexity Sonar Pro