Agent skill

Roi Analyzer

by nicepkg in nicepkg/ai-workflow

A skill your agent uses when preparing executive reports, evaluating investments, or calculating ROI/break-even/payback period.

MITAuto-check passedDocuments & Office

Install Roi Analyzer

skills CLI
$ npx skills add nicepkg/ai-workflow --skill roi-analyzer -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install nicepkg/ai-workflow roi-analyzer --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/nicepkg/ai-workflow.git skills-src && mkdir -p .claude/skills && cp -r skills-src/workflows/marketing-pro-workflow/.claude/skills/roi-analyzer .claude/skills/roi-analyzer && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
roi-analyzer
GitHub stars
285
Token cost
~1.7k tokens
SKILL.md length
555 words
Files
3
Skills in repo
61
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when preparing executive reports, evaluating investments, or calculating ROI/break-even/payback period.

  • Works in 4 steps: ROI (Return on Investment) → Break-Even Point → Payback Period → …
  • Preparing executive reports
  • SKILL.md covers When to Use This Skill, Core Identity, Core Financial Metrics (Quick… and Quick Start Example, plus 7 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Roi Analyzer is an agent skill from nicepkg/ai-workflow. Use when preparing executive reports, evaluating investments, or calculating ROI/break-even/payback period. 30-minute analysis (87.5% time saving). Includes scenario analysis.

Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `REFERENCE.md` and `prpm.json`).

It sits in Documents & Office, covering Report writing. The repository describes itself as: 🚀 170+ pre-built skills for Claude Code, Cursor, Codex & 14+ AI tools. Stop re-teaching your AI the same things. One command → instant domain expertise. Marketing, SEO, Trading… The licence is MIT.

When your agent uses it

  • Preparing executive reports
  • Evaluating investments
  • Calculating ROI/break-even/payback period

Example prompts

  • “/roi-analyzer”

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. ROI (Return on Investment)
  2. Break-Even Point
  3. Payback Period
  4. Scenario Analysis (Best/Realistic/Worst)

What it can do on your machine

Read from SKILL.md and the folder at commit d167b41. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Roi Analyzer loads about 1.7k tokens when it runs. Until then it costs about 47 tokens; SKILL.md has 555 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~47
When it runs · the whole SKILL.md, loaded when a task matches
~1.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from nicepkg/ai-workflow at commit d167b41, republished under its MIT licence (© nicepkg). 555 words, ~1,733 tokens.

Download SKILL.mdSave it as .claude/skills/roi-analyzer/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
roi-analyzer
description
Use when preparing executive reports, evaluating investments, or calculating ROI/break-even/payback period. 30-minute analysis (87.5% time saving). Includes scenario analysis.

ROI Analyzer - Executive Financial Analysis Partner

Purpose: Deliver rapid, rigorous financial analysis for investment decisions, turning 4 hours of spreadsheet work into 30 minutes of strategic insight with 3-scenario modeling and clear recommendations.

When to Use This Skill

Use this skill when the user's request involves:

  • Executive reporting - Financial summaries for leadership or board meetings
  • Investment evaluation - Analyzing project viability, returns, and risks
  • Phase transitions - Phase 0 → Phase 1 decisions based on ROI/conversion
  • Budget approval - Justifying investments with quantified financial returns
  • Financial forecasting - 3-year revenue, cost, and profitability projections
  • Scenario planning - Best/Realistic/Worst case analysis with break-even points

Core Identity

You are an executive financial analyst that delivers decision-ready investment analysis in 30 minutes (87.5% time saving vs. spreadsheet work), with 3-scenario modeling, break-even thresholds, and clear INVEST/REVIEW/REJECT recommendations.


Core Financial Metrics (Quick Reference)

1. ROI (Return on Investment)

Formula: ROI = (Net Profit / Total Investment) × 100%

Targets:

  • ✅ INVEST: ROI > 100% (realistic case)
  • ⚠️ REVIEW: ROI 50-100%
  • ❌ REJECT: ROI < 50%

Example:

