Content
86%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 well-engineered instruction skill: concrete thresholds and a decision tree make it directly actionable, the workflow includes per-batch validation and post-audit measurement appropriate to its destructive batch operations, and detail is properly split into two one-level-deep reference files. The body is efficient with only minor trims available, and the workflow lacks only an explicit error-recovery loop to reach the top anchor.
Suggestions
Add one error-recovery step to the workflow: what to do when the post-batch re-crawl finds broken redirect chains (e.g., fix the chain source, re-crawl the affected URLs, then proceed to the next batch).
Trim minor asides the model doesn't need (the 410-vs-404 processing rationale could shrink to just the directive) to reach full token efficiency.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and operational — a signals table with exact thresholds, a decision tree, a 7-step workflow — with almost no padding or explanation of concepts Claude already knows. Small trims are possible (e.g., the rationale for 410 over 404 and the 'Stack-agnostic' scope line), so it sits just below the leanest anchor. | 4 / 5 |
Actionability | For an instruction-only skill the guidance is fully executable: exact numeric thresholds ("<10/month" sessions, ">24 months" since update, "rank 11 to 30" for update candidates), a concrete ASCII decision tree, per-action signal lists, and a fully specified output format (spreadsheet columns plus a 7-part summary report). These cover the common cases copy-paste ready. | 5 / 5 |
Workflow Clarity | The 7-step workflow is clearly sequenced and — critically for a batch/destructive skill — includes explicit validation: "Do redirects and deletes in batches" with "Re-crawl after each batch to confirm no broken redirect chains" and post-audit measurement at 30/60/90 days, so the destructive-operation cap is not triggered. It falls short of 5 only because there is no error-recovery loop stating what to do when the re-crawl finds broken chains, and the 'Failure patterns' section is a list of cautions rather than a recovery procedure. | 4 / 5 |
Progressive Disclosure | SKILL.md is a well-sectioned overview (when to use / when not to use, framework, thresholds, workflow) with two clearly signaled, one-level-deep references at the end, each with a one-line description of its contents. Verified both files exist and contain no further nested references; the body's output-format section is a condensed preview while the full column definitions live in references/audit-template.md — an appropriate split with easy navigation. | 5 / 5 |
Total | 18 / 20 Passed |