Content
75%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 dense, highly actionable instruction skill with excellent concrete heuristics, decision rules, and a rigid output contract. Its weaknesses are token efficiency — textbook formula definitions and a 'Proactive Triggers' section that largely duplicates the 'Anti-Patterns' table — and a workflow whose end-to-end order is implied by section arrangement rather than stated explicitly.
Suggestions
Merge the 'Proactive Triggers' section into the 'Anti-Patterns' table (or vice versa) — optimistic projections/downside case, sunk cost reasoning, opportunity cost, and time-horizon normalization each appear twice with the same guidance; a single 'Triggers & Anti-Patterns' table would cut ~20 lines of duplication.
Drop or compress the standard formula definitions for ROI, NPV, and IRR ('The discount rate at which NPV = 0', 'NPV = Sum of [Cash Flow_t / (1 + r)^t]') — Claude knows these; keep only the business-specific parameters (hurdle-rate tiers, 8-15% cost of capital, the $25K/12-month NPV rule, payback-vs-useful-life thresholds) that are the skill's real value.
Add a short explicit step sequence at the top (e.g., 1. Read company-context.md and gather inputs → 2. Compute ROI/payback/NPV/IRR → 3. Run upside/downside and apply proactive triggers → 4. Emit the Output Format) so the end-to-end workflow is stated rather than inferred from section order.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient but includes content Claude already knows and duplicated sections: it restates standard formulas ('ROI = (Net Gain from Investment / Cost of Investment) × 100', 'NPV = Sum of [Cash Flow_t / (1 + r)^t] - Initial Investment', 'IRR: The discount rate at which NPV = 0') that Claude needs no reminder of, and the 'Proactive Triggers' section substantially duplicates the 'Anti-Patterns' table (optimistic projections→downside case, sunk cost reasoning, opportunity cost, and time-horizon normalization each appear in both with the same guidance). Not a 2 because the majority of the content is genuinely additive business heuristics (hurdle rates, thresholds, decision rules) rather than padding; not a 4 because the formula restatements and the trigger/anti-pattern duplication are clearly trimmable. | 3 / 5 |
Actionability | The guidance is fully concrete and executable for an instruction-only skill: specific decision rules ('Buy if vendor does it ≥80% as well at <50% of the build cost', 'payback <6 months first', 'NPV > $25K or >12-month horizon'), numeric hurdle-rate tiers (10-15% / 20-25% / 30%+), a 1-5 scoring rubric with anchor values, scenario definitions (upside +20%, downside -40%), and a copy-paste-ready output format template with a metrics table. Every common case the description promises has concrete coverage. Not a 4 because there are no missing key details — thresholds, formulas-in-use, and output structure are all specified. | 5 / 5 |
Workflow Clarity | The workflow is clearly sequenced: 'Before Starting' (check company-context.md, gather investment details, projections, context in order), three named analysis modes, then a fixed 'Output Format' ending in RECOMMENDATION and NEXT STEP. Checkpoints are mostly present — confidence tagging (🟢🟡🔴), flagging low-confidence assumptions, running the downside case, and the proactive triggers act as error-catching heuristics. Not a 5 because the end-to-end sequence (gather → compute → validate scenarios → emit format) is implied by section order rather than stated as an explicit ordered procedure, and there is no explicit re-check loop if data contradicts assumptions; not a 3 because the modes, prerequisites, and output contract leave little ambiguity about what to do and when. | 4 / 5 |
Progressive Disclosure | The skill is a single well-organized file (~220 lines) with clear section headers, tables, and a consistent structure; the one cross-file reference ('If `company-context.md` exists, read it before asking questions') is clearly signaled at exactly one level deep with no nesting. Since no bundle files exist, structure is judged on the file itself. Not a 5 because at this length the detailed anti-patterns table and scoring rubric are borderline candidates for a separate reference file, and the simple-skill exception (under 50 lines) does not apply; not a 3 because nothing is buried — every section is discoverable from its header and no content that clearly belongs elsewhere is inlined to the point of hurting navigation. | 4 / 5 |
Total | 16 / 20 Passed |