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.
The body delivers exceptionally actionable, well-sequenced operational guidance with strong validation checkpoints, and it wastes few tokens on concepts Claude already knows. Its weaknesses are length with duplicated routing guidance, and a progressive-disclosure structure that is entirely broken in practice: every referenced bundle file is missing, leaving a monolithic document whose pointers cannot be followed.
Suggestions
Ship the referenced bundle files (recipes/max-coverage-audience.md, shared/audience-basics.md, shared/upload-failure-modes.md, shared/contactout-hash-pool.md, shared/meta-connection.md, recipes/enrich-and-upload-facebook-google.md, recipes/sample-abm-segment-example.md, and the plays/*.play.ts templates) or remove the pointers — currently every 'Read' link dangles.
Move the ContactOut quick reference, the LinkedIn URL backfill ladder, and the Google coverage-lift reporting detail out of SKILL.md into the shared/recipes files they naturally belong to, slimming the body to an overview plus the decision matrix.
Deduplicate routing: the play input examples appear in both the plays table and the CLI command block, and the decision matrix and reading guide route to overlapping files — consolidate to one navigation path per file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is packed with non-obvious domain knowledge (waterfall-vs-fan-out billing, Meta write locks, encoded LinkedIn slugs) and avoids teaching Claude basics, but at ~340 lines it could be tightened: play inputs are duplicated between the plays table and the CLI block, 'shared/upload-failure-modes.md' is pointed to five separate times, and the decision matrix and reading guide overlap in the files they route to. This matches 'mostly efficient but could be tightened' rather than anchor 4's 'minor instances of over-explanation'. | 3 / 5 |
Actionability | Guidance is fully executable: exact commands ('deepline tools execute meta_audiences_list_ad_accounts --payload …'), complete JSON payloads for every platform operation, concrete field names ('ingestedUserListInfo.contactIdInfo.matchRatePercentage'), and a check-then-run sequence per play. Copy-paste ready examples cover the common cases, matching anchor 5. | 5 / 5 |
Workflow Clarity | The seven-step workflow is clearly sequenced with explicit validation checkpoints throughout: rights confirmation before spend, account discovery before every upload, a pre-upload audit (hash-only, deduped, no double-hash), 'check' before 'run' for plays, and post-upload readback with the rule 'Do not say the audience worked unless create, sync, and readback status all succeeded'. Error-recovery loops (append fallback when Google 'replace' fails, vanity-URL recovery for encoded slugs) match anchor 5. | 5 / 5 |
Progressive Disclosure | Although pointers are well-labeled (decision matrix 'Read' column, reading guide, inline '→ Read shared/upload-failure-modes.md'), none of the referenced files exist in the bundle — recipes/, shared/, and plays/ are all absent — so every reference dangles. Meanwhile detail that clearly belongs in those files (the ContactOut quick reference, the LinkedIn URL backfill ladder, coverage-lift reporting) is inlined in a 339-line body, matching anchor 2's 'content that clearly belongs in separate files is inlined'. | 2 / 5 |
Total | 15 / 20 Passed |