watchers

Poll RSS/Atom feeds, GitHub repositories, and JSON endpoints for new items.

4|Updated May 18, 2026
One-click install
npx skills add https://github.com/ZardLi1115/zedclaw --skill watchers-zardli1115
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: watchers
Source: https://github.com/ZardLi1115/zedclaw/tree/main/optional-skills/devops/watchers
Command: npx skills add https://github.com/ZardLi1115/zedclaw --skill watchers-zardli1115

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and assets (resource) components.

What problem does it solve?

You want reliable notifications for newly published content, but you do not want to manually check RSS feeds, GitHub activity, or JSON endpoints every time.

Core Features & Use Cases

  • RSS/Atom Monitoring: Poll a feed URL and emit only entries that have not been seen before using a persisted watermark.
  • GitHub Activity Watching: Poll issues, pulls, releases, or commits for a repository and deduplicate by stable IDs (or commit SHAs).
  • Generic JSON Polling: Poll any HTTP JSON endpoint, extract a list via an optional items-path, and deduplicate by a chosen ID field.
  • Watermark Deduplication: Uses a shared watermark helper that records seen IDs in a bounded state file and stays silent on no-change ticks.

Quick Start

Run the RSS watcher for Hacker News every 15 minutes and have the agent forward any newly emitted headlines to you.

Frequently Asked Questions about watchers

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

FAQPage Schema
How do I monitor an RSS feed for new items and deduplicate results?

To monitor an RSS feed for new items, this Skill polls the URL at intervals and uses a persisted watermark to deduplicate results, emitting only entries that have not been seen before. It stays silent on no-change ticks.

Can I poll a GitHub repository for new releases and commits automatically?

Yes, you can poll GitHub repositories for new releases, commits, issues, or pulls automatically. The Skill deduplicates GitHub activity by stable IDs or commit SHAs and can run via cron-based monitoring or ad-hoc terminal execution.

How does watermark deduplication work when polling JSON HTTP endpoints?

Watermark deduplication records seen IDs in a bounded state file when polling JSON HTTP endpoints. It extracts a list via an optional items-path and deduplicates by a chosen ID field, ensuring deterministic ID-based diffing for new items.

Do I need a database to track seen items for cron-based monitoring?

No database is needed for cron-based monitoring. The Skill uses a bounded watermark memory state file to persist seen items, capturing a first-run baseline with no replay and preventing duplicate notifications on subsequent ticks.

What happens on the first run when I start watching a feed or endpoint?

On the first run of watching a feed or endpoint, the Skill captures a baseline of existing items with no replay. It records current IDs in the watermark state file and stays silent on stdout for empty deltas.

Does this Skill support chat-initiated workflows for watching new content?

Yes, the Skill supports chat-initiated “watch X” workflows for new items such as releases, issues, commits, or events. It applies the same polling and watermark deduplication logic used for cron-based monitoring to chat commands.