Investment: 100M KRW
Revenue: 200M KRW
Operating Costs: 50M KRW
Net Profit: 200M - 50M - 100M = 50M KRW
ROI: (50M / 100M) × 100% = 50% ⚠️ REVIEW

2. Break-Even Point

Formula (Project): Break-Even = Investment / Monthly Net Profit

Formula (Conversion): Break-Even Rate = Investment / Potential Revenue

Targets:

  • ✅ INVEST: Break-even < 50% of realistic target
  • ⚠️ REVIEW: Break-even 50-70% (low margin for error)
  • ❌ REJECT: Break-even > 70% (unrealistic)

Example:

Phase 0 Investment: 50M KRW
Phase 1 Contract: 200M KRW
Break-Even: 50M / 200M = 25% conversion needed ✅

3. Payback Period

Formula: Payback = Investment / Monthly Net Profit

Targets:

  • ✅ INVEST: Payback < 12 months
  • ⚠️ REVIEW: Payback 12-24 months
  • ❌ REJECT: Payback > 24 months

4. Scenario Analysis (Best/Realistic/Worst)

Purpose: Test assumptions and de-risk decisions by modeling multiple outcomes.

Decision Rule: If worst-case ROI ≥ 0%, investment is low-risk

Output Template:

CaseAssumptionsRevenueProfitROIAssessment
Worst[Pessimistic]⚠️ Risk level
Realistic[Expected]✅ Target
Best[Optimistic]✅ Upside

Quick Start Example

Scenario: Phase 0 → Phase 1 Investment Decision

User: "Should we invest 50M KRW in a 1-month Phase 0 trial? Phase 1 contract would be 208M KRW if we convert."

Analysis:

markdown
## Phase 0 Investment Analysis

**Investment**: 50M KRW (1 month)
**Potential Revenue**: 208M KRW (Phase 1, if convert)

### Scenario Analysis

| Case | Conversion | Revenue | Profit | ROI |
|------|-----------|---------|--------|-----|
| **Worst** | 30% | 62.4M | 12.4M | 25% ⚠️ |
| **Realistic** | 70% | 145.6M | 95.6M | 191% ✅ |
| **Best** | 90% | 187.2M | 137.2M | 274% ✅ |

**Break-Even**: 27% conversion rate (very achievable)

**Decision**: ✅ INVEST
- Realistic ROI 191% is excellent
- Even worst-case 25% ROI is profitable
- Break-even 27% << realistic 70% (low risk)

When to Apply Each Metric

SituationPrimary MetricSecondaryWhy
All investmentsROIScenario AnalysisFoundation
Uncertain successBreak-EvenROIRisk assessment
Cash flow criticalPayback PeriodROIRunway concerns
Strategic decisionsScenario AnalysisAll othersRisk modeling

Show full SKILL.md (227 more words)Show less

Key Principles

Always Include:

  • 3 scenarios (Best/Realistic/Worst), not just one optimistic case
  • Break-even threshold to understand minimum success rate
  • Time value (for 2+ year projects, apply discount rate)
  • Operating costs (dev, ops, marketing, support) - not just investment
  • Decision recommendation (INVEST/REVIEW/REJECT with clear reasoning)

Never:

  • Use only "best case" (always model downside risk)
  • Ignore operating costs (they compound over time)
  • Forget sensitivity analysis (what if assumptions wrong?)
  • Make decisions on ROI alone (consider payback, break-even)

Executive Summary Template

Use this for leadership presentations:

[Investment amount] achieves [ROI%] ROI at [conversion/growth rate].
Break-even occurs at [threshold], with payback in [months].
Investment is [recommended/not recommended] [because reason].

Example:

50M KRW Phase 0 investment achieves 191% ROI at 70% conversion.
Break-even occurs at 27% conversion, with payback in 1 month.
Investment is strongly recommended because worst-case ROI (25%) is still profitable.

Decision Matrix

markdown
✅ **INVEST** if:
- ROI > 100% (realistic case)
- Payback < 18 months
- Break-even < 50% of realistic target
- Worst-case ROI ≥ 0% (no loss scenario)

⚠️ **REVIEW** if:
- ROI 50-100%
- Payback 18-36 months
- High dependency on single assumption
- Requires negotiation to improve terms

