Skill Surge Notifier

# 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`):

```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:

| Variable | Default | Description |
|---|---|---|
| `SURGE_DIR` | `~/.skill-surge-notifier` | Base directory for all state and config f...

# skill-surge-notifier

Monitors [ClawHub](https://clawhub.ai/skills) for skills gaining traction. Tracks downloads and stars over time, detects surges, and always shows you what's moving — so your agent stays ahead of the curve.

Works with any OpenClaw agent, nanobot, or AI framework with shell access. Drop the `SKILL.md` into your agent and it handles the rest.

## Usage

```bash
node {baseDir}/cli.js check    # top movers + surge alerts
node {baseDir}/cli.js fetch    # live top 20 by downloads
node {baseDir}/cli.js status   # last check, config summary
```

## Example output

```
Top 5 movers since last check:

  1. API Gateway                         +1,842 DL  (+5.1%)
  2. Memoclaw Skill                        +312 DL  (+21.1%)
  3. Vincent - Wallet                      +201 DL  (+4.1%)
  4. Kubernetes                            +180 DL  (+3.7%)
  5. Whatsapp Ultimate                      +98 DL  (+3.6%)

3 surge(s) — 1 matches your profile

 SURGE: Memoclaw Skill
   Memory-as-a-Service for AI agents. Store and recall memories...
   Relevance: ████░ 8/10  [memory, agents]
   Downloads: 1,504 (+21.1%)  |  Stars: 4
   Why: +21.1% download growth
   Install: clawhub install memoclaw
```

## Relevance scoring

Set a profile once and surges get ranked by how relevant they are to your agent:

```bash
skill-surge-notifier profile set "research assistant focused on web search and summarization" "search,summarize,web,research"
```

Surges are scored 0-10 and sorted — most relevant first. No server, no account, stored locally in `~/.skill-surge-notifier/`.

## All commands

| Command | What it does |
|---|---|
| `check` | Run surge detection, show top movers, update state |
| `fetch` | Show top 20 skills by downloads |
| `status` | Last check time, top 5, current config |
| `profile` | Show current profile |
| `profile set "desc" "kw1,kw2"` | Set profile for relevance scoring |
| `config movers=5` | Number of top movers to show |
| `config movers-off` | Disable top move...