[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M737HSY8Z7BPRWVFAZSB58AE":3,"skill-same:01M737HSY8Z7BPRWVFAZSB58AE":81},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":42,"commitSha":43,"skillDirectory":44,"forksCount":45,"repositoryHtmlUrl":46,"repositoryHomepageUrl":6,"ownerHtmlUrl":47,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":48,"install":49,"resources":62},"01M737HSY8Z7BPRWVFAZSB58AE","watchers",null,"Poll RSS, JSON APIs, and GitHub with watermark dedup.","ashneil12\u002Fvanilla-hermes-agent-canary","ashneil12","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F49880658?v=4","01M7378BQ9W161EPENEWBYAQNN","01M7378BRDJG8SFS93FG4V6BWY",1,"MIT","https:\u002F\u002Fgithub.com\u002Fashneil12\u002Fvanilla-hermes-agent-canary\u002Fblob\u002Fmain\u002Foptional-skills\u002Fdevops\u002Fwatchers\u002FSKILL.md",[],[],"2026-11-11 15:11:14",false,"---\nname: watchers\ndescription: Poll RSS, JSON APIs, and GitHub with watermark dedup.\nversion: 1.0.0\nauthor: Hermes Agent\nlicense: MIT\nplatforms: [linux, macos]\nmetadata:\n  hermes:\n    tags: [cron, polling, rss, github, http, automation, monitoring]\n    category: devops\n    requires_toolsets: [terminal]\n    related_skills: []\n---\n\n# Watchers\n\nPoll external sources on an interval and react only to new items. Three ready-made scripts plus a shared watermark helper; wire them into a cron job (or run them ad-hoc from the terminal).\n\n## When to Use\n\n- User wants to watch an RSS\u002FAtom feed and be notified of new entries\n- User wants to watch a GitHub repo's issues \u002F pulls \u002F releases \u002F commits\n- User wants to poll an arbitrary JSON endpoint and get notified on new items\n- User asks for \"a watcher for X\" or \"notify me when X changes\"\n\n## Mental model\n\nA watcher is just a script that:\n\n1. Fetches data from the external source\n2. Compares against a watermark file of previously-seen IDs\n3. Writes the new watermark back\n4. Prints new items to stdout (or nothing on no-change)\n\nThe scripts below handle all three. The agent runs them via the terminal tool — from a cron job, a webhook, or an interactive chat — and reports what's new.\n\n## Ready-made scripts\n\nAll three live in `$HERMES_HOME\u002Fskills\u002Fdevops\u002Fwatchers\u002Fscripts\u002F` once the skill is installed. Each reads `WATCHER_STATE_DIR` (defaults to `$HERMES_HOME\u002Fwatcher-state\u002F`) for its state file, keyed by the `--name` argument.\n\n| Script | What it watches | Dedup key |\n|---|---|---|\n| `watch_rss.py` | RSS 2.0 or Atom feed URL | `\u003Cguid>` \u002F `\u003Cid>` |\n| `watch_http_json.py` | Any JSON endpoint returning a list of objects | Configurable id field |\n| `watch_github.py` | GitHub issues \u002F pulls \u002F releases \u002F commits for a repo | `id` \u002F `sha` |\n\nAll three:\n\n- First run records a baseline — never replays existing feed\n- Watermark is a bounded ID set (max 500) to cap memory\n- Output format: `## \u003Ctitle>\\n\u003Curl>\\n\\n\u003Coptional body>` per item\n- Empty stdout on no-new — the caller treats that as silent\n- Non-zero exit on fetch errors\n\n## Usage\n\nRun a watcher directly from the terminal tool:\n\n```bash\npython $HERMES_HOME\u002Fskills\u002Fdevops\u002Fwatchers\u002Fscripts\u002Fwatch_rss.py \\\n  --name hn --url https:\u002F\u002Fnews.ycombinator.com\u002Frss --max 5\n```\n\nWatch a GitHub repo (set `GITHUB_TOKEN` in `${HERMES_HOME:-~\u002F.hermes}\u002F.env` to avoid the 60 req\u002Fhr anonymous rate limit):\n\n```bash\npython $HERMES_HOME\u002Fskills\u002Fdevops\u002Fwatchers\u002Fscripts\u002Fwatch_github.py \\\n  --name hermes-issues --repo NousResearch\u002Fhermes-agent --scope issues\n```\n\nPoll an arbitrary JSON API:\n\n```bash\npython $HERMES_HOME\u002Fskills\u002Fdevops\u002Fwatchers\u002Fscripts\u002Fwatch_http_json.py \\\n  --name api --url https:\u002F\u002Fapi.example.com\u002Fevents \\\n  --id-field event_id --items-path data.events\n```\n\n## Wiring into cron\n\nAsk the agent to schedule a cron job with a prompt like:\n\n> Every 15 minutes, run `watch_rss.py --name hn --url https:\u002F\u002Fnews.ycombinator.com\u002Frss`. If it prints anything, summarize the headlines and deliver them. If it prints nothing, stay silent.\n\nThe agent invokes the script via the terminal tool inside the cron job's agent loop; no changes to cron's built-in `--script` flag are needed.\n\n## State files\n\nEvery watcher writes `$HERMES_HOME\u002Fwatcher-state\u002F\u003Cname>.json`. Inspect:\n\n```bash\ncat $HERMES_HOME\u002Fwatcher-state\u002Fhn.json\n```\n\nForce a replay (next run treated as first poll):\n\n```bash\nrm $HERMES_HOME\u002Fwatcher-state\u002Fhn.json\n```\n\n## Writing your own\n\nAll three scripts use the same template: load watermark, fetch, diff, save, emit. `scripts\u002F_watermark.py` is the shared helper; import it to get atomic writes + bounded ID set + first-run baseline for free. See any of the three reference scripts for how little boilerplate it takes.\n\n## Common Pitfalls\n\n1. **Printing a \"no new items\" header every tick.** Callers rely on empty stdout = silent. If you print anything on an empty delta, you spam the channel. The shipped scripts handle this; custom scripts must too.\n2. **Expecting the first run to emit items.** It won't — first run records a baseline. If you need an initial digest, delete the state file after the first run or add a `--prime-with-latest N` flag in your own script.\n3. **Unbounded watermark growth.** The shared helper caps at 500 IDs. Raise it for high-churn feeds; lower it on constrained filesystems.\n4. **Putting the state dir where the agent's sandbox can't write.** `$HERMES_HOME\u002Fwatcher-state\u002F` is always writable. Docker\u002FModal backends may not see arbitrary host paths.\n\n","# Watchers\n\nPoll external sources on an interval and react only to new items. Three ready-made scripts plus a shared watermark helper; wire them into a cron job (or run them ad-hoc from the terminal).\n\n## When to Use\n\n- User wants to watch an RSS\u002FAtom feed and be notified of new entries\n- User wants to watch a GitHub repo's issues \u002F pulls \u002F releases \u002F commits\n- User wants to poll an arbitrary JSON endpoint and get notified on new items\n- User asks for \"a watcher for X\" or \"notify me when X changes\"\n\n## Mental model\n\nA watcher is just a script that:\n\n1. Fetches data from the external source\n2. Compares against a watermark file of previously-seen IDs\n3. Writes the new watermark back\n4. Prints new items to stdout (or nothing on no-change)\n\nThe scripts below handle all three. The agent runs them via the terminal tool — from a cron job, a webhook, or an interactive chat — and reports what's new.\n\n## Ready-made scripts\n\nAll three live in `$HERMES_HOME\u002Fskills\u002Fdevops\u002Fwatchers\u002Fscripts\u002F` once the skill is installed. Each reads `WATCHER_STATE_DIR` (defaults to `$HERMES_HOME\u002Fwatcher-state\u002F`) for its state file, keyed by the `--name` argument.\n\n| Script | What it watches | Dedup key |\n|---|---|---|\n| `watch_rss.py` | RSS 2.0 or Atom feed URL | `\u003Cguid>` \u002F `\u003Cid>` |\n| `watch_http_json.py` | Any JSON endpoint returning a list of objects | Configurable id field |\n| `watch_github.py` | GitHub issues \u002F pulls \u002F releases \u002F commits for a repo | `id` \u002F `sha` |\n\nAll three:\n\n- First run records a baseline — never replays existing feed\n- Watermark is a bounded ID set (max 500) to cap memory\n- Output format: `## \u003Ctitle>\\n\u003Curl>\\n\\n\u003Coptional body>` per item\n- Empty stdout on no-new — the caller treats that as silent\n- Non-zero exit on fetch errors\n\n## Usage\n\nRun a watcher directly from the terminal tool:\n\n```bash\npython $HERMES_HOME\u002Fskills\u002Fdevops\u002Fwatchers\u002Fscripts\u002Fwatch_rss.py \\\n  --name hn --url https:\u002F\u002Fnews.ycombinator.com\u002Frss --max 5\n```\n\nWatch a GitHub repo (set `GITHUB_TOKEN` in `${HERMES_HOME:-~\u002F.hermes}\u002F.env` to avoid the 60 req\u002Fhr anonymous rate limit):\n\n```bash\npython $HERMES_HOME\u002Fskills\u002Fdevops\u002Fwatchers\u002Fscripts\u002Fwatch_github.py \\\n  --name hermes-issues --repo NousResearch\u002Fhermes-agent --scope issues\n```\n\nPoll an arbitrary JSON API:\n\n```bash\npython $HERMES_HOME\u002Fskills\u002Fdevops\u002Fwatchers\u002Fscripts\u002Fwatch_http_json.py \\\n  --name api --url https:\u002F\u002Fapi.example.com\u002Fevents \\\n  --id-field event_id --items-path data.events\n```\n\n## Wiring into cron\n\nAsk the agent to schedule a cron job with a prompt like:\n\n> Every 15 minutes, run `watch_rss.py --name hn --url https:\u002F\u002Fnews.ycombinator.com\u002Frss`. If it prints anything, summarize the headlines and deliver them. If it prints nothing, stay silent.\n\nThe agent invokes the script via the terminal tool inside the cron job's agent loop; no changes to cron's built-in `--script` flag are needed.\n\n## State files\n\nEvery watcher writes `$HERMES_HOME\u002Fwatcher-state\u002F\u003Cname>.json`. Inspect:\n\n```bash\ncat $HERMES_HOME\u002Fwatcher-state\u002Fhn.json\n```\n\nForce a replay (next run treated as first poll):\n\n```bash\nrm $HERMES_HOME\u002Fwatcher-state\u002Fhn.json\n```\n\n## Writing your own\n\nAll three scripts use the same template: load watermark, fetch, diff, save, emit. `scripts\u002F_watermark.py` is the shared helper; import it to get atomic writes + bounded ID set + first-run baseline for free. See any of the three reference scripts for how little boilerplate it takes.\n\n## Common Pitfalls\n\n1. **Printing a \"no new items\" header every tick.** Callers rely on empty stdout = silent. If you print anything on an empty delta, you spam the channel. The shipped scripts handle this; custom scripts must too.\n2. **Expecting the first run to emit items.** It won't — first run records a baseline. If you need an initial digest, delete the state file after the first run or add a `--prime-with-latest N` flag in your own script.\n3. **Unbounded watermark growth.** The shared helper caps at 500 IDs. Raise it for high-churn feeds; lower it on constrained filesystems.\n4. **Putting the state dir where the agent's sandbox can't write.** `$HERMES_HOME\u002Fwatcher-state\u002F` is always writable. Docker\u002FModal backends may not see arbitrary host paths.\n\n",{"name":5,"author":23,"license":14,"version":24,"metadata":25,"platforms":39,"description":7},"Hermes Agent","1.0.0",{"hermes":26},{"tags":27,"category":35,"related_skills":36,"requires_toolsets":37},[28,29,30,31,32,33,34],"cron","polling","rss","github","http","automation","monitoring","devops",[],[38],"terminal",[40,41],"linux","macos","main","0905b0264ce5a54908bedc9637e50251543db132","optional-skills\u002Fdevops\u002Fwatchers",0,"https:\u002F\u002Fgithub.com\u002Fashneil12\u002Fvanilla-hermes-agent-canary","https:\u002F\u002Fgithub.com\u002Fashneil12","2026-11-04 08:25:00",{"source":8,"skillName":5,"commands":50,"prompt":60,"zipAvailable":61},[51,54,57],{"tool":52,"command":53},"npx","npx skills add ashneil12\u002Fvanilla-hermes-agent-canary --skill watchers",{"tool":55,"command":56},"bunx","bunx skills add ashneil12\u002Fvanilla-hermes-agent-canary --skill watchers",{"tool":58,"command":59},"pnpm","pnpm dlx skills add ashneil12\u002Fvanilla-hermes-agent-canary --skill watchers","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fashneil12\u002Fvanilla-hermes-agent-canary\u002Fblob\u002Fmain\u002Foptional-skills\u002Fdevops\u002Fwatchers\u002FSKILL.md",true,[63,69,73,77],{"path":64,"resourceType":65,"resourceTypeDesc":66,"sizeBytes":67,"sourceHtmlUrl":68},"scripts\u002F_watermark.py","SCRIPT","脚本",5243,"https:\u002F\u002Fgithub.com\u002Fashneil12\u002Fvanilla-hermes-agent-canary\u002Fblob\u002Fmain\u002Foptional-skills\u002Fdevops\u002Fwatchers\u002Fscripts\u002F_watermark.py",{"path":70,"resourceType":65,"resourceTypeDesc":66,"sizeBytes":71,"sourceHtmlUrl":72},"scripts\u002Fwatch_github.py",6203,"https:\u002F\u002Fgithub.com\u002Fashneil12\u002Fvanilla-hermes-agent-canary\u002Fblob\u002Fmain\u002Foptional-skills\u002Fdevops\u002Fwatchers\u002Fscripts\u002Fwatch_github.py",{"path":74,"resourceType":65,"resourceTypeDesc":66,"sizeBytes":75,"sourceHtmlUrl":76},"scripts\u002Fwatch_http_json.py",4589,"https:\u002F\u002Fgithub.com\u002Fashneil12\u002Fvanilla-hermes-agent-canary\u002Fblob\u002Fmain\u002Foptional-skills\u002Fdevops\u002Fwatchers\u002Fscripts\u002Fwatch_http_json.py",{"path":78,"resourceType":65,"resourceTypeDesc":66,"sizeBytes":79,"sourceHtmlUrl":80},"scripts\u002Fwatch_rss.py",4114,"https:\u002F\u002Fgithub.com\u002Fashneil12\u002Fvanilla-hermes-agent-canary\u002Fblob\u002Fmain\u002Foptional-skills\u002Fdevops\u002Fwatchers\u002Fscripts\u002Fwatch_rss.py",[82,89,96,103,110,117],{"skillNo":83,"name":84,"nameZh":6,"description":85,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":18},"01M7380YR13A23353XT9NS6EGR","blocked-page-recovery","Use when a fetch fails: 403\u002F429, paywall, WAF, bot wall.","https:\u002F\u002Fgithub.com\u002Fashneil12\u002Fvanilla-hermes-agent-canary\u002Fblob\u002Fmain\u002Fskills\u002Fweb\u002Fblocked-page-recovery\u002FSKILL.md",[],[],{"skillNo":90,"name":91,"nameZh":6,"description":92,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":93,"categories":94,"keywords":95,"publishedAt":18},"01M7380VZ8P60Q64J3F92D4AMY","test-driven-development","TDD: enforce RED-GREEN-REFACTOR, tests before code.","https:\u002F\u002Fgithub.com\u002Fashneil12\u002Fvanilla-hermes-agent-canary\u002Fblob\u002Fmain\u002Fskills\u002Fsoftware-development\u002Ftest-driven-development\u002FSKILL.md",[],[],{"skillNo":97,"name":98,"nameZh":6,"description":99,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":100,"categories":101,"keywords":102,"publishedAt":18},"01M7380QXN6F90R0MH1M3FHRKX","systematic-debugging","4-phase root cause debugging: understand bugs before fixing.","https:\u002F\u002Fgithub.com\u002Fashneil12\u002Fvanilla-hermes-agent-canary\u002Fblob\u002Fmain\u002Fskills\u002Fsoftware-development\u002Fsystematic-debugging\u002FSKILL.md",[],[],{"skillNo":104,"name":105,"nameZh":6,"description":106,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":107,"categories":108,"keywords":109,"publishedAt":18},"01M7380N4BZYT2WRRZN1N9DZ65","spike","Throwaway experiments to validate an idea before build.","https:\u002F\u002Fgithub.com\u002Fashneil12\u002Fvanilla-hermes-agent-canary\u002Fblob\u002Fmain\u002Fskills\u002Fsoftware-development\u002Fspike\u002FSKILL.md",[],[],{"skillNo":111,"name":112,"nameZh":6,"description":113,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":114,"categories":115,"keywords":116,"publishedAt":18},"01M7380JAEC9ZH5DVPHHK56P97","simplify-code","Parallel 4-agent cleanup of recent code changes.","https:\u002F\u002Fgithub.com\u002Fashneil12\u002Fvanilla-hermes-agent-canary\u002Fblob\u002Fmain\u002Fskills\u002Fsoftware-development\u002Fsimplify-code\u002FSKILL.md",[],[],{"skillNo":118,"name":119,"nameZh":6,"description":120,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":121,"categories":122,"keywords":123,"publishedAt":18},"01M7380F5MBB7FKWWV3G3TZ193","requesting-code-review","Pre-commit review: security scan, quality gates, auto-fix.","https:\u002F\u002Fgithub.com\u002Fashneil12\u002Fvanilla-hermes-agent-canary\u002Fblob\u002Fmain\u002Fskills\u002Fsoftware-development\u002Frequesting-code-review\u002FSKILL.md",[],[]]