AI agent skill that researches any topic across Reddit, X, YouTube, HN, Polymarket, and the web - then synthesizes a grounded summary
Hermes Setup Guide for last30days
This guide covers installing last30days on Hermes AI Agent.
Prerequisites
- Hermes installed - See https://github.com/NousResearch/hermes-agent
- Python 3.12+ -
brew install [email protected]or similar - yt-dlp (optional, for YouTube) -
brew install yt-dlp
Installation
git clone https://github.com/mvanhorn/last30days-skill.git
mkdir -p ~/.hermes/skills/research
cp -r last30days-skill/skills/last30days ~/.hermes/skills/research/
That deploys the skill straight from this repo's current default branch to ~/.hermes/skills/research/last30days (with named profiles the skills root is ~/.hermes/profiles/<name>/skills/). Run hermes skills list to confirm it shows up; a session already open needs /reload-skills (or a new session) to pick it up.
Why not
hermes skills install? The installer is currently blocked for this skill. Hermes's install-time security scanner flags benign patterns here — reading your own API keys from the environment (os.environ.get("XAI_API_KEY")etc.) and callingsubprocessto runyt-dlp/bird— and returns adangerousverdict (19 findings).--forceonly overrides acautionverdict; for community sources adangerousverdict is a hard block that--forcecannot bypass:hermes skills install mvanhorn/last30days-skill/skills/last30days --force # → Installation blocked: Blocked (community source + dangerous verdict, 19 findings)The
git clone+cppath above sidesteps the installer and is the supported workaround until the scanner rules or this skill's flagged patterns change. (The shorterhermes skills install mvanhorn/last30days-skilladditionally resolves through the skills.sh index, which was serving a stale snapshot — tracked in vercel-labs/skills#1602.)
Developer / live-edit alternative
If you're hacking on the skill locally and want edits to propagate to Hermes without re-copying, symlink your working tree instead of cp:
git clone https://github.com/mvanhorn/last30days-skill.git
mkdir -p ~/.hermes/skills/research
ln -s "$(pwd)/last30days-skill/skills/last30days" ~/.hermes/skills/research/last30days
Usage
In Hermes, invoke with:
last30days "your research topic"
Or with options:
last30days "best mechanical keyboards 2025" --search=reddit,youtube
last30days "AI news" --days=7 --deep
First Run Setup
On first run, the skill will guide you through setup:
Auto setup (~30 seconds)
- Scans browser cookies for X/Twitter
- Checks/installs yt-dlp for YouTube
- Best-effort install of
digg-pp-clifor Digg AI-news clusters (via@mvanhorn/printing-press-library; binary lands in$HOME/.local/bin— ensure your Hermes gateway PATH includes it, or Digg stays off even after install) - Configures free sources (Reddit, HN, Polymarket)
Optional: ScrapeCreators
- Adds TikTok, Instagram, Reddit backup
- 100 free credits (no expiration)
- Sign up at scrapecreators.com
Optional: API Keys
- XAI_API_KEY for X/Twitter (alternative to browser cookies)
- BRAVE_API_KEY for web search
Available Sources
Free (No API Key)
- Reddit - Public discussions and comments
- Hacker News - Tech discussions via Algolia
- Polymarket - Prediction markets
- YouTube - Search and transcripts (requires yt-dlp)
- Digg - AI-news story clusters (requires
digg-pp-clion the agent PATH; auto-installed to$HOME/.local/binduring setup whennpxis available)
Requires API Key
- X/Twitter - xAI API key or browser cookies
- TikTok - ScrapeCreators API
- Instagram - ScrapeCreators API
- Web Search - Brave Search API
Troubleshooting
Python not found
# Find Python 3.12+
which python3.12 python3.13 python3.14
# If not installed
brew install [email protected]
yt-dlp not found
brew install yt-dlp
# or
pip install yt-dlp
Check what's configured
cd ~/.hermes/skills/research/last30days
python3.12 scripts/last30days.py --diagnose
Updating
If you symlinked your working tree (developer alternative above), just git pull in the repo — edits propagate live, no re-install step. With a cp install, pull and re-copy:
cd last30days-skill && git pull
cp -r skills/last30days ~/.hermes/skills/research/
hermes skills install mvanhorn/last30days-skill --force remains blocked by the scanner verdict above; retry it occasionally in case the flagged patterns or scanner rules change.
Support
- Original repo: https://github.com/mvanhorn/last30days-skill
- Hermes: https://github.com/mercurial-tf/hermes
- Issues: Please report in the original repo