Content
92%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A tight, script-driven skill body: every command is copy-paste ready and verified against the actual bundle script, error handling and verification paths are explicit, and the read-only safety posture is stated up front. The only deduction is a pinned package version in the body, which is time-sensitive and will age.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean and dense throughout — tables for job kinds and troubleshooting, flag semantics in terse bullets, no explanations of concepts Claude already knows — but the body pins a specific package version ("--autorag-cli npx -y -p @autorag/librarian@2.13.12 autorag"), which is time-sensitive information outside an old-patterns/deprecated section. Per the rubric's time-sensitivity guideline this is a minor conciseness penalty. | 4 / 5 |
Actionability | Fully executable copy-paste commands for all four subcommands (index, duplicates, list, remove) with complete flag documentation, defaults, an explicit error gate ("If it exits non-zero, show the user its `error` and stop; do not retry with guessed flags"), and a fallback for a missing AutoRAG CLI. The referenced bundle script exists and implements exactly these commands and flags. | 5 / 5 |
Workflow Clarity | Clear sequence ("Ask for what is missing, then run the helper. Do not guess a schedule the user did not give") with explicit validation (check the helper's JSON output and error exit), verification paths (`list`, `hermes cron status`), idempotency guidance (same `--id` updates rather than duplicates the job), and a symptom→check troubleshooting table as feedback loops. Operations are read-only by design ("It never moves, edits or deletes anything"), so the destructive/batch validation cap does not apply. | 5 / 5 |
Progressive Disclosure | Well-organized sections (job-kind table, setup, check/list/remove, user-messaging, troubleshooting) with implementation detail correctly split into the single real bundle file, referenced one level deep via "${HERMES_SKILL_DIR}/scripts/autorag_schedule.py". Nothing that belongs in a separate file is inlined and navigation is easy. | 5 / 5 |
Total | 19 / 20 Passed |