Files

T

Trevin Chow 9fb19eae63 refactor: delete sync.sh, dev workflow moves to npx skills add . -g -y + native installers

Every job sync.sh did has a better replacement:

- Per-harness skill dirs (~/.claude/skills, ~/.codex/skills, ~/.agents/skills):
  `npx skills add . -g -y` writes to every detected harness's home dir and
  uses symlinks by default. Edits propagate live — no re-deploy step.
- Hermes (~/.hermes/skills/research/last30days):
  `hermes skills install mvanhorn/last30days-skill --force` pulls from
  GitHub and handles the deploy itself. The script wrapping was redundant.
- OpenClaw variant: `clawhub install last30days-official` is what users
  already run per the README; the maintainer doesn't need a separate
  variant-deploy step in the public repo's scripts.
- Claude marketplace cache (~/.claude/plugins/cache/...): this was a
  "test against the official install path" hack we shouldn't have been
  recommending. With PR #400's resolver collapse, STEP 0 no longer
  enforces the cache as the only valid SKILL.md location. Just install
  the skill normally via `npx skills` or the marketplace.

Cleanup:

- DELETE skills/last30days/scripts/sync.sh
- tests/test_version_consistency.py — drop test_sync_cache_path_uses_skill_version
- CLAUDE.md — replace the sync.sh command + rule with `npx skills add . -g -y`
- HERMES_SETUP.md — Installation now uses `hermes skills install --force`;
  developer-alternative section shows the symlink pattern for live editing
- render.py — _skill_version docstring no longer attributes the
  ".claude-plugin absent" case to sync.sh; explains it via per-harness
  install paths in general
- .github/PULL_REQUEST_TEMPLATE.md — drop the "Ran bash scripts/sync.sh"
  checklist item

CHANGELOG and historical docs (release notes, plan files) keep their
existing sync.sh mentions as accurate history.

2026-05-15 23:42:31 -07:00

2.7 KiB

Raw Blame History

Hermes Setup Guide for last30days

This guide covers installing last30days on Hermes AI Agent.

Prerequisites

Hermes installed - See https://github.com/mercurial-tf/hermes
Python 3.12+ - brew install python@3.12 or similar
yt-dlp (optional, for YouTube) - brew install yt-dlp

Installation

hermes skills install mvanhorn/last30days-skill --force

This pulls the latest release from GitHub and deploys to ~/.hermes/skills/research/last30days/. --force reinstalls over any existing copy.

Developer / live-edit alternative

If you're hacking on the skill locally and want edits to propagate to Hermes without re-installing, symlink your working tree:

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
- Configures free sources (Reddit, HN, Polymarket)
Optional: ScrapeCreators
- Adds TikTok, Instagram, Reddit backup
- 10,000 free API calls
- 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)

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 python@3.12

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

hermes skills install mvanhorn/last30days-skill --force

If you symlinked your working tree (developer alternative above), just git pull in the repo — edits propagate live, no re-install step.

Support

Original repo: https://github.com/mvanhorn/last30days-skill
Hermes: https://github.com/mercurial-tf/hermes
Issues: Please report in the original repo

2.7 KiB Raw Blame History