Content
60%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 strong operational detail — executable command patterns, complete parameter and error tables, and a well-checkpointed workflow — but it is a monolithic ~400-line file that inlines reference material and points to script files missing from the bundle, with padding (promo footer, duplicated env vars, DB schema) that hurts token efficiency.
Suggestions
Ship the eight referenced scripts (launch_unified_campaign.py, validate_unified_campaign.py, etc.) in a scripts/ directory — or remove the command examples — since every workflow step currently depends on files that do not exist in the bundle.
Move reference-heavy material (Objective Mapping table, Platform-Specific Notes, Environment Variables, Database Schema) into one-level-deep reference files (e.g., references/platforms.md, references/objective-mapping.md) and keep SKILL.md as a concise overview with clearly signaled links.
Trim the promotional 'About this skill' footer, de-duplicate the env-var documentation (it appears in both Platform-Specific Notes and Environment Variables), and fix the stray '3.' list fragment after the env-var code block.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient — the tables, commands, and platform quirks (e.g., "Budgets in micros (multiply by 1,000,000)") are project-specific knowledge Claude lacks — but it carries unnecessary weight: a ~10-line promotional footer, env vars documented twice (Platform-Specific Notes and Environment Variables), a database schema tangential to launching, and a stray "3. Tokens refreshed automatically if expired" fragment after the env-var code block. Anchor 3 fits: could be noticeably tightened, beyond the "minor instances" of anchor 4. | 3 / 5 |
Actionability | Guidance is concrete and copy-paste ready: full bash invocations with flags, a complete campaign-config JSON, a parameter table with defaults, and ready-made commands for common cases (quick launch, B2B lead gen, weighted budget). It is not 5 because the eight referenced scripts/launch_unified_campaign.py-style files do not exist in the bundle, so the commands are not actually executable as shipped; it is well above 3 since nothing is pseudocode or vague. | 4 / 5 |
Workflow Clarity | The 6-step workflow (define → validate → dry-run → deploy → check status → sync) is clearly sequenced with explicit checkpoints (Step 2 validation with --check-credentials --check-budgets, Step 3 dry-run) and a pre-flight checklist, so the batch-operation cap at 3 does not apply. Not 5: error recovery lives in a separate cause/solution lookup table rather than being wired into the steps (no inline "if validation fails → fix → re-run" loop). | 4 / 5 |
Progressive Disclosure | Scored against the actual bundle: no references/, scripts/, or assets/ directories exist, so the body's only file references — eight scripts/*.py files — are all broken. Meanwhile ~200 lines of reference material (objective mapping table, per-platform notes, env-var catalog, DB schema) are inlined in a ~400-line monolithic SKILL.md. This matches anchor 2 (content that clearly belongs in separate files is inlined / references non-functional); not 3 because the inlining is heavy and navigation to any supporting material is impossible. | 2 / 5 |
Total | 13 / 20 Passed |