Content
83%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 lean, highly actionable skill body with excellent copy-paste examples and a well-signaled parameter table. The main weaknesses are the absence of any post-crawl verification step for a batch operation and a full parameter table inlined that could be split into a reference file.
Suggestions
Add a verification step after crawling, e.g. "Check the returned page count and query cache({ query: ... }) on one URL to confirm pages landed in the local cache before running find_similar."
Move the full parameter table to a references/ file (e.g. PARAMETERS.md) and keep only the most-used parameters inline in SKILL.md.
Add an explicit error-recovery note for the common failure cases, such as what to do when the sitemap is missing (fall back to BFS) or when robots.txt blocks the seed URL.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and dense: a four-snippet JSON quick-reference, a parameter table with a "When to use" column, terse anti-patterns, and a short "After Crawling" section. It explains nothing Claude already knows, and every token earns its place, matching the anchor-5 example. It is not 4 because there is no over-explanation left to trim. | 5 / 5 |
Actionability | Copy-paste-ready tool-call JSON covers the common cases (sitemap crawl, scoped BFS, URL-map discovery, authenticated crawl), and the parameter table gives types, defaults, and usage guidance (e.g., "include_patterns — ALWAYS add to stay in scope"). It is not 4 because the examples are complete and executable, not just mostly concrete. | 5 / 5 |
Workflow Clarity | A sensible flow exists (pick strategy and limits via the quick-reference and anti-patterns → crawl → query with cache/find_similar), but a crawl is a batch operation and there is no validation or verification checkpoint — e.g., confirming the returned page count or that pages actually landed in the cache before issuing cache/find_similar queries. Per the rubric's batch-operation cap, workflow clarity cannot exceed 3 here. It is not 2 because "After Crawling" does sequence the follow-up steps explicitly. | 3 / 5 |
Progressive Disclosure | Well-organized sections (Quick Reference, Parameters, After Crawling, Anti-Patterns, When NOT to use, See Also) with one-level-deep references to sibling skills. It is not 5 because the body is ~64 lines (above the under-50 simple-skill threshold) and the full 12-row parameter table is bulk reference material that could live in a separate reference file; it is not 3 because structure and navigation are clear with nothing buried. | 4 / 5 |
Total | 17 / 20 Passed |