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#

CommandWhat it doesnode {baseDir}/cli.js fetchShow top 20 skills by downloadsnode {baseDir}/cli.js checkRun surge detection, top movers, and update statenode {baseDir}/cli.js statusLast check, thresholds, notification statusnode {baseDir}/cli.js profileShow current agent profilenode {baseDir}/cli.js profile set "description" "kw1,kw2"Set profile for relevance scoringnode {baseDir}/cli.js config movers=5Set number of top movers shownnode {baseDir}/cli.js config movers-offDisable top moversnode {baseDir}/cli.js config growth=30 downloads=50000 stars=200Update 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):

bash

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:

VariableDefaultDescriptionSURGE_DIR``~/.skill-surge-notifierBase directory for all state and config filesSTATE_PATH``$SURGE_DIR/state.jsonPath to the skill state fileCONFIG_PATH``$SURGE_DIR/config.jsonPath to the config fileSCHEDULED``falseSet to true when running from a scheduler; adds a random 1–5 min delay before fetching to spread API load