Content
93%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.
The body is an exemplary lean, fully executable overview: concrete commands, explicit help pointers, and a clearly sequenced workflow with a freshness checkpoint and reporting requirements. The only meaningful gap is a missing post-sync verification step for its batch operations.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence: "Use this for local Notion archive questions. Desktop reads local cache; API sync needs NOTION_TOKEN and page access." Every line is a path, command, or workflow step with no padding or explanations of known concepts, matching the 'every token earns its place' anchor. | 5 / 5 |
Actionability | Commands are copy-paste ready and cover the common cases: `notcrawl sync --source desktop`, `notcrawl search --limit 20 "query"`, `notcrawl sql "select count(*) from pages;"`, `notcrawl export-md`, plus explicit `--help` pointers for full syntax. Matches the 'fully executable; specific examples cover the common cases' anchor. | 5 / 5 |
Workflow Clarity | The 4-step Query Workflow is clearly sequenced with a leading freshness checkpoint and a reporting step ("Report date spans, page/database IDs, counts, and source limits"), matching the 'clear sequence with most checkpoints present; minor validation gaps' anchor. Not 5 because sync/export-md are batch operations with no post-operation verification step (e.g., re-running `notcrawl status` after sync); not 3 because a freshness checkpoint and source-limit caveats are explicitly present. | 4 / 5 |
Progressive Disclosure | The skill is under 50 lines, needs no external references (none exist in the bundle), and is organized into clear sections (Sources, Refresh, Query Workflow). Per the guideline, a short skill with no need for external references scores 5 with well-organized sections. | 5 / 5 |
Total | 19 / 20 Passed |