Content
78%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 highly actionable, well-structured reference whose tables, benchmarks, and templates give Claude everything needed to analyze and fix a subscription funnel. The main defect is progressive disclosure: the body is a ~200-line monolith and its sole reference (revenuecat.md) is a broken pointer to a nonexistent bundle file.
Suggestions
Create the referenced `revenuecat.md` (e.g. under references/) with the RevenueCat billing-retry/grace-period/webhook setup details, or remove the 'See revenuecat.md integration guide' line — as written it points to a file that does not exist in the bundle.
Move the stage-specific detail that is only needed on demand (e.g. the dunning day-by-day schedule and StoreKit 2 win-back setup steps) into one-level-deep reference files, keeping SKILL.md as a metrics/benchmarks overview with clearly signaled links.
Tighten the occasional editorial commentary (e.g. 'Messages should show value, not just create pressure', 'Maximize grace period length — every extra day recovers more subscribers') into the tables they annotate to shave tokens without losing guidance.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense domain-specific material Claude would not already know (benchmarks like "M1 renewal > 70%", "iOS: 6 days (configurable up to 16)"), with tables instead of prose and no concept re-explanation. A few lines ("Messages should show value, not just create pressure", "Maximize grace period length — every extra day recovers more subscribers") are mild commentary that could be trimmed, so anchor 4 rather than a perfectly lean 5. | 4 / 5 |
Actionability | For an instruction-only skill the guidance is fully concrete and executable: a day-by-day dunning schedule ("Day 7 — retry #3 — show in-app 'Update payment method' banner"), a week-by-week win-back offer ladder with specific discounts ("Week 6: 3 months at 50% off"), exact survey options, config paths, and a copy-paste Output Format template — matching anchor 5's specific-examples-covering-common-cases. | 5 / 5 |
Workflow Clarity | The four lifecycle stages are clearly sequenced and the Output Format template functions as a checkpoint (each metric compared to its benchmark to derive "Top issues" and a "Priority action"). There is no explicit validate→fix→retry feedback loop, so this sits at anchor 4 rather than 5; it is not capped at 3 because the skill involves no destructive or batch operations. | 4 / 5 |
Progressive Disclosure | Sections are well-organized, but everything is inlined in one ~200-line file, and the only bundle reference — "See `revenuecat.md` integration guide" — points to a file that does not exist anywhere in the skill directory (no references/, scripts/, or assets/ folders). Per the guideline to score against the actual bundle structure, a dangling reference plus inline content that could be split (RevenueCat/dunning details) matches anchor 3's 'references present but not clearly signaled / content that should be separate is inline'. | 3 / 5 |
Total | 16 / 20 Passed |