Content
63%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-sequenced, highly actionable analysis workflow with concrete formulas, contracts, and thresholds, but it is a monolithic ~750-line single file with no progressive disclosure and noticeable duplication between report templates, output contracts, and checkpoint renderings. The tool-specific data-pull step is also the least specified part of an otherwise executable process.
Suggestions
Move the per-analysis output schemas, field-mapping tables, and full report format templates into reference files (e.g., references/analysis-schemas.md, references/report-templates.md) and keep SKILL.md as a lean overview with one-level-deep links.
De-duplicate the report content currently rendered three times — keep the format template in one place and have the output contract and checkpoint reference it rather than restate it.
Add error-recovery guidance for the Step 1 checkpoint (what to do when the data looks wrong: re-check field mapping, re-pull with corrected dates, or proceed with degraded analysis) and at least one example query per access method for the most common CRMs.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly dense, useful operational content (metric formulas, contracts, thresholds), but it is noticeably padded in places: the report content is rendered three times (Executive Summary Format template, Output Contract, and Human Checkpoint template), and phrases like "What a founder reads over morning coffee" and "that would normally take 30-60 minutes of manual CRM digging" add no instruction. Not 4 because the duplication between the format templates and the checkpoint/output contracts is more than minor trimming; not 2 because the bulk is genuinely non-obvious domain guidance rather than explanations of things Claude already knows. | 3 / 5 |
Actionability | Highly concrete for an instruction-only skill: exact metric formulas ("(Meetings booked - Meetings held) / Meetings booked"), full standardized data structures, report templates, default stage probabilities, and a recommendations table keyed to specific thresholds (qual rate <40%, no-show >20%, coverage <2x). Not 5 because the data-pull step gives only high-level direction ("SOQL query or user uploads CSV export", "Query deals/outreach_log tables") with no example query or export path, leaving the most tool-dependent step under-specified. | 4 / 5 |
Workflow Clarity | Steps 0-4 are clearly sequenced with per-step input/output contracts, an execution summary table, and explicit human checkpoints (Step 1 "Data looks correct? (Y/n)" validates data before analysis; Step 3 gates report delivery). Not 5 because the checkpoints lack error-recovery feedback loops — there is no guidance on what to do when the Step 1 data check fails (re-pull, fix mapping, proceed anyway); not 3 because validation checkpoints are explicit and well-placed, not merely implicit. | 4 / 5 |
Progressive Disclosure | The single SKILL.md (~750 lines) has good section structure but no bundle files at all — everything is inline, including detailed material that clearly belongs in separate reference files (field-mapping tables, per-analysis output schemas, full report format templates, the recommendations pattern table). This matches the anchor for structure present but content that should be separate is inline; the under-50-line simple-skill exception does not apply. Not 4 because a skill this size with no one-level-deep references forces the full detail into context on every load. | 3 / 5 |
Total | 14 / 20 Passed |