Monitors ClawHub for skills gaining traction by tracking download and star growth, alerts on surges based on configurable thresholds.
Skill Surge Notifier
Monitors ClawHub for skills gaining traction. Tracks download and star counts over time and alerts when a skill is surging.
A surge is triggered when any of these are true:
- Download growth >30% since last check
- Total downloads >50,000
- Stars >200
- A new skill appeared in the top 10
Setup
Requires Node.js 18+. No install needed — runs directly from the skill bundle.
Commands
| Command | What it does |
|---|---|
node {baseDir}/cli.js fetch | Show top 20 skills by downloads |
node {baseDir}/cli.js check | Run surge detection, top movers, and update state |
node {baseDir}/cli.js status | Last check, thresholds, notification status |
node {baseDir}/cli.js profile | Show current agent profile |
node {baseDir}/cli.js profile set "description" "kw1,kw2" | Set profile for relevance scoring |
node {baseDir}/cli.js config movers=5 | Set number of top movers shown |
node {baseDir}/cli.js config movers-off | Disable top movers |
node {baseDir}/cli.js config growth=30 downloads=50000 stars=200 | Update surge thresholds |
Every check run always shows top N movers (by download delta) regardless of thresholds, so there's always something to look at.
When a profile is set, surges are scored 0-10 for relevance and sorted accordingly — most relevant first.
Notes
- State is stored in
~/.skill-surge-notifier/state.json. The first run seeds the baseline; growth % appears from the second run onward. - All output is printed to stdout. When used inside an agent, the agent must capture the CLI output to surface alerts in chat.
- To run automatically, add to crontab (
crontab -e):
0 */4 * * * node {baseDir}/cli.js check >> ~/.skill-surge-notifier/surge.log 2>&1
Environment Variables
These optional env vars override default paths and behavior:
| Variable | Default | Description |
|---|---|---|
SURGE_DIR | ~/.skill-surge-notifier | Base directory for all state and config files |
STATE_PATH | $SURGE_DIR/state.json | Path to the skill state file |
CONFIG_PATH | $SURGE_DIR/config.json | Path to the config file |
SCHEDULED | false | Set to true when running from a scheduler; adds a random 1–5 min delay before fetching to spread API load |
- Downloads
- 693All time
- Security audit
- Pass
- Last updated
- 6mo ago
- Current version
- v1.0.0
- License
- MIT-0
