Content
73%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-structured, highly actionable body with an exemplary gated workflow and concrete validation, but it suffers from notable internal repetition and leaves a bundled ready-made generation script unreferenced. Tightening the duplicated catalog/story rules and linking the script would lift it to top-tier.
Suggestions
Consolidate the catalog-confirmation rule — currently stated in the opening blockquote, Critical Rule 6, the 'MUST DO: Confirm Catalog' section, Step 1, and the pre-generation checklist — into one authoritative section plus the checklist item.
Merge the 'Data Must Tell a Business Story' principles with the overlapping Critical Rules 1–4 (story, industry terms/simple schema, never uniform) to remove near-verbatim duplication and save tokens.
Reference scripts/generate_synthetic_data.py from the body (e.g., in a 'Ready-made script' row of the References table) so the complete bundled generation template is discoverable.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly dense and skill-specific (tables, code, checklists) rather than explaining known concepts, but it could be tightened: the catalog-confirmation rule is restated five times (opening blockquote, Critical Rule 6, the 'MUST DO' section, Step 1, and the checklist), and the 'Data Must Tell a Business Story' principles are duplicated nearly verbatim in Critical Rules 1–4. | 3 / 5 |
Actionability | Concrete and largely executable: full Databricks Connect + pandas_udf snippet, uv install command, partition counts by scale, log-normal parameters, FK join pattern, and a runnable validation SQL command. Minor gaps: CATALOG/SCHEMA/N_ORDERS constants are undefined placeholders in snippets, and the weighted-categories example uses independent F.rand() calls so the implied 60/30/10 split doesn't hold exactly. | 4 / 5 |
Workflow Clarity | Clear sequence (gather requirements → present plan with story → select features → checklist → generate → validate) with an explicit pre-generation checklist, a hard gate ('Do NOT proceed to code generation until user approves'), and a concrete post-generation validation step (databricks query SQL, row counts, referential integrity) with error-recovery pointers to the troubleshooting reference and Common Issues table. | 5 / 5 |
Progressive Disclosure | Good structure: both reference files (1-data-patterns.md, 2-troubleshooting.md) exist, are one level deep, and are surfaced via a condition-based 'When | Guide' table plus inline links. However, the bundle's scripts/generate_synthetic_data.py (a complete ready-made generation script) and the assets/ files are never referenced in the body, so Claude would never discover them. | 4 / 5 |
Total | 16 / 20 Passed |