[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7EWDECB490Z1MTTX40FS1XR":3,"skill-same:01M7EWDECB490Z1MTTX40FS1XR":83},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":43,"commitSha":44,"skillDirectory":45,"forksCount":46,"repositoryHtmlUrl":47,"repositoryHomepageUrl":6,"ownerHtmlUrl":48,"ownerBlogUrl":6,"ownerDescription":49,"updatedAt":50,"install":51,"resources":64},"01M7EWDECB490Z1MTTX40FS1XR","watchers",null,"Poll RSS, JSON APIs, and GitHub with watermark dedup.","vallenmulia99\u002Fvallenatrix","vallenmulia99","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F198408142?v=4","01M7EW918D10KEM1PWF6YEAR0R","Vallen Project","01M7EW918ZCWF720ZH8EW1GSSS",1,"MIT","https:\u002F\u002Fgithub.com\u002Fvallenmulia99\u002Fvallenatrix\u002Fblob\u002Fmain\u002F.vallenatrix\u002Fskills\u002Fdevops\u002Fwatchers\u002FSKILL.md",[],[],"2026-11-15 14:19:17",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":24,"license":15,"version":25,"metadata":26,"platforms":40,"description":7},"Hermes Agent","1.0.0",{"hermes":27},{"tags":28,"category":36,"related_skills":37,"requires_toolsets":38},[29,30,31,32,33,34,35],"cron","polling","rss","github","http","automation","monitoring","devops",[],[39],"terminal",[41,42],"linux","macos","main","1f94be184060028b2b6001ca5c0b20e67d7c46a4",".vallenatrix\u002Fskills\u002Fdevops\u002Fwatchers",0,"https:\u002F\u002Fgithub.com\u002Fvallenmulia99\u002Fvallenatrix","https:\u002F\u002Fgithub.com\u002Fvallenmulia99","Project⚡ Developer who loves building systems\r\n💻 C++ • JS • Android • Backend • Pyton\r\n🚀 Turning ideas into reality","2026-10-26 21:03:01",{"source":8,"skillName":5,"commands":52,"prompt":62,"zipAvailable":63},[53,56,59],{"tool":54,"command":55},"npx","npx skills add vallenmulia99\u002Fvallenatrix --skill watchers",{"tool":57,"command":58},"bunx","bunx skills add vallenmulia99\u002Fvallenatrix --skill watchers",{"tool":60,"command":61},"pnpm","pnpm dlx skills add vallenmulia99\u002Fvallenatrix --skill watchers","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fvallenmulia99\u002Fvallenatrix\u002Fblob\u002Fmain\u002F.vallenatrix\u002Fskills\u002Fdevops\u002Fwatchers\u002FSKILL.md",true,[65,71,75,79],{"path":66,"resourceType":67,"resourceTypeDesc":68,"sizeBytes":69,"sourceHtmlUrl":70},"scripts\u002F_watermark.py","SCRIPT","脚本",5241,"https:\u002F\u002Fgithub.com\u002Fvallenmulia99\u002Fvallenatrix\u002Fblob\u002Fmain\u002F.vallenatrix\u002Fskills\u002Fdevops\u002Fwatchers\u002Fscripts\u002F_watermark.py",{"path":72,"resourceType":67,"resourceTypeDesc":68,"sizeBytes":73,"sourceHtmlUrl":74},"scripts\u002Fwatch_github.py",6203,"https:\u002F\u002Fgithub.com\u002Fvallenmulia99\u002Fvallenatrix\u002Fblob\u002Fmain\u002F.vallenatrix\u002Fskills\u002Fdevops\u002Fwatchers\u002Fscripts\u002Fwatch_github.py",{"path":76,"resourceType":67,"resourceTypeDesc":68,"sizeBytes":77,"sourceHtmlUrl":78},"scripts\u002Fwatch_http_json.py",4589,"https:\u002F\u002Fgithub.com\u002Fvallenmulia99\u002Fvallenatrix\u002Fblob\u002Fmain\u002F.vallenatrix\u002Fskills\u002Fdevops\u002Fwatchers\u002Fscripts\u002Fwatch_http_json.py",{"path":80,"resourceType":67,"resourceTypeDesc":68,"sizeBytes":81,"sourceHtmlUrl":82},"scripts\u002Fwatch_rss.py",4114,"https:\u002F\u002Fgithub.com\u002Fvallenmulia99\u002Fvallenatrix\u002Fblob\u002Fmain\u002F.vallenatrix\u002Fskills\u002Fdevops\u002Fwatchers\u002Fscripts\u002Fwatch_rss.py",[84,91,98,105,112,119],{"skillNo":85,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":88,"categories":89,"keywords":90,"publishedAt":19},"01M7EWM7FZR5FZ7P9VSG8GGYMT","blocked-page-recovery","Use when a fetch fails: 403\u002F429, paywall, WAF, bot wall.","https:\u002F\u002Fgithub.com\u002Fvallenmulia99\u002Fvallenatrix\u002Fblob\u002Fmain\u002F.vallenatrix\u002Fskills\u002Fweb\u002Fblocked-page-recovery\u002FSKILL.md",[],[],{"skillNo":92,"name":93,"nameZh":6,"description":94,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":95,"categories":96,"keywords":97,"publishedAt":19},"01M7EWM51ZECRG306KP83GHC7E","unreal-world-builder","开放世界与环境专家——精通 UE5 World Partition、Landscape、程序化植被、HLOD 和大规模关卡流式加载，打造无缝开放世界体验","https:\u002F\u002Fgithub.com\u002Fvallenmulia99\u002Fvallenatrix\u002Fblob\u002Fmain\u002F.vallenatrix\u002Fskills\u002Funreal-engine\u002Funreal-world-builder\u002FSKILL.md",[],[],{"skillNo":99,"name":100,"nameZh":6,"description":101,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":102,"categories":103,"keywords":104,"publishedAt":19},"01M7EWM1Q4FEM4YE0WTSKM82FN","unreal-technical-artist","Unreal Engine 视觉管线专家——精通材质编辑器、Niagara 特效、程序化内容生成和 UE5 项目的美术到引擎管线","https:\u002F\u002Fgithub.com\u002Fvallenmulia99\u002Fvallenatrix\u002Fblob\u002Fmain\u002F.vallenatrix\u002Fskills\u002Funreal-engine\u002Funreal-technical-artist\u002FSKILL.md",[],[],{"skillNo":106,"name":107,"nameZh":6,"description":108,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":109,"categories":110,"keywords":111,"publishedAt":19},"01M7EWKYFYGCVEM3AK40Y3DDJ0","unreal-systems-engineer","性能与混合架构专家——精通 C++\u002FBlueprint 边界、Nanite 几何体、Lumen GI 和 Gameplay Ability System，面向 AAA 级 Unreal Engine 项目","https:\u002F\u002Fgithub.com\u002Fvallenmulia99\u002Fvallenatrix\u002Fblob\u002Fmain\u002F.vallenatrix\u002Fskills\u002Funreal-engine\u002Funreal-systems-engineer\u002FSKILL.md",[],[],{"skillNo":113,"name":114,"nameZh":6,"description":115,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":116,"categories":117,"keywords":118,"publishedAt":19},"01M7EWKVHK186AYQY4M0TZ4WEE","unreal-multiplayer-architect","Unreal Engine 网络专家——精通 Actor 复制、GameMode\u002FGameState 架构、服务端权威玩法、网络预测和 UE5 专用服务器配置","https:\u002F\u002Fgithub.com\u002Fvallenmulia99\u002Fvallenatrix\u002Fblob\u002Fmain\u002F.vallenatrix\u002Fskills\u002Funreal-engine\u002Funreal-multiplayer-architect\u002FSKILL.md",[],[],{"skillNo":120,"name":121,"nameZh":6,"description":122,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":123,"categories":124,"keywords":125,"publishedAt":19},"01M7EWKRPV8H9Z472QYQK373P9","unity-shader-graph-artist","视觉效果与材质专家——精通 Unity Shader Graph、HLSL、URP\u002FHDRP 渲染管线和自定义渲染 Pass，打造实时视觉效果","https:\u002F\u002Fgithub.com\u002Fvallenmulia99\u002Fvallenatrix\u002Fblob\u002Fmain\u002F.vallenatrix\u002Fskills\u002Funity\u002Funity-shader-graph-artist\u002FSKILL.md",[],[]]