watchers

Poll RSS, JSON endpoints, and GitHub activity with per-watcher watermark deduplication.

31|3|Updated May 7, 2026
One-click install
npx skills add https://github.com/markwang2658/hermes-windows-native --skill watchers-markwang2658
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: watchers
Source: https://github.com/markwang2658/hermes-windows-native/tree/main/hermes-agent/optional-skills/devops/watchers
Command: npx skills add https://github.com/markwang2658/hermes-windows-native --skill watchers-markwang2658

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Poll external data sources (RSS feeds, JSON endpoints, and GitHub activity) while deduplicating previously seen items using a per-watcher watermark.

Core Features & Use Cases

  • Polls RSS, JSON APIs, and GitHub activity on a schedule and emit only new items.
  • Maintains a watermark state per watcher to avoid duplicate notifications.
  • Ready-made scripts provide end-to-end watch functionality and Markdown-formatted output for delivery.

Quick Start

Run a watcher script from the Hermes terminal tool with a unique watcher name and source URL or repository details to start monitoring.

Frequently Asked Questions about watchers

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I poll RSS feeds and JSON endpoints without getting duplicate notifications?

You can poll RSS feeds and JSON endpoints without duplicate notifications by using a per-watcher watermark. This mechanism persists state for each watcher, ensuring only new items are emitted on subsequent runs.

Can I monitor GitHub activity like issues, pulls, and releases on a schedule?

Yes, you can monitor GitHub activity including issues, pulls, releases, and commits on a schedule. The tool supports cron-driven and ad-hoc runs across Linux and macOS to track repository changes.

How does a watermark help deduplicate items when polling external data sources?

A watermark deduplicates items by persisting the state of seen items per watcher to a watcher-state file. When polling external data sources, it checks against this state and emits only new items formatted as Markdown.

Does this polling tool work on both Linux and macOS?

Yes, this polling tool works on both Linux and macOS. It provides a compact Python toolset under scripts/ that supports cron-driven and ad-hoc runs across both operating systems for monitoring feeds and GitHub activity.

What is the best way to format new items from RSS and GitHub polling for delivery?

The best way to format new items from RSS and GitHub polling for delivery is using Markdown. The tool's shared watermark helper formats newly detected items as Markdown output, making them ready for delivery.