❌ **REJECT** if:
- ROI < 50%
- Payback > 36 months
- Break-even requires unrealistic assumptions (>70% of target)

Integration with Other Skills

This analyzer integrates with:

  • market-strategy: Calculate ROI for each expansion stage (Q13-Q16 Trojan Horse path)
  • strategic-thinking: Use SWOT/GAP analysis for qualitative investment context
  • toss-patterns: Calculate ROI for viral loop investments (Pattern 4), ecosystem expansion (Pattern 6)

Next Steps

For Detailed Formulas: See REFERENCE.md for NPV, LTV, CAC, cohort analysis, sensitivity analysis

For Real-World Examples: See EXAMPLES.md for:

  • 3-year SaaS projections
  • Multi-variable sensitivity analysis
  • Phase progression decisions
  • Industry benchmarks (SaaS, E-commerce, Hardware)

For Advanced Topics: See REFERENCE.md for risk assessment framework, decision trees, contingency planning


Meta Note

After applying this analysis, always reflect:

  • What assumptions are most critical? (Test with sensitivity analysis)
  • What data gaps exist? (Customer interviews, market research needed?)
  • What alternatives weren't considered? (Opportunity cost of "do nothing")

This reflection creates a virtuous cycle of continuous financial rigor.


For detailed usage and examples, see related documentation files.

© nicepkg, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files in workflows/marketing-pro-workflow/.claude/skills/roi-analyzer of nicepkg/ai-workflow.

  • SKILL.md
  • REFERENCE.md
  • prpm.json

Open the folder on GitHubat commit d167b41

Compare with similar skills

Roi Analyzer next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Roi Analyzer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Roi Analyzer this skillnicepkg/ai-workflow285—~1.7kAutomated safety check: PassMIT
Foundry Spec Propertiesaviggiano/security144—~489Automated safety check: PassMIT
Graphic EbookVarnan-Tech/opendirectory674—~5kAutomated safety check: PassMIT
Make Photo Stamp ArchiveDlcccc71913/skill-make-photo-stamp-archive366—~1.3kAutomated safety check: PassMIT
Make Tape Collagesherlyryn/make-tape-collage118—~4.7kAutomated safety check: PassMIT
Ky Markdown RebuilderKyrieCheungYep/ky-markdown-rebuilder117—~5.7kAutomated safety check: PassNone

Similar skills

  • Foundry Spec Properties

    aviggiano/security

    Turn whitepapers, protocol specs, and public documentation into Foundry property tests.

    144 GitHub stars~489 tokensUpdated 23 days ago
    Documents & OfficeAuto-check passed
  • Graphic Ebook

    Varnan-Tech/opendirectory

    Creates professionally designed B2B SaaS e-books in HTML + CSS, exported as print-ready PDF.

    674 GitHub stars~5k tokensUpdated 1 mo ago
    Documents & OfficeAuto-check passed
  • Make Photo Stamp Archive

    Dlcccc71913/skill-make-photo-stamp-archive

    Transform one or more supplied photos into clean direct-splice archival artworks that pair a faithfully preserved photograph with a warm-white paper panel containing a compact hand-pressed custom…

    366 GitHub stars~1.3k tokensUpdated 1 mo ago
    Documents & OfficeAuto-check passed
  • Make Tape Collage

    sherlyryn/make-tape-collage

    Transform a supplied photo or text description into a clean, tactile tape-collage raster artwork, or pair a faithfully preserved borderless photo print with a spacious warm-white paper panel…

    118 GitHub stars~4.7k tokensUpdated 1 mo ago
    Documents & OfficeAuto-check passed
  • Ky Markdown Rebuilder

    KyrieCheungYep/ky-markdown-rebuilder

    Rebuild visual documents into reliable Markdown by combining text extraction with page or screenshot alignment.

    117 GitHub stars~5.7k tokensUpdated 2 mo ago
    Documents & OfficeAuto-check passed
  • HTML Summary

    testdouble/han

    Convert a stakeholder summary markdown file into a single self-contained HTML executive report — bottom line and decision asks up front, supporting detail later — styled with a Test Double-derived…

    279 GitHub stars~2.9k tokensUpdated 7 days ago
    Documents & OfficeAuto-check passed

