Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A well-structured, concise instruction skill with a clear sequenced workflow and concrete accounting/verification gates. Its main weakness is actionability: the heuristics are principles rather than executable commands or code, even though the workflow and output template are specific.
Suggestions
Add one or two short executable snippets (e.g., a SQL/CLI idiom for manifest-based skip or a backlog-measurement query) so the Fast Path Heuristics move from principle to copy-paste guidance.
Show the accounting-output block as a fillable template with placeholders (e.g., '<source files>', '<raw rows>') alongside the worked example so Claude knows which fields to populate.
Make the 'safe catch-up or sample benchmark' step (workflow step 3) concrete by naming what a safe sample benchmark looks like (size, isolation, rollback).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean bullet-driven body that assumes Claude's competence; it does not explain what ETL, manifests, or warehouses are, and every section earns its tokens. | 3 / 3 |
Actionability | The workflow, measurement checklist, and accounting template are concrete and copy-paste ready, but the bulk ('Move compute to where the data already is', 'Prefer warehouse-native scans', 'Make writes idempotent') is heuristic principle rather than executable code or commands. | 2 / 3 |
Workflow Clarity | A clear 7-step numbered sequence with explicit verification gates — the 'Correctness gate' accounting block, 'Promote only the fastest path that keeps counts and timestamps coherent', and 'Rerun final accounting' — plus guardrails that act as feedback constraints for batch operations. | 3 / 3 |
Progressive Disclosure | Well-organized into clearly signaled sections (First Distinction, Fast Path Heuristics, Workflow, Accounting Output, Guardrails) with no external references needed and no nested indirection. | 3 / 3 |
Total | 11 / 12 Passed |