HezaoHezao/poirot / poirot/backend/agents/skill/builtin_skills/research/blogwatcher
blogwatcher
UnverifiedMonitor blogs and RSS/Atom feeds via blogwatcher-cli.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 3.3 KB |
SKILL.md
View on GitHub---
name: blogwatcher
description: "Monitor blogs and RSS/Atom feeds via blogwatcher-cli."
allowed-tools:
- bash
- read_file
enabled: true
related-skills: []
license: MIT
author: Adapted from hermes-agent (Nous Research, MIT); JulienTant/blogwatcher-cli
---
# Blogwatcher
Track blog and RSS/Atom feed updates with the `blogwatcher-cli` tool. Supports
automatic feed discovery, HTML scraping fallback, OPML import, and read/unread
article management.
## Prerequisites
`blogwatcher-cli` must be installed. Pick one method:
```bash
# Go install
go install github.com/JulienTant/blogwatcher-cli/cmd/blogwatcher-cli@latest
# Binary (Linux amd64)
curl -sL https://github.com/JulienTant/blogwatcher-cli/releases/latest/download/blogwatcher-cli_linux_amd64.tar.gz | tar xz -C /usr/local/bin blogwatcher-cli
# Docker
docker run --rm -v blogwatcher-cli:/data ghcr.io/julientant/blogwatcher-cli scan
```
All releases: https://github.com/JulienTant/blogwatcher-cli/releases
Verify installation:
```bash
blogwatcher-cli --version
```
## When to Use
- User wants to monitor blog updates
- User wants to track RSS/Atom feeds
- User wants to import OPML subscriptions
- User wants a digest of new articles from tracked blogs
## Common Commands
```bash
# Add a blog to track
blogwatcher-cli add https://example.com/blog
# Add with explicit feed URL
blogwatcher-cli add https://example.com/blog --feed https://example.com/feed.xml
# Scan for new articles
blogwatcher-cli scan
# List tracked blogs
blogwatcher-cli list
# List unread articles
blogwatcher-cli articles --unread
# Mark article as read
blogwatcher-cli read <article-id>
# Import OPML
blogwatcher-cli import subscriptions.opml
# Export OPML
blogwatcher-cli export > subscriptions.opml
```
## Workflow
### Setup (first time)
```bash
# Install blogwatcher-cli (see Prerequisites)
# Add blogs to track
blogwatcher-cli add https://blog1.com
blogwatcher-cli add https://blog2.com
# Or import existing OPML
blogwatcher-cli import my-subscriptions.opml
```
### Daily check
```bash
# Scan for new articles
blogwatcher-cli scan
# Show unread
blogwatcher-cli articles --unread
# Read an article (marks as read)
blogwatcher-cli read <article-id>
```
### Automated monitoring
Set up a cron job to scan periodically:
```bash
# Scan every morning at 8am
echo "0 8 * * * blogwatcher-cli scan" | crontab -
```
## Docker with persistent storage
The database lives at `~/.blogwatcher-cli/blogwatcher-cli.db` by default. In
Docker, use a volume to persist:
```bash
# Named volume
docker run --rm -v blogwatcher-cli:/data -e BLOGWATCHER_DB=/data/blogwatcher-cli.db ghcr.io/julientant/blogwatcher-cli scan
# Host bind mount
docker run --rm -v /path/on/host:/data -e BLOGWATCHER_DB=/data/blogwatcher-cli.db ghcr.io/julientant/blogwatcher-cli scan
```
## Pitfalls
- **blogwatcher-cli not installed**: this skill requires the external tool.
Install first (see Prerequisites).
- **Feed discovery fails**: some sites don't expose `<link rel="alternate">`
tags. Use `--feed` to specify the feed URL explicitly.
- **Rate limiting**: scanning many feeds rapidly may get you blocked. The tool
handles this, but don't run `scan` too frequently.
- **Database location**: if using Docker, always set `BLOGWATCHER_DB` to a
volume-mounted path, or data is lost on container exit.
- **OPML encoding**: ensure OPML files are UTF-8 encoded for proper import.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |