CtrlK
BlogDocsLog inGet started
Tessl Logo

business-investment-advisor

Business investment analysis and capital allocation advisor. Use when evaluating whether to invest in equipment, real estate, a new business, hiring, technology, or any capital expenditure. Also use for ROI calculations, IRR, NPV, payback period, build vs buy decisions, lease vs buy analysis, vendor evaluation, or deciding where to allocate limited budget for maximum return.

70

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

75%Weight 40%Scale 1-5

Reviews 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.

DimensionReasoningScore

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

Description

96%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: third-person, explicit 'Use when...' triggers, comprehensive natural keyword coverage, and concrete capability naming. The only weakness is that scoping boundaries (what this skill is NOT for) live in the body rather than the description, leaving minor overlap risk with adjacent finance skills.

DimensionReasoningScore

Specificity

The description lists multiple concrete, specific capabilities — 'evaluating whether to invest in equipment, real estate, a new business, hiring, technology, or any capital expenditure' plus 'ROI calculations, IRR, NPV, payback period, build vs buy decisions, lease vs buy analysis, vendor evaluation' — matching the anchor for multiple specific concrete actions with comprehensive coverage. It uses third person voice ('Business investment analysis and capital allocation advisor') with no first/second person, so no voice penalty applies. Not a 4 because coverage of analysis types and decision scenarios leaves no significant gaps.

5 / 5

Completeness

It explicitly answers both what ('Business investment analysis and capital allocation advisor') and when ('Use when evaluating whether to invest in... Also use for ROI calculations, IRR, NPV...') with concrete trigger phrases. The 'Use when...' clause is present and specific, so the missing-trigger cap at 3 does not apply. Not a 4 because the 'when' is fully explicit rather than only partially specified.

5 / 5

Trigger Term Quality

It comprehensively covers natural phrases users would actually say: 'whether to invest in', 'ROI', 'IRR', 'NPV', 'payback period', 'build vs buy', 'lease vs buy', 'vendor evaluation', 'where to allocate limited budget', plus concrete object keywords (equipment, real estate, hiring, technology). Not a 4 because synonyms and variations ('capital expenditure', 'maximum return', 'new business') are included alongside the primary terms, matching the comprehensive-coverage anchor.

5 / 5

Distinctiveness Conflict Risk

The niche is mostly distinct — 'business capital allocation', 'build vs buy', 'lease vs buy' are specific triggers — but the phrase 'any capital expenditure' and generic 'vendor evaluation' create minor overlap risk with general financial-advisor or procurement skills (the body's Related Skills section shows several adjacent skills like cfo-advisor and ceo-advisor exist). Not a 5 because the description itself does not draw the boundary the body draws (e.g., excluding stock/securities advice); not a 3 because the core triggers would not routinely fire for the wrong skill.

4 / 5

Total

19

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
alirezarezvani/claude-skills
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.