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.
An exemplary operational skill body: executable commands with environment-specific prerequisites, ordered phases with validation checkpoints and recovery loops for each failure mode, and clean delegation to sibling skills instead of duplicating their detail. The only nit is mild duplication of the frontmatter in the opening paragraphs.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with non-obvious environment facts Claude cannot know (pypi proxy because 'public pypi is TLS-blocked in this environment', 'storageState expires ~daily', server-side semgrep being authoritative), so nearly every token earns its place. It misses the 5 anchor only because the opening two paragraphs partly restate the frontmatter description and could be trimmed. | 4 / 5 |
Actionability | Every phase provides copy-paste-ready commands with exact env vars, flags, and paths (e.g., the uvx semgrep invocations and the pytest command with '-p no:xdist'), plus exit-code interpretation, the results file location (logs/validation-report.md), and remediation steps. The few placeholders (<changed-template-dirs>, <shared-app-url>) are necessarily instance-specific, so this matches the 5 anchor rather than 4. | 5 / 5 |
Workflow Clarity | Phases are explicitly ordered 'Run the phases in order: 1 → 2 → 3' with a stated reason (fast local gates before the ~1 hr deploy phase), and each phase has validation checkpoints plus feedback loops: drift → fix source and re-run sync; 'storageState invalid/expired' → recreate via auth_setup.py; semgrep false positive → documented suppression procedure. This matches the 5 anchor's explicit-validation/feedback-loop profile. | 5 / 5 |
Progressive Disclosure | No bundle files exist (references/, scripts/, assets/ are absent), and none are needed: the ~73-line body is well-organized per phase and delegates depth to clearly-signaled sibling skills ('(See the sync-check skill)', 'Use the validate-templates skill') exactly one level deep. This matches the 5 anchor's clear-overview/well-signaled-one-level-references structure. | 5 / 5 |
Total | 19 / 20 Passed |