Content
88%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 a strong, highly actionable audit workflow with concrete commands, explicit validation/confirmation gates, and a helpful checklist. Its main weakness is a somewhat dense inline provider-quirk section that could be tightened or moved to a reference file.
Suggestions
Trim or relocate the per-provider API-quirk bullets (Fireworks detail API, OpenRouter ':exacto', Vertex version-suffix handling) into a references/PROVIDERS.md, since check_provider.py already handles them automatically.
Move the manual Bedrock and LiteLLM cross-reference sections into a references/MANUAL_CHECKS.md, keeping only a one-line pointer in Phase 2.
Tighten the 'Providers to skip' list into a single compact line since the rationale per entry is rarely needed at execution time.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient and action-oriented with concrete commands throughout, but the provider-quirk bullets (e.g., Fireworks detail API, OpenRouter ':exacto', Vertex versioned aliases) explain behavior the script already handles and could be trimmed, fitting anchor 4 rather than 5. | 4 / 5 |
Actionability | Fully executable guidance throughout — copy-paste bash commands with full script paths, env-var sourcing, jq pipelines for Bedrock/LiteLLM, grep for locating edit lines, and a concrete report table template — matching anchor 5. | 5 / 5 |
Workflow Clarity | A clear 5-phase sequence (Extract → Check → Report → Mark → Verify) with explicit validation checkpoints (Phase 5 count check, 'Ask the user to confirm before making changes') and a final checklist; the destructive/batch cap is satisfied because validation is present, matching anchor 5. | 5 / 5 |
Progressive Disclosure | Scripts are cleanly externalized one level deep via clear paths (scripts/extract_models.py, scripts/check_provider.py) and the body is well-sectioned by phase, but substantial provider-quirk and manual-check detail lives inline in SKILL.md rather than a separate reference file, fitting anchor 4 over 5. | 4 / 5 |
Total | 18 / 20 Passed |