Content
67%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 well-organized strategic overview with concrete commands, benchmark tables, and clearly signaled one-level-deep references — but the referenced scripts and reference files do not exist in the bundle, breaking the skill's executable and navigational promises. The Keywords section is the main in-body token waste.
Suggestions
Ship the referenced bundle files (scripts/retention_decomposition_analyzer.py, scripts/customer_segmentation_designer.py, scripts/cs_coverage_calculator.py, and the four references/*.md files) or remove the references to them — as delivered, every command and reference link in the body is dangling.
Cut the ~50-item Keywords section; trigger vocabulary belongs in the frontmatter description, and the body's token budget is better spent on content Claude doesn't already know.
Add explicit validation checkpoints to the workflows (e.g., verify cohorts.json covers 8 quarters of closed/won data before running the decomposition, or re-check the kill list against current ARR before handing it to sales).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The bulk of the body is dense, high-signal tables and benchmarks, but the ~50-entry Keywords section ("CCO, chief customer officer, customer success, retention strategy, gross retention, net retention, NRR, GRR, logo retention...") duplicates the description's triggering job and adds nothing Claude needs, and the boundary statement repeats the frontmatter verbatim. This fits the mostly-efficient-with-unnecessary-content anchor; it is not a 2 because the core content is tight and free of concept re-teaching. | 3 / 5 |
Actionability | Guidance is concrete and executable as written: exact commands ("python scripts/retention_decomposition_analyzer.py path/to/cohorts.json"), specific thresholds ("≥ 90% at growth stage; ≥ 95% at scale"), and defined outputs per workflow. It stops short of a 5 because the invoked paths dangle — no scripts/ or references/ directories exist in the bundle, so the copy-paste commands fail as shipped. | 4 / 5 |
Workflow Clarity | Each workflow has a stated goal, a numbered/bash-commented sequence, cross-check checkpoints ("Cross-check with cs-chro-advisor on comp + leveling"), and a defined output ("Output: top-3 leakage points + 90-day mitigation plan"). These are analytical, non-destructive operations so the validation cap does not apply, but there are no explicit input-verification or error-recovery steps, which keeps it below the 5 anchor. | 4 / 5 |
Progressive Disclosure | The body is well structured for disclosure: each responsibility section signals a one-level-deep reference ("See `references/retention_decomposition.md` for the 7-category churn taxonomy + leading indicator playbook") and a dedicated References section summarizes all four files. However, the actual bundle contains no references/, scripts/, or assets/ directories, so every referenced path is broken — scoring against the real bundle structure, this drops it from the 5 anchor to the good-structure-with-minor-gaps anchor. | 4 / 5 |
Total | 15 / 20 Passed |