Trevin Chow
9fb19eae63
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.
112 lines
2.7 KiB
Markdown
112 lines
2.7 KiB
Markdown
# Hermes Setup Guide for last30days
|
|
|
|
This guide covers installing last30days on Hermes AI Agent.
|
|
|
|
## Prerequisites
|
|
|
|
1. **Hermes installed** - See https://github.com/mercurial-tf/hermes
|
|
2. **Python 3.12+** - `brew install python@3.12` or similar
|
|
3. **yt-dlp** (optional, for YouTube) - `brew install yt-dlp`
|
|
|
|
## Installation
|
|
|
|
```bash
|
|
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:
|
|
|
|
```bash
|
|
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:
|
|
|
|
1. **Auto setup** (~30 seconds)
|
|
- Scans browser cookies for X/Twitter
|
|
- Checks/installs yt-dlp for YouTube
|
|
- Configures free sources (Reddit, HN, Polymarket)
|
|
|
|
2. **Optional: ScrapeCreators**
|
|
- Adds TikTok, Instagram, Reddit backup
|
|
- 10,000 free API calls
|
|
- Sign up at scrapecreators.com
|
|
|
|
3. **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
|
|
```bash
|
|
# Find Python 3.12+
|
|
which python3.12 python3.13 python3.14
|
|
|
|
# If not installed
|
|
brew install python@3.12
|
|
```
|
|
|
|
### yt-dlp not found
|
|
```bash
|
|
brew install yt-dlp
|
|
# or
|
|
pip install yt-dlp
|
|
```
|
|
|
|
### Check what's configured
|
|
```bash
|
|
cd ~/.hermes/skills/research/last30days
|
|
python3.12 scripts/last30days.py --diagnose
|
|
```
|
|
|
|
## Updating
|
|
|
|
```bash
|
|
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
|