Content
85%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 is a strong, opinionated instruction skill: concrete examples and rewrite pairs throughout, clearly sequenced modes with an explicit score-then-rewrite validation loop, and only minor redundancy across its avoid-lists. Its one real defect is bundle integrity — all four referenced resources (three reference files and the analyzer script the workflow mandates) are missing from the bundle, breaking navigation and the scoring loop at runtime.
Suggestions
Add the referenced bundle files — references/frameworks.md, references/follow-up-playbook.md, references/deliverability-guide.md, and scripts/email_sequence_analyzer.py. The body cites all four (and mandates running the analyzer on every sequence) but none exist, so the progressive-disclosure structure and validation loop are unusable as shipped.
Consolidate the repeated avoid-patterns into a single location: fake Re:/Fwd: appears in both the subject-line section and the What to Avoid table, and "just checking in" appears in Follow-Up Rules, What to Avoid, and Proactive Triggers.
Trim the Related Skills section's email-sequence boundary text, which restates the frontmatter description's NOT-for clause, and fold any needed routing into one place.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is opinionated, skill-specific guidance (cadence tables, exact thresholds like "above 5% hurts deliverability", warmup numbers) with little explanation of concepts Claude already knows. Minor trimming opportunities remain: "Fake Re: or Fwd:" appears in both "What Kills Opens" and the "What to Avoid" table; "just checking in" is repeated across Follow-Up Rules, What to Avoid, and Proactive Triggers; and the Related Skills section restates the frontmatter's email-sequence boundary. Efficient, but not every token earns its place — anchor 4 rather than 5. | 4 / 5 |
Actionability | Guidance is copy-paste ready and covers the common cases: the tool invocation "python3 scripts/email_sequence_analyzer.py sequence.json (no arg = embedded demo; `-` reads stdin)", a fill-in breakup email template, paired ❌/✅ rewrite examples for openers and subject lines, per-audience calibration specs, and a deliverables table mapping requests to outputs. This matches the fully-executable anchor; it is not anchor 4, which allows for gaps in the concrete material. | 5 / 5 |
Workflow Clarity | Three numbered mode workflows with clear conditionals ("When they need a single first-touch email", "When they have an active sequence"), a review checkpoint ("Review against the principles below — cut anything that doesn't earn its place"), and an explicit validation feedback loop with a threshold and re-score: "any email scoring below 70 gets rewritten against the flagged dimensions (spam triggers and CTA clarity first), then re-scored." This is the anchor-5 pattern of explicit validation with error-recovery loops, not the anchor-4 pattern of implicit checkpoints. | 5 / 5 |
Progressive Disclosure | The body is well-sectioned and clearly signals one-level-deep references ("See `references/frameworks.md`", "See `references/follow-up-playbook.md`", "See `references/deliverability-guide.md`", plus the analyzer script), but none of these files exist in the bundle — there are no references/, scripts/, or assets/ directories. Signaling is good, yet navigation is broken: the promised content split is not delivered, so the structure cannot be relied on. This lands at anchor 3 (structure present but organization undermined) rather than 4 ('most content is appropriately placed'), and well above 2 (references are prominently signaled, not buried or inlined). | 3 / 5 |
Total | 17 / 20 Passed |