Initial commit: last30days skill
Research topics across Reddit + X from the last 30 days using OpenAI and xAI APIs. Features: - Auto model selection (GPT-5.x, Grok-3) - Popularity-aware scoring (relevance + recency + engagement) - Reddit thread enrichment with real metrics - Near-duplicate detection - Multiple emit modes (compact, json, context, path) - 24h caching with --refresh bypass - NUX for API key setup - 87 passing unit tests Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Matt Van Horn
@@ -0,0 +1,145 @@
|
||||
---
|
||||
name: last30days
|
||||
description: Research a topic from the last 30 days on Reddit + X; judge/summarize into best practices, a prompt pack, and a reusable context snippet.
|
||||
argument-hint: "[topic]"
|
||||
context: fork
|
||||
agent: Explore
|
||||
disable-model-invocation: true
|
||||
allowed-tools: Bash, Read, Write
|
||||
---
|
||||
|
||||
# last30days: 30-Day Research Synthesis
|
||||
|
||||
Research a topic across Reddit and X from the last 30 days, then synthesize findings into actionable best practices, prompts, and reusable context.
|
||||
|
||||
## Setup Check
|
||||
|
||||
First, verify API key configuration exists:
|
||||
|
||||
```bash
|
||||
if [ ! -f ~/.config/last30days/.env ]; then
|
||||
echo "SETUP_NEEDED"
|
||||
else
|
||||
echo "CONFIGURED"
|
||||
fi
|
||||
```
|
||||
|
||||
### If SETUP_NEEDED
|
||||
|
||||
Run the NUX flow to configure API keys. Use the AskUserQuestion tool to collect:
|
||||
|
||||
1. **OpenAI API Key** (optional but recommended for Reddit research)
|
||||
2. **xAI API Key** (optional but recommended for X research)
|
||||
3. **Model policies** (optional, defaults are usually fine)
|
||||
|
||||
Then create the config:
|
||||
|
||||
```bash
|
||||
mkdir -p ~/.config/last30days
|
||||
cat > ~/.config/last30days/.env << 'ENVEOF'
|
||||
# last30days API Configuration
|
||||
# At least one key is required
|
||||
|
||||
OPENAI_API_KEY=
|
||||
XAI_API_KEY=
|
||||
|
||||
# Model selection (optional)
|
||||
# OPENAI_MODEL_POLICY=auto|pinned (default: auto)
|
||||
# OPENAI_MODEL_PIN=gpt-5.2 (only if pinned)
|
||||
# XAI_MODEL_POLICY=latest|stable|pinned (default: latest)
|
||||
# XAI_MODEL_PIN=grok-4 (only if pinned)
|
||||
ENVEOF
|
||||
|
||||
chmod 600 ~/.config/last30days/.env
|
||||
echo "Config created at ~/.config/last30days/.env"
|
||||
echo "Please edit it to add your API keys, then run the skill again."
|
||||
```
|
||||
|
||||
After creating the file, instruct the user to edit `~/.config/last30days/.env` and add their keys.
|
||||
|
||||
**STOP HERE if setup was needed. Do not proceed until keys are configured.**
|
||||
|
||||
---
|
||||
|
||||
## Research Execution
|
||||
|
||||
If configured, run the research orchestrator:
|
||||
|
||||
```bash
|
||||
python3 ~/.claude/skills/last30days/scripts/last30days.py "$ARGUMENTS" --emit=compact 2>&1
|
||||
```
|
||||
|
||||
The script will:
|
||||
- Auto-detect which keys are available
|
||||
- Auto-select the best models (or use pinned versions)
|
||||
- Search Reddit via OpenAI Responses API (if OpenAI key present)
|
||||
- Search X via xAI Responses API (if xAI key present)
|
||||
- Enrich Reddit threads with real engagement metrics
|
||||
- Score, rank, and dedupe results
|
||||
- Output files to `~/.local/share/last30days/out/`
|
||||
|
||||
---
|
||||
|
||||
## RESEARCH DATA
|
||||
|
||||
The output above contains the research data. Now synthesize it.
|
||||
|
||||
---
|
||||
|
||||
## Your Role: Judge and Synthesizer
|
||||
|
||||
You are now the expert judge. Using the research data above, produce:
|
||||
|
||||
### A) Best Practices (Grouped & Actionable)
|
||||
|
||||
Group findings into 3-7 thematic categories. For each best practice:
|
||||
- State the practice clearly and actionably
|
||||
- Cite supporting item IDs (e.g., "supported by R3, R7, X2")
|
||||
- Note if it's **strongly supported** (multiple high-score sources) or **niche** (single source or low engagement)
|
||||
|
||||
### B) Prompt Pack (3-7 Copy/Paste Prompts)
|
||||
|
||||
Create ready-to-use prompts tailored to the topic. Each prompt should:
|
||||
- Be immediately usable (copy/paste ready)
|
||||
- Target a specific use case discovered in the research
|
||||
- Include any relevant context or constraints from the findings
|
||||
|
||||
### C) Reusable Context Snippet
|
||||
|
||||
Create a compact (~200-400 words) context block that other skills/tools can import. Include:
|
||||
- Core concepts and terminology
|
||||
- Key techniques or patterns
|
||||
- Common pitfalls to avoid
|
||||
- Brief source attribution
|
||||
|
||||
### D) Sources Appendix
|
||||
|
||||
List all source URLs organized by platform:
|
||||
- **Reddit**: Title, subreddit, URL, score
|
||||
- **X**: Author, text excerpt, URL, engagement
|
||||
|
||||
### E) Confidence Assessment
|
||||
|
||||
Explicitly state:
|
||||
- **Strongly Supported**: Practices backed by multiple high-engagement sources
|
||||
- **Emerging/Niche**: Practices from single sources or low engagement (still valuable but use with awareness)
|
||||
- **Gaps**: What the research didn't cover well
|
||||
|
||||
---
|
||||
|
||||
## Final Output
|
||||
|
||||
After completing your synthesis:
|
||||
|
||||
1. Display the full report to the user
|
||||
2. Confirm the files were written:
|
||||
- `~/.local/share/last30days/out/report.md`
|
||||
- `~/.local/share/last30days/out/report.json`
|
||||
- `~/.local/share/last30days/out/last30days.context.md`
|
||||
|
||||
3. Show the header summary:
|
||||
```
|
||||
Models used: OpenAI={model} xAI={model}
|
||||
Mode: {reddit-only|x-only|both}
|
||||
Coverage: {note about triangulation if single-source}
|
||||
```
|
||||
Reference in New Issue
Block a user