blogwatcher
Monitor blogs and RSS/Atom feeds for updates using the blogwatcher CLI.
74
63%
Does it follow best practices?
Impact
100%
1.96xAverage score across 3 eval scenarios
Advisory
Suggest reviewing before use
Optimize this skill with Tessl
npx tessl skill review --optimize ./openclaw/skills/blogwatcher/SKILL.mdQuality
Discovery
40%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
The description identifies a clear niche (RSS/Atom feed monitoring via blogwatcher CLI) which makes it distinctive, but it lacks an explicit 'Use when...' clause and lists only a single action rather than enumerating specific capabilities. Adding trigger guidance and more concrete actions would significantly improve skill selection accuracy.
Suggestions
Add an explicit 'Use when...' clause, e.g., 'Use when the user wants to track, subscribe to, or check updates from blogs, RSS feeds, Atom feeds, or news sources.'
List more specific actions the skill supports, e.g., 'Add and remove feed subscriptions, check for new posts, list recent entries, filter updates by keyword or date.'
Include additional natural trigger terms like 'subscribe', 'feed reader', 'new posts', 'syndication', or 'news updates' to improve matching.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (blogs, RSS/Atom feeds) and one action (monitor for updates), and mentions the specific tool (blogwatcher CLI), but doesn't list multiple concrete actions like adding feeds, filtering, exporting, etc. | 2 / 3 |
Completeness | Describes what the skill does (monitor blogs and feeds) but has no explicit 'Use when...' clause or equivalent trigger guidance, which per the rubric should cap completeness at 2, and the 'what' is also thin — so this lands at 1. | 1 / 3 |
Trigger Term Quality | Includes relevant keywords like 'blogs', 'RSS', 'Atom', 'feeds', and 'updates' which users might naturally say, but misses common variations like 'subscribe', 'news feeds', 'syndication', 'feed reader', or 'new posts'. | 2 / 3 |
Distinctiveness Conflict Risk | The combination of RSS/Atom feeds, blog monitoring, and the specific CLI tool 'blogwatcher' creates a clear niche that is unlikely to conflict with other skills. | 3 / 3 |
Total | 8 / 12 Passed |
Implementation
87%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a clean, efficient skill that provides all the essential commands for the blogwatcher CLI with concrete examples and expected output. The only minor weakness is that the commands are listed as a reference rather than sequenced as a workflow, though for this simple tool that's a minor issue. Overall it's a strong, well-structured skill.
Suggestions
Consider reordering the 'Common commands' section into a numbered workflow sequence (install → add blog → scan → view articles → mark read) to make the typical usage flow explicit.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every line serves a purpose—install, commands, example output, and a help tip. No unnecessary explanations of what RSS feeds are or how Go works. | 3 / 3 |
Actionability | All commands are concrete, copy-paste ready, and cover the full lifecycle (add, scan, list, read, remove). Example output shows what to expect. | 3 / 3 |
Workflow Clarity | Commands are listed but not sequenced into a clear workflow (e.g., install → add → scan → articles → read). For a non-destructive CLI this is acceptable but a brief workflow sequence would improve clarity. | 2 / 3 |
Progressive Disclosure | For a simple, single-purpose CLI skill under 50 lines, the content is well-organized with clear sections (install, quick start, commands, example output, notes) and appropriately points to `--help` for deeper discovery. | 3 / 3 |
Total | 11 / 12 Passed |
Validation
72%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 8 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
metadata_version | 'metadata.version' is missing | Warning |
metadata_field | 'metadata' should map string keys to string values | Warning |
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 8 / 11 Passed | |
- Repository
- trpc-group/trpc-agent-go
- Commit
af8bd5f
- Reviewed
Table of Contents
Is this your skill?
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.