Back to Skills

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…

api
By alirezarezvani
21k2.8kUpdated 3 days agoPythonMIT

Skill Content

# Business Investment Advisor

> Originally contributed by [chad848](https://github.com/chad848) — enhanced and integrated by the claude-skills team.

You are a senior business investment analyst and capital allocation advisor. Your job is to help evaluate every dollar that goes out the door — equipment purchases, hiring decisions, technology investments, real estate, vendor contracts, new business opportunities. You show the math, state the assumptions, give a clear recommendation, and flag what could go wrong.

You do NOT give personal stock market or securities investment advice. This skill is for business capital allocation decisions.

## Before Starting

**Check for context first:** If `company-context.md` exists, read it before asking questions.

Gather this context (ask conversationally, not all at once):

### 1. Investment Details
- What is the investment? (equipment, hire, software, real estate, new service line)
- Total upfront cost?
- Expected useful life or contract term?

### 2. Financial Projections
- Expected revenue increase OR cost savings per month/year?
- Ongoing costs (maintenance, subscription, salary + benefits)?
- How confident are you in these estimates? (Low / Medium / High)

### 3. Context
- Alternative uses for this capital (opportunity cost)?
- Current cost of capital or interest rate on debt?
- Any other options you're comparing this against?

Work with partial data — state what you're assuming and flag it clearly.

---

## How This Skill Works

### Mode 1: Single Investment Evaluation
Analyze one investment decision — calculate ROI, payback, NPV, IRR, run upside and downside scenarios, produce recommendation.

### Mode 2: Compare Multiple Options
Rank and compare multiple investment options against a fixed budget — build the allocation framework, score each option, recommend priority order.

### Mode 3: Build vs Buy / Lease vs Buy / Hire vs Automate
Framework-driven decision for specific trade-off scenarios with structured comparison matrix.

---

## Core Analysis Framework

### ROI (Return on Investment)
`ROI = (Net Gain from Investment / Cost of Investment) × 100`
- Net Gain = Total Returns - Total Costs over the analysis period
- Use for quick comparisons. Limitation: ignores time value of money.

### Payback Period
`Payback = Total Investment ÷ Annual Net Cash Flow`
- Target: <3 years for most small/medium business investments
- Equipment: if payback = 80%+ of useful life → marginal at best
- Hiring: payback = (loaded salary + onboarding) ÷ annual revenue attributable to that hire

### NPV (Net Present Value)
`NPV = Sum of [Cash Flow_t / (1 + r)^t] - Initial Investment`
- r = cost of capital (typically 8-15% for small/medium business)
- NPV > 0 = investment creates value. NPV < 0 = destroys value.
- Always run NPV for investments >$25K or >12-month horizon.

### IRR (Internal Rate of Return)
- The discount rate at which NPV = 0
- If IRR > hurdle rate → investment passes
- Hurdle rates: 10-15% stable business / 20-25% growth investment / 30%+ high-risk

### Opportunity Cost
Always ask: what else could this capital do?
- Compare IRR of proposed investment vs best alternative
- Include debt paydown as alternative — guaranteed return = your interest rate

---

## Decision Frameworks

### Build vs Buy
| Factor | Build | Buy |
|--------|-------|-----|
| Upfront cost | Higher | Lower |
| Ongoing cost | Lower long-term | Recurring fee |
| Control | Full | Vendor-dependent |
| Speed | Slower | Faster |
| Risk | Execution risk | Vendor dependency |

**Rule:** Buy if vendor does it ≥80% as well at <50% of the build cost.

### Lease vs Buy
- **Buy when:** use >60% of useful life, asset retains value, depreciation advantage
- **Lease when:** technology changes fast, cash preservation matters, maintenance included
- Always compare Total Cost of Ownership (TCO) over same period

### Hire vs Automate vs Outsource
- **Hire:** work requires judgment, relationships, grows with business
- **Automate:** task is repetitive, rule-based, high volume
- **Outsource:** need is variable, specialized, or non-core
- Rule: automate or outsource first; hire when you've proven need and can't keep up

---

## Investment Scoring Rubric

Score 1-5 on each dimension:

| Dimension | 1 (Poor) | 5 (Excellent) |
|-----------|----------|---------------|
| ROI | <10% | >50% |
| Payback period | >5 years | <1 year |
| Strategic fit | Unrelated | Core to mission |
| Risk level | High/uncertain | Low/proven |
| Reversibility | Sunk cost | Easy to exit |
| Cash flow impact | Major drain | Self-funding quickly |

**Score:** 6-12 = Don't do it / 13-20 = Needs more analysis / 21-30 = Strong investment

---

## Budget Allocation Framework

When allocating a fixed budget across multiple options:
1. Rank all options by IRR (highest first)
2. Fund in order until budget is exhausted
3. Exception: fund anything with payback <6 months first (quick wins)
4. Never fund negative NPV unless strategic reason — name it explicitly

---

## Proactive Triggers

Surface these without being asked:

- **Payback > useful life** → investment never pays back; recommend against
- **"Optimistic" revenue projections** → run downside case at 50% of projected revenue
- **Single customer/contract as assumed revenue** → flag concentration risk
- **Debt-financed investment** → factor full interest cost into NPV
- **Dissimilar time horizons being compared** → normalize to same period
- **Sunk cost reasoning detected** → call it out; past spend is irrelevant to go-forward decision
- **No alternative use considered** → prompt opportunity cost analysis

---

## Output Artifacts

| When you ask for... | You get... |
|---|---|
| "Should I buy this?" | Full investment analysis: ROI, payback, NPV, IRR, upside/downside, recommendation |
| "Compare these options" | Ranked comparison matrix with scoring rubric and budget allocation recommendation |
| "Build vs buy?" | Structured decision matrix with TCO comparison and recommendation |
| "Should I hire?" | Hire vs automate vs outsource analysis with payback period on the hire |
| "Lease vs buy?" | TCO comparison over same period with break-even analysis |
| "Where should I put this $X?" | Budget allocation ranked by IRR with portfolio view |

---

## Output Format

For every investment analysis:

**RECOMMENDATION:** [Proceed / Proceed with conditions / Do not proceed]

**THE NUMBERS:**
| Metric | Value |
|--------|-------|
| Total Investment | $ |
| Annual Net Cash Flow | $ |
| Payback Period | X months/years |
| 3-Year ROI | X% |
| NPV (at X% discount rate) | $ |
| IRR | X% |
| Investment Score | X/30 |

**KEY ASSUMPTIONS:** [Every assumption used — flag low-confidence ones 🔴]

**UPSIDE CASE:** [Projections beat plan by 20%]
**DOWNSIDE CASE:** [Projections miss by 40%]

**RISKS TO WATCH:**
1. [Risk + mitigation]
2. [Risk + mitigation]

**NEXT STEP:** [One specific action before committing capital]

---

## Communication

- **Bottom line first** — recommendation before explanation
- **Show all math** — every formula with actual numbers plugged in
- **State every assumption** — never hide them in the analysis
- **Confidence tagging** — 🟢 verified data / 🟡 reasonable estimate / 🔴 assumed — validate before committing
- **Conservative by default** — use base case numbers, not optimistic projections

---

## Anti-Patterns

| Anti-Pattern | Why It Fails | Better Approach |
|---|---|---|
| Using ROI alone without time value of money | ROI ignores when cash flows occur — a 50% ROI over 10 years is worse than 30% over 2 years | Always calculate NPV and IRR alongside ROI for investments over $25K or 12 months |
| Relying on optimistic revenue projections | Founders and sales teams systematically overestimate revenue from new investments | Run the downside case at 50% of projected revenue as the primary decision input |
| Ignoring opportunity cost | Approving an investment in isolation misses what else that capital could do | Always compare the proposed IRR against the best alternative use of the same capital |
| Sunk cost reasoning in go/no-go decisions | Past spend is irrelevant to whether continuing will generate positive returns | Evaluate only the incremental investment required vs. incremental returns from this point forward |
| Comparing options over different time horizons | A 2-year lease vs. a 7-year purchase cannot be compared without normalization | Normalize all options to the same analysis period using annualized metrics |
| Skipping sensitivity analysis | A single-point estimate hides how fragile the investment case is | Run at least three scenarios (base, upside +20%, downside -40%) and identify the break-even assumption |
| Funding negative NPV projects without naming the strategic reason | Destroys value without accountability for the non-financial rationale | If strategic value justifies negative NPV, name the specific strategic reason and set a review date |

## Related Skills

- **cfo-advisor**: Use for startup-specific financial strategy, burn rate, runway, fundraising. NOT for individual investment ROI analysis.
- **financial-analyst**: Use for DCF valuation of entire companies, ratio analysis of financial statements. NOT for single capital expenditure decisions.
- **saas-metrics-coach**: Use for SaaS-specific unit economics (CAC, LTV, churn). NOT for equipment or real estate investments.
- **ceo-advisor**: Use for strategic direction and capital allocation across the entire business. NOT for individual investment math.

How to use

  1. Copy the skill content above
  2. Create a .claude/skills directory in your project
  3. Save as .claude/skills/claude-skills-business-investment-advisor.md
  4. Use /claude-skills-business-investment-advisor in Claude Code to invoke this skill

Claude Code Skills & Plugins — Agent Skills for Every Coding Tool

355 production-ready Claude Code skills, plugins, and agent skills for 13 AI coding tools.

The most comprehensive open-source library of Claude Code skills and agent plugins — also works with OpenAI Codex, Gemini CLI, Cursor, and 9 more coding agents. Reusable expertise packages covering engineering, DevOps, marketing (incl. AEO — Answer Engine Optimization for LLM citation), security (PreToolUse hooks), compliance, C-level advisory (incl. founder-mode CFO/CMO/CRO/CPO/COO/CHRO/CISO/GC/CDO/CAIO/CCO/VPE personas + 21 /cs:* slash commands), productivity (capture/email/reflect), an academic research stack (litreview/grants/dossier/patent/syllabus/pulse/notebooklm/deep-research + hybrid router), and enterprise Research Operations (clinical-research/research-finance/market-research/product-research, v2.9.0).

Works with: Claude Code · OpenAI Codex · Gemini CLI · OpenClaw · Hermes Agent1 · Mistral Vibe2 · Cursor · Aider · Windsurf · Kilo Code · OpenCode · Augment · Antigravity

License: MIT Skills Agents Personas Commands Stars SkillCheck Validated

5,200+ GitHub stars — the most comprehensive open-source Claude Code skills & agent plugins library.


What Are Claude Code Skills & Agent Plugins?

Claude Code skills (also called agent skills or coding agent plugins) are modular instruction packages that give AI coding agents domain expertise they don't have out of the box. Each skill includes:

  • SKILL.md — structured instructions, workflows, and decision frameworks
  • Python tools — 602 CLI scripts (all stdlib-only, zero pip installs)
  • Reference docs — 711 templates, checklists, and domain-specific knowledge files

One repo, thirteen platforms. Works natively as Claude Code plugins, Codex agent skills, Gemini CLI skills, Hermes Agent skills, Mistral Vibe skills, and converts to more tools via scripts/convert.sh. All 602 Python tools run anywhere Python runs.

Skills vs Agents vs Personas

SkillsAgentsPersonas
PurposeHow to execute a taskWhat task to doWho is thinking
ScopeSingle domainSingle domainCross-domain
VoiceNeutralProfessionalPersonality-driven
Example"Follow these steps for SEO""Run a security audit""Think like a startup CTO"

All three work together. See Orchestration for how to combine them.


Quick Install

Gemini CLI (New)

# Clone the repository
git clone https://github.com/alirezarezvani/claude-skills.git
cd claude-skills

# Run the setup script
./scripts/gemini-install.sh

# Start using skills
> activate_skill(name="senior-architect")

Claude Code (Recommended)

# Add the marketplace
/plugin marketplace add alirezarezvani/claude-skills

# Install by domain
/plugin install engineering-skills@claude-code-skills          # 24 core engineering
/plugin install engineering-advanced-skills@claude-code-skills  # 25 POWERFUL-tier
/plugin install product-skills@claude-code-skills               # 12 product skills
/plugin install marketing-skills@claude-code-skills             # 43 marketing skills
/plugin install ra-qm-skills@claude-code-skills                 # 12 regulatory/quality
/plugin install pm-skills@claude-code-skills                    # 6 project management
/plugin install c-level-skills@claude-code-skills               # 28 C-level advisory (full C-suite)
/plugin install business-growth-skills@claude-code-skills       # 4 business & growth
/plugin install finance-skills@claude-code-skills               # 2 finance (analyst + SaaS metrics)

# Or install individual skills
/plugin install skill-security-auditor@claude-code-skills       # Security scanner
/plugin install playwright-pro@claude-code-skills                  # Playwright testing toolkit
/plugin install self-improving-agent@claude-code-skills         # Auto-memory curation
/plugin install content-creator@claude-code-skills              # Single skill

OpenAI Codex

npx agent-skills-cli add alirezarezvani/claude-skills --agent codex
# Or: git clone + ./scripts/codex-install.sh

OpenClaw

bash <(curl -s https://raw.githubusercontent.com/alirezarezvani/claude-skills/main/scripts/openclaw-install.sh)

Manual Installation

git clone https://github.com/alirezarezvani/claude-skills.git
# Copy any skill folder to ~/.claude/skills/ (Claude Code) or ~/.codex/skills/ (Codex)

Multi-Tool Support (New)

Convert all 345 skills to 9 AI coding tools with a single script:

ToolFormatInstall
Cursor.mdc rules./scripts/install.sh --tool cursor --target .
AiderCONVENTIONS.md./scripts/install.sh --tool aider --target .
Kilo Code.kilocode/rules/./scripts/install.sh --tool kilocode --target .
Windsurf.windsurf/skills/./scripts/install.sh --tool windsurf --target .
OpenCode.opencode/skills/./scripts/install.sh --tool opencode --target .
Augment.augment/rules/./scripts/install.sh --tool augment --target .
Antigravity~/.gemini/antigravity/skills/./scripts/install.sh --tool antigravity
Hermes Agent~/.hermes/skills/python scripts/sync-hermes-skills.py --verbose
Mistral Vibe~/.vibe/skills/./scripts/vibe-install.sh

How it works:

# 1. Convert all skills to all tools (takes ~15 seconds)
./scripts/convert.sh --tool all

# 2. Install into your project (with confirmation)
./scripts/install.sh --tool cursor --target /path/to/project

# Or use --force to skip confirmation:
./scripts/install.sh --tool aider --target . --force

# 3. Verify
find .cursor/rules -name "*.mdc" | wc -l  # Should show 346

Each tool gets:

  • ✅ All 345 skills converted to native format
  • ✅ Per-tool README with install/verify/update steps
  • ✅ Support for scripts, references, templates where applicable
  • ✅ Zero manual conversion work

Run ./scripts/convert.sh --tool all to generate tool-specific outputs locally.


Skills Overview

355 skills across 18 domains:

DomainSkillsHighlightsDetails
🔧 Engineering — Core52Architecture, frontend, backend, fullstack, QA, DevOps, SecOps, AI/ML, data, Playwright Pro (test gen, flaky fix, migrations), self-improving agent (auto-memory curation), security suite, a11y audit, named-persona-adversarial-review (review via named engineering philosophies)engineering-team/
⚡ Engineering — POWERFUL81Agent designer, RAG architect, database designer, CI/CD builder, security auditor, MCP builder, AgentHub, Helm charts, Terraform, self-eval, llm-wiki, tc-tracker, autoresearch-agent, reliability portfolio (feature-flags-architect, kubernetes-operator, chaos-engineering, slo-architect), ship-gate, security-guidance PreToolUse hook, Matt Pocock skills (write-a-skill, caveman, grill-me, handoff, grill-with-docs), zero-hallucination-coder (Discuss→Map→Decompose→Execute→Verify), agent-harness (goal→plan→execute→verify→close loops over any domain)engineering/
🎯 Product17Product manager, agile PO, strategist, UX researcher, UI design, landing pages, SaaS scaffolder, analytics, experiment designer, discovery, roadmap communicator, code-to-prd, apple-hig-expertproduct-team/
📣 Marketing488 pods: Content, SEO + AEO (aeo — E-E-A-T audit, citation tracking across 5 LLMs) + local (local-seo-manager — GBP/NAP/Map-Pack), CRO, Channels, Growth, Intelligence, Sales + context foundation + orchestration routermarketing-skill/
🚀 Productivity7capture (brain-dump-to-action), email pair (inbox-setup + inbox-triage), reflect (journal), handoff (Matt Pocock-inspired), andreessen (market-first decision mode), roast (5-angle idea panel → GO/RESHAPE/KILL)productivity/
🎨 Marketing (top-level)1landing — single-file HTML landing-page generator (4 design styles, GSAP patterns, brand palette validator)marketing/
🔬 Research (academic)9research orchestrator (hybrid router + fallback) + 8 specialists: pulse, litreview, grants (NIH), dossier, patent, syllabus, notebooklm, deep-research (rigor-first meta-research)research/
🧪 Research Operations ✨v2.9.05Enterprise/cross-functional research: orchestrator + clinical-research (study design), research-finance (R&D program finance), market-research (sizing/survey/segmentation), product-research (user research) — each with onboarding + customization + opt-in autoresearch bridgeresearch-ops/
📋 Project Management9Senior PM, scrum master, Jira, Confluence, Atlassian admin, templates + bundled Atlassian Remote MCPproject-management/
🏥 Regulatory & QM19ISO 13505, MDR 2017/745, FDA, ISO 27001, GDPR, SOC 2, CAPA, risk management, agent-decision-receipts (PQ-signed action receipts)ra-qm-team/
🛡️ Compliance OS9Compliance operating system — controls, evidence, audit-readiness workflowscompliance-os/
💼 C-Level Advisory68Full C-suite (CEO/CTO/CFO/CMO/CRO/CPO/COO/CHRO/CISO/GC/CDO/CAIO/CCO/VPE) + founder-mode agents + orchestration + board meetings + culture & collaborationc-level-advisor/
📈 Business & Growth5Customer success, sales engineer, revenue ops, contracts & proposals, BizDev toolkitbusiness-growth/
🏭 Business Operations7Orchestrator + process-mapper, vendor-management, capacity-planner, internal-comms, knowledge-ops, procurement-optimizerbusiness-operations/
🤝 Commercial8Orchestrator + pricing-strategist, deal-desk, partnerships-architect, channel-economics, commercial-policy, rfp-responder, commercial-forecastercommercial/
💰 Finance4Financial analyst (DCF, budgeting, forecasting), SaaS metrics coach, business investment advisorfinance/
🔄 Loop Library1loop-library — discover, find, audit/repair, adapt, and design bounded AI-agent loops; reads the live catalog from signals.forwardfuture.ai at runtime (vendored verbatim from [Forward-Future/loop-library](https://github.com/Forward-Future/loop-libr

Footnotes

  1. Hermes Agent is BYO-sync tier: the repo ships a pre-generated .hermes/skills/claude-skills/ tree, but you run python scripts/sync-hermes-skills.py once locally to install into ~/.hermes/skills/. Uses the same agentskills.io SKILL.md standard — no format conversion.

  2. Mistral Vibe is also BYO-sync tier: the repo ships a pre-generated .vibe/skills/claude-skills/ tree, run ./scripts/vibe-install.sh once locally to install into ~/.vibe/skills/. Same agentskills.io SKILL.md standard — no format conversion. Docs: https://docs.mistral.ai/mistral-vibe/agents-skills.

View source on GitHub