Agent skill

Financial Analyst

by alirezarezvani in alirezarezvani/claude-skills

Runs financial ratio analysis, DCF valuation, budget variance reports and rolling forecasts from statement data using four bundled Python scripts.

MITAuto-check passedBusiness, Finance & HR

Install Financial Analyst

skills CLI
$ npx skills add alirezarezvani/claude-skills --skill financial-analyst -a claude-code

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

GitHub CLI
$ gh skill install alirezarezvani/claude-skills financial-analyst --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/alirezarezvani/claude-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/finance/skills/financial-analyst .claude/skills/financial-analyst && 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
financial-analyst
GitHub stars
28k
Used in
1 other repo
Token cost
~1.8k tokens
SKILL.md length
614 words
Files
14 (incl. scripts, references, assets)
Skills in repo
342
Repo updated
First seen
Licence
MIT

At a glance

Runs financial ratio analysis, DCF valuation, budget variance reports and rolling forecasts from statement data using four bundled Python scripts.

  • Works in 9 steps: Scoping → Data Analysis & Modeling → Insight Generation → …
  • Calculating profitability, liquidity and debt ratios from financial statements
  • SKILL.md covers Overview, 5-Phase Workflow, Tools and Knowledge Bases, plus 4 more sections
  • Runs Python scripts from its folder; calls python

What it does

The skill organizes the work into five phases: scoping, data analysis and modeling, insight generation, reporting and follow-up. It validates input data for missing fields, nulls and implausible values before computing ratios, and it cross-checks DCF results against sanity bounds such as implied multiples compared with comparable companies.

Four scripts do the calculations. ratio_calculator.py covers profitability, liquidity, debt, efficiency and valuation ratios, dcf_valuation.py builds DCF models with WACC, terminal value and sensitivity analysis, budget_variance_analyzer.py flags favorable and unfavorable variances, and forecast_builder.py makes driver-based forecasts with base, bull and bear scenarios. Report templates, sample data and reference guides on ratios, valuation, forecasting and industry adaptations sit beside them.

When your agent uses it

  • Calculating profitability, liquidity and debt ratios from financial statements
  • Valuing a company with a DCF and a sensitivity table
  • Explaining budget variances by department and category
  • Building a rolling forecast with base, bull and bear scenarios

Example prompts

  • “Run ratio analysis on the income statement and balance sheet in ./data/acme-financials.json.”
  • “Build a DCF valuation for this company with a sensitivity table on WACC and terminal growth.”
  • “Compare actuals to budget for marketing and flag the material unfavorable variances.”
  • “Construct a rolling forecast with base, bull and bear cases from last quarter's actuals.”

Requirements

  • Python to run the scripts in the scripts folder

Workflow steps

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

  1. Scoping
  2. Data Analysis & Modeling
  3. Insight Generation
  4. Reporting
  5. Follow-up
  6. Ratio Calculator (scripts/ratio_calculator.py)
  7. DCF Valuation (scripts/dcf_valuation.py)
  8. Budget Variance Analyzer (scripts/budget_variance_analyzer.py)
  9. Forecast Builder (scripts/forecast_builder.py)

What it can do on your machine

Read from SKILL.md and the folder at commit 19392f7. 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

    Ships 4 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python

    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

Financial Analyst loads about 1.8k tokens when it runs, and up to ~9.3k if it reads all its reference files. Until then it costs about 112 tokens; SKILL.md has 614 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~112
When it runs · the whole SKILL.md, loaded when a task matches
~1.8k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~9.3k

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); the scripts in this folder are not scanned.

SKILL.md

The full file from alirezarezvani/claude-skills at commit 19392f7, republished under its MIT licence (© alirezarezvani). 614 words, ~1,800 tokens.

