Monitor blogs and RSS/Atom feeds for updates using the blogwatcher CLI.
78
70%
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 tool (blogwatcher CLI for RSS/Atom feed monitoring) which makes it distinctive, but it lacks a 'Use when...' clause and doesn't enumerate specific actions beyond 'monitor for updates'. Adding explicit trigger guidance and more concrete capabilities would significantly improve skill selection accuracy.
Suggestions
Add a 'Use when...' clause with trigger terms like 'Use when the user wants to track blog updates, subscribe to RSS feeds, check for new posts, or manage feed subscriptions'.
List more specific actions the skill supports, e.g., 'Add and remove feeds, check for new posts, list tracked blogs, configure update intervals'.
Include common user-facing synonyms such as 'news feeds', 'web subscriptions', 'feed reader', 'new posts' to improve trigger term coverage.
| 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, configuring alerts, etc. | 2 / 3 |
Completeness | Describes what it 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 since the 'when' is entirely missing, it scores a 1. | 1 / 3 |
Trigger Term Quality | Includes relevant keywords like 'blogs', 'RSS', 'Atom', 'feeds', and 'blogwatcher CLI', but misses common variations users might say such as 'subscribe', 'news feeds', 'feed reader', 'check for new posts', or 'web updates'. | 2 / 3 |
Distinctiveness Conflict Risk | The combination of RSS/Atom feeds, blog monitoring, and the specific 'blogwatcher CLI' tool creates a clear niche that is unlikely to conflict with other skills. | 3 / 3 |
Total | 8 / 12 Passed |
Implementation
100%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is an excellent, lean skill that provides everything needed to use the blogwatcher CLI without any wasted tokens. Commands are concrete and copy-paste ready, example output sets clear expectations, and the logical ordering of commands implicitly teaches the workflow. A model example of a simple CLI skill.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every line serves a purpose—install, commands, example output, and a single note. 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 | This is a simple, single-purpose CLI skill. The commands are listed in a logical sequence (add → list → scan → articles → read → remove) that naturally guides usage. No destructive batch operations require validation checkpoints. | 3 / 3 |
Progressive Disclosure | For a simple CLI skill under 50 lines, the content is well-organized with clear sections (install, quick start, commands, example output, notes). No need for external references, and the note about `--help` flags provides a natural discovery path. | 3 / 3 |
Total | 12 / 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 | |
09cce3e
Table of Contents
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.