More from nicepkg/ai-workflow

All 61 skills in this repo
  • Capture Triage

    nicepkg/ai-workflow

    Processes Drafts Pro captures from the Inbox folder. An agent skill from nicepkg/ai-workflow.

    285 GitHub stars~3k tokensUpdated 8 mo ago
    Auto-check passed
  • Legacy To AI Ready

    nicepkg/ai-workflow

    Transform legacy codebases into AI-ready projects with Claude Code configurations.

    285 GitHub stars~2.2k tokensUpdated 8 mo ago
    Auto-check: notes
  • Newsletter Coach

    nicepkg/ai-workflow

    Writing coach that extracts educational content from your daily experiences and turns it into publish-ready newsletter drafts.

    285 GitHub stars~3.7k tokensUpdated 8 mo ago
    Auto-check passed
  • Webfluence

    nicepkg/ai-workflow

    Content web architecture framework. An agent skill from nicepkg/ai-workflow.

    285 GitHub stars~1.4k tokensUpdated 8 mo ago
    Auto-check passed
  • Workflow Creator

    nicepkg/ai-workflow

    Create complete Claude Code workflow directories with curated skills.

    285 GitHub stars~2.6k tokensUpdated 8 mo ago
    Auto-check passed
  • Media Processing

    nicepkg/ai-workflow

    Video/audio/image processing with FFmpeg and ImageMagick. An agent skill from nicepkg/ai-workflow.

    285 GitHub stars~2.4k tokensUpdated 8 mo ago
    Auto-check: notes

Questions about Roi Analyzer

What does Roi Analyzer do?

A skill your agent uses when preparing executive reports, evaluating investments, or calculating ROI/break-even/payback period. Roi Analyzer is an agent skill from nicepkg/ai-workflow. Use when preparing executive reports, evaluating investments, or calculating ROI/break-even/payback period.

When should I use Roi Analyzer?

Roi Analyzer fits situations like: preparing executive reports; evaluating investments; calculating ROI/break-even/payback period.

How do I install Roi Analyzer in Claude Code?

Run `npx skills add nicepkg/ai-workflow --skill roi-analyzer -a claude-code`. Or copy the skill folder (workflows/marketing-pro-workflow/.claude/skills/roi-analyzer in nicepkg/ai-workflow) into .claude/skills/roi-analyzer in your project. Claude Code loads it when a task matches its description.

How do I install Roi Analyzer in Codex?

Run `npx skills add nicepkg/ai-workflow --skill roi-analyzer -a codex`. Or copy the skill folder (workflows/marketing-pro-workflow/.claude/skills/roi-analyzer in nicepkg/ai-workflow) into .agents/skills/roi-analyzer in your project. Codex loads it when a task matches its description.

Can I use Roi Analyzer in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add nicepkg/ai-workflow --skill roi-analyzer -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/roi-analyzer, .gemini/skills/roi-analyzer, .github/skills/roi-analyzer and .opencode/skills/roi-analyzer in your project.

What does Roi Analyzer need to run?

SKILL.md names no scripts, command-line tools or credentials: Roi Analyzer is instructions for the agent only.

Does Roi Analyzer access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Roi Analyzer safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Roi Analyzer use?

Roi Analyzer is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Roi Analyzer use?

About 1.7k tokens (SKILL.md is roughly 6.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Roi Analyzer?

Skills that share tags, products or a category with Roi Analyzer: Foundry Spec Properties (aviggiano/security, 144 stars), Graphic Ebook (Varnan-Tech/opendirectory, 674 stars), Make Photo Stamp Archive (Dlcccc71913/skill-make-photo-stamp-archive, 366 stars) and Make Tape Collage (sherlyryn/make-tape-collage, 118 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Roi Analyzer?

nicepkg (a GitHub organization) maintains it in nicepkg/ai-workflow, which has 285 GitHub stars. The repository holds 61 skills in this directory. The repository was last updated on January 20, 2026.

Source: nicepkg/ai-workflow on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.