Download SKILL.mdSave it as .claude/skills/financial-analyst/SKILL.md (or your agent's skills folder). This skill also uses 13 other files; get the full folder from GitHub.
name
financial-analyst
description
Performs financial ratio analysis, DCF valuation, budget variance analysis, and rolling forecast construction for strategic decision-making. Use when analyzing financial statements, building valuation models, assessing budget variances, or constructing financial projections and forecasts. Also applicable when users mention financial modeling, cash flow analysis, company valuation, financial projections, or spreadsheet analysis.

Financial Analyst Skill

Overview

Production-ready financial analysis toolkit providing ratio analysis, DCF valuation, budget variance analysis, and rolling forecast construction. Designed for financial modeling, forecasting & budgeting, management reporting, business performance analysis, and investment analysis.

5-Phase Workflow

Phase 1: Scoping
  • Define analysis objectives and stakeholder requirements
  • Identify data sources and time periods
  • Establish materiality thresholds and accuracy targets
  • Select appropriate analytical frameworks
Phase 2: Data Analysis & Modeling
  • Collect and validate financial data (income statement, balance sheet, cash flow)
  • Validate input data completeness before running ratio calculations (check for missing fields, nulls, or implausible values)
  • Calculate financial ratios across 5 categories (profitability, liquidity, leverage, efficiency, valuation)
  • Build DCF models with WACC and terminal value calculations; cross-check DCF outputs against sanity bounds (e.g., implied multiples vs. comparables)
  • Construct budget variance analyses with favorable/unfavorable classification
  • Develop driver-based forecasts with scenario modeling
Phase 3: Insight Generation
  • Interpret ratio trends and benchmark against industry standards
  • Identify material variances and root causes
  • Assess valuation ranges through sensitivity analysis
  • Evaluate forecast scenarios (base/bull/bear) for decision support
Phase 4: Reporting
  • Generate executive summaries with key findings
  • Produce detailed variance reports by department and category
  • Deliver DCF valuation reports with sensitivity tables
  • Present rolling forecasts with trend analysis
Phase 5: Follow-up
  • Track forecast accuracy (target: +/-5% revenue, +/-3% expenses)
  • Monitor report delivery timeliness (target: 100% on time)
  • Update models with actuals as they become available
  • Refine assumptions based on variance analysis

Tools

1. Ratio Calculator (scripts/ratio_calculator.py)

Calculate and interpret financial ratios from financial statement data.

Ratio Categories:

  • Profitability: ROE, ROA, Gross Margin, Operating Margin, Net Margin
  • Liquidity: Current Ratio, Quick Ratio, Cash Ratio
  • Leverage: Debt-to-Equity, Interest Coverage, DSCR
  • Efficiency: Asset Turnover, Inventory Turnover, Receivables Turnover, DSO
  • Valuation: P/E, P/B, P/S, EV/EBITDA, PEG Ratio
bash
python scripts/ratio_calculator.py assets/sample_financial_data.json
python scripts/ratio_calculator.py assets/sample_financial_data.json --format json
python scripts/ratio_calculator.py assets/sample_financial_data.json --category profitability
2. DCF Valuation (scripts/dcf_valuation.py)

Discounted Cash Flow enterprise and equity valuation with sensitivity analysis.

Features:

  • WACC calculation via CAPM
  • Revenue and free cash flow projections (5-year default)
  • Terminal value via perpetuity growth and exit multiple methods
  • Enterprise value and equity value derivation
  • Two-way sensitivity analysis (discount rate vs growth rate)
bash
python scripts/dcf_valuation.py assets/sample_financial_data.json
python scripts/dcf_valuation.py assets/sample_financial_data.json --format json
python scripts/dcf_valuation.py assets/sample_financial_data.json --projection-years 7
3. Budget Variance Analyzer (scripts/budget_variance_analyzer.py)

Analyze actual vs budget vs prior year performance with materiality filtering.

Features:

  • Dollar and percentage variance calculation
  • Materiality threshold filtering (default: 10% or $50K)
  • Favorable/unfavorable classification with revenue/expense logic
  • Department and category breakdown
  • Executive summary generation
bash
python scripts/budget_variance_analyzer.py assets/sample_financial_data.json
python scripts/budget_variance_analyzer.py assets/sample_financial_data.json --format json
python scripts/budget_variance_analyzer.py assets/sample_financial_data.json --threshold-pct 5 --threshold-amt 25000
Show full SKILL.md (240 more words)Show less
4. Forecast Builder (scripts/forecast_builder.py)

Driver-based revenue forecasting with rolling cash flow projection and scenario modeling.

Features:

  • Driver-based revenue forecast model
  • 13-week rolling cash flow projection
  • Scenario modeling (base/bull/bear cases)
  • Trend analysis using simple linear regression (standard library)
bash
python scripts/forecast_builder.py assets/sample_financial_data.json
python scripts/forecast_builder.py assets/sample_financial_data.json --format json
python scripts/forecast_builder.py assets/sample_financial_data.json --scenarios base,bull,bear

Knowledge Bases

ReferencePurpose
references/financial-ratios-guide.mdRatio formulas, interpretation, industry benchmarks
references/valuation-methodology.mdDCF methodology, WACC, terminal value, comps
references/forecasting-best-practices.mdDriver-based forecasting, rolling forecasts, accuracy
references/industry-adaptations.mdSector-specific metrics and considerations (SaaS, Retail, Manufacturing, Financial Services, Healthcare)

Templates

TemplatePurpose
assets/variance_report_template.mdBudget variance report template
assets/dcf_analysis_template.mdDCF valuation analysis template
assets/forecast_report_template.mdRevenue forecast report template

Key Metrics & Targets

MetricTarget
Forecast accuracy (revenue)+/-5%
Forecast accuracy (expenses)+/-3%
Report delivery100% on time
Model documentationComplete for all assumptions
Variance explanation100% of material variances

Input Data Format

All scripts accept JSON input files in either of two shapes:

  1. Flat — the tool's expected keys at the top level (e.g., income_statement / balance_sheet for the ratio calculator, historical / assumptions for DCF, line_items for variance, historical_periods / drivers / assumptions / cash_flow_inputs for forecasting).
  2. Nested (bundled) — inputs for all four tools in one file, nested under per-tool keys: ratio_analysis, dcf_valuation, budget_variance, forecast. See assets/sample_financial_data.json for the complete bundled schema; every quick-start command above runs directly against it.

Each script auto-detects the shape (flat keys win if present) and exits non-zero with a clear error if neither shape yields usable data.

Dependencies

None - All scripts use Python standard library only (math, statistics, json, argparse, datetime). No numpy, pandas, or scipy required.

© alirezarezvani, 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 13 other files (scripts, references, assets) in finance/skills/financial-analyst of alirezarezvani/claude-skills.

  • SKILL.md
  • assets/dcf_analysis_template.md
  • assets/expected_output.json
  • assets/forecast_report_template.md
  • assets/sample_financial_data.json
  • assets/variance_report_template.md
  • references/financial-ratios-guide.md
  • references/forecasting-best-practices.md
  • references/industry-adaptations.md
  • references/valuation-methodology.md
  • scripts/budget_variance_analyzer.py
  • scripts/dcf_valuation.py
  • scripts/forecast_builder.py
  • scripts/ratio_calculator.py

Open the folder on GitHubat commit 19392f7

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in alirezarezvani/claude-skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Financial Analyst 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.

Financial Analyst compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Financial Analyst this skillalirezarezvani/claude-skills28k1 repos~1.8kAutomated safety check: PassMIT
Financial AnalystaAAaqwq/AGI-Super-Team1051 repos~4.2kAutomated safety check: PassMIT
SaaS Economics and Efficiency Metricsdeanpeters/Product-Manager-Skills7.2k1 repos~6.4kAutomated safety check: PassCustom licence
Three-Statement Model Builderginlix-ai/LangAlpha1.8k—~5.4kAutomated safety check: PassApache-2.0
Money Financeiamzifei/show-me-the-money1k—~2.2kAutomated safety check: PassCustom licence
Financial Model Checkerginlix-ai/LangAlpha1.8k—~4.2kAutomated safety check: PassApache-2.0

Similar skills

  • Financial Analyst

    aAAaqwq/AGI-Super-Team

    Performs financial ratio analysis, DCF valuation, budget variance analysis, and rolling forecast construction for strategic decision-making

    105 GitHub starsUsed in 1 repo~4.2k tokens
    Business, Finance & HRAuto-check passed
  • SaaS Economics and Efficiency Metrics

    deanpeters/Product-Manager-Skills

    Reference and evaluator for SaaS unit economics and capital efficiency: gross margin, CAC, LTV, burn, runway and magic number, to decide whether to scale or optimize.

    7.2k GitHub starsUsed in 1 repo~6.4k tokens
    Business, Finance & HRAuto-check passed
  • Builds or repairs an integrated income statement, balance sheet and cash flow model in Excel with live formulas, supporting schedules, scenarios and a Checks sheet.

    1.8k GitHub stars~5.4k tokensUpdated yesterday
    Business, Finance & HRAuto-check passed
  • Money Finance

    iamzifei/show-me-the-money

    Financial tracking, revenue analytics, expense management, and pricing optimization.

    1k GitHub stars~2.2k tokensUpdated 1 mo ago
    Business, Finance & HRAuto-check passed
  • Financial Model Checker

    ginlix-ai/LangAlpha

    Audits an existing Excel financial model without editing it, checking structure, formulas, integrity identities and source tie-out, and ends in a prioritized issue log.

    1.8k GitHub stars~4.2k tokensUpdated yesterday
    Business, Finance & HRAuto-check passed
  • DCF Model Builder

    ginlix-ai/LangAlpha

    Builds a live Excel DCF valuation workbook with free cash flow projections, WACC, terminal value, three scenarios, sensitivity grids and a reverse DCF.

    1.8k GitHub stars~7.7k tokensUpdated yesterday
    Business, Finance & HRAuto-check passed

More from alirezarezvani/claude-skills

All 342 skills in this repo
  • Agile Product Owner

    alirezarezvani/claude-skills

    Writes INVEST-checked user stories with acceptance criteria, splits epics, plans sprints from velocity and ranks the backlog with a weighted score.

    28k GitHub starsUsed in 3 repos~3.2k tokens
    Auto-check passed
  • Product Strategist

    alirezarezvani/claude-skills

    OKR cascade toolkit for product leaders: generates aligned company-to-team OKRs from five strategy types and scores how well they line up.

    28k GitHub starsUsed in 2 repos~1.8k tokens
    Auto-check passed
  • App Store Optimization

    alirezarezvani/claude-skills

    App Store Optimization (ASO) toolkit for researching keywords, analyzing competitor rankings, generating metadata suggestions, and improving app visibility on Apple App Store and Google Play Store.

    28k GitHub starsUsed in 1 repo~4.2k tokens
    Auto-check passed
  • AWS Solution Architect

    alirezarezvani/claude-skills

    Design AWS architectures for startups using serverless patterns and IaC templates.

    28k GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed
  • Campaign Analytics

    alirezarezvani/claude-skills

    Calculates attribution, funnel and ROI figures for marketing campaigns with three Python scripts that need only the standard library.

    28k GitHub starsUsed in 1 repo~2.1k tokens
    Auto-check passed
  • Code to PRD

    alirezarezvani/claude-skills

    Reverse-engineers a frontend, backend or fullstack codebase into a product requirements document with per-page docs, an enum dictionary and an API inventory.

    28k GitHub starsUsed in 1 repo~4.9k tokens
    Auto-check passed

Questions about Financial Analyst

What does Financial Analyst do?

Runs financial ratio analysis, DCF valuation, budget variance reports and rolling forecasts from statement data using four bundled Python scripts. The skill organizes the work into five phases: scoping, data analysis and modeling, insight generation, reporting and follow-up. It validates input data for missing fields, nulls and implausible values before computing ratios, and it cross-checks DCF results against sanity bounds such as implied multiples compared with comparable companies.

When should I use Financial Analyst?

Financial Analyst fits situations like: calculating profitability, liquidity and debt ratios from financial statements; valuing a company with a DCF and a sensitivity table; explaining budget variances by department and category; building a rolling forecast with base, bull and bear scenarios.

How do I install Financial Analyst in Claude Code?

Run `npx skills add alirezarezvani/claude-skills --skill financial-analyst -a claude-code`. Or copy the skill folder (finance/skills/financial-analyst in alirezarezvani/claude-skills) into .claude/skills/financial-analyst in your project. Claude Code loads it when a task matches its description.

How do I install Financial Analyst in Codex?

Run `npx skills add alirezarezvani/claude-skills --skill financial-analyst -a codex`. Or copy the skill folder (finance/skills/financial-analyst in alirezarezvani/claude-skills) into .agents/skills/financial-analyst in your project. Codex loads it when a task matches its description.

Can I use Financial Analyst 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 alirezarezvani/claude-skills --skill financial-analyst -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/financial-analyst, .gemini/skills/financial-analyst, .github/skills/financial-analyst and .opencode/skills/financial-analyst in your project.

What does Financial Analyst need to run?

Going by SKILL.md and its folder, Financial Analyst needs Python for the scripts in its folder and the command-line tools its instructions call (python). Our summary lists: Python to run the scripts in the scripts folder.

Does Financial Analyst 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 Financial Analyst 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Financial Analyst use?

Financial Analyst 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 Financial Analyst use?

About 1.8k tokens (SKILL.md is roughly 7.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 7.5k tokens, read only when the agent opens those files.

What are the alternatives to Financial Analyst?

Skills that share tags, products or a category with Financial Analyst: Financial Analyst (aAAaqwq/AGI-Super-Team, 105 stars), SaaS Economics and Efficiency Metrics (deanpeters/Product-Manager-Skills, 7.2k stars), Three-Statement Model Builder (ginlix-ai/LangAlpha, 1.8k stars) and Money Finance (iamzifei/show-me-the-money, 1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Financial Analyst?

alirezarezvani (a GitHub user) maintains it in alirezarezvani/claude-skills, which has 27,891 GitHub stars. The repository holds 342 skills in this directory. The repository was last updated on August 30, 2026.

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