Agent skill

Cash Flow Statement

by OctagonAI in OctagonAI/skills

Retrieve real-time or historical cash flow statement data including Net Income, Operating Cash Flow, Investing Cash Flow, Financing Cash Flow, Free Cash Flow, and Cash Position for public companies.

MITAuto-check passedBusiness, Finance & HR

Install Cash Flow Statement

skills CLI
$ npx skills add OctagonAI/skills --skill cash-flow-statement -a claude-code

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

GitHub CLI
$ gh skill install OctagonAI/skills cash-flow-statement --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/OctagonAI/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/cash-flow-statement .claude/skills/cash-flow-statement && 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
cash-flow-statement
GitHub stars
127
Token cost
~1k tokens
SKILL.md length
382 words
Files
5 (incl. references)
Skills in repo
53
Repo updated
First seen
Licence
MIT

At a glance

Retrieve real-time or historical cash flow statement data including Net Income, Operating Cash Flow, Investing Cash Flow, Financing Cash Flow, Free Cash Flow, and Cash Position for public companies.

  • Works in 5 steps: Operating cash flow consistency: Track… → Financing outflows: Analyze buybacks and… → Free cash flow capacity: Assess cash… → …
  • Analyzing cash generation
  • SKILL.md covers Prerequisites, Query Format, Output Format and Key Observations Pattern, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Cash Flow Statement is an agent skill from OctagonAI/skills. Retrieve real-time or historical cash flow statement data including Net Income, Operating Cash Flow, Investing Cash Flow, Financing Cash Flow, Free Cash Flow, and Cash Position for public companies. Use when analyzing cash generation, capital allocation, or liquidity trends.

Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including reference files (for example `README.md`, `marketplace.json` and `references/interpreting-results.md`).

It sits in Business, Finance & HR. It works with Model Context Protocol. The repository describes itself as: A collection of Claude skills for agentic financial research by Octagon. The licence is MIT.

When your agent uses it

  • Analyzing cash generation
  • Capital allocation
  • Liquidity trends

Example prompts

  • “/cash-flow-statement”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Operating cash flow consistency: Track OCF relative to Net Income
  2. Financing outflows: Analyze buybacks and dividends
  3. Free cash flow capacity: Assess cash generation strength
  4. Capital expenditure trends: Derive from OCF minus FCF
  5. Cash position trajectory: Monitor ending cash balance

What it can do on your machine

Read from SKILL.md and the folder at commit 51e938c. 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 json).

    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

Cash Flow Statement loads about 1k tokens when it runs, and up to ~2.6k if it reads all its reference files. Until then it costs about 74 tokens; SKILL.md has 382 words of instructions outside code blocks.

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

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 OctagonAI/skills at commit 51e938c, republished under its MIT licence (© OctagonAI). 382 words, ~1,024 tokens.

Download SKILL.mdSave it as .claude/skills/cash-flow-statement/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
cash-flow-statement
description
Retrieve real-time or historical cash flow statement data including Net Income, Operating Cash Flow, Investing Cash Flow, Financing Cash Flow, Free Cash Flow, and Cash Position for public companies. Use when analyzing cash generation, capital allocation, or liquidity trends.

Cash Flow Statement

Retrieve real-time or historical cash flow statement data for public companies using Octagon MCP.

Prerequisites

Ensure Octagon MCP is configured in your AI agent (Cursor, Claude Desktop, Windsurf, etc.). See references/mcp-setup.md for installation instructions.

Query Format

Retrieve real-time or historical cash flow statement data for <TICKER>, limited to <N> records and filtered by period <FY|Q>.

MCP Call:

json
{
  "server": "octagon-mcp",
  "toolName": "octagon-agent",
  "arguments": {
    "prompt": "Retrieve real-time or historical cash flow statement data for AAPL, limited to 5 records and filtered by period FY"
  }
}

Output Format

The agent returns a table with absolute cash flow figures:

Fiscal YearNet Income (USD)Operating Cash Flow (USD)Investing Cash Flow (USD)Financing Cash Flow (USD)Free Cash Flow (USD)Net Change in Cash (USD)Cash at End of Period (USD)
2025$112.01B$111.48B$15.19B-$120.69B$98.77B$5.99B$35.93B
2024$93.74B$118.25B$2.94B-$121.98B$108.81B-$794.00M$29.94B
2023$96.99B$110.54B$3.71B-$108.49B$99.58B$5.76B$30.74B
2022$99.80B$122.15B-$2.24B-$110.75B$111.44B-$1.09B$24.98B
2021$94.68B$104.04B-$1.45B-$93.35B$92.95B-$386.00M$35.93B

Data Source: octagon-financials-agent

Key Observations Pattern

After receiving data, generate observations:

  1. Operating cash flow consistency: Track OCF relative to Net Income
  2. Financing outflows: Analyze buybacks and dividends
  3. Free cash flow capacity: Assess cash generation strength
  4. Capital expenditure trends: Derive from OCF minus FCF
  5. Cash position trajectory: Monitor ending cash balance

Metrics Reference

MetricDefinition
Net IncomeBottom-line profit (starting point for OCF)
Operating Cash FlowCash from core business operations
Investing Cash FlowCash for/from investments and capex
Financing Cash FlowCash from/to debt and equity activities
Free Cash FlowOCF minus capital expenditures
Net Change in CashTotal cash change for the period
Cash at End of PeriodEnding cash and equivalents balance
Show full SKILL.md (138 more words)Show less

Analysis Tips

Cash Conversion Quality
Cash Conversion = Operating Cash Flow / Net Income
  • Above 1.0 = high quality earnings
  • Consistently below 1.0 = potential concerns
Capex Calculation
Capital Expenditures = Operating Cash Flow - Free Cash Flow

Example: $111.48B - $98.77B = $12.71B capex

Shareholder Returns

Financing outflows typically include:

  • Share repurchases (buybacks)
  • Dividend payments
  • Debt repayments
Three-Statement Linkage
  • Net Income flows from Income Statement
  • Cash at End links to Balance Sheet
  • Changes explain Balance Sheet movements
Cash Flow Sustainability

Strong indicators:

  • OCF consistently > Net Income
  • FCF covers dividends and buybacks
  • Positive ending cash trend

Warning signs:

  • OCF declining while income grows
  • FCF negative with continued buybacks
  • Cash position eroding

Follow-up Queries

Based on results, suggest deeper analysis:

  • "Break down [COMPANY]'s financing cash flow between buybacks, dividends, and debt activity"
  • "What is [COMPANY]'s capital expenditure trend and guidance for next year?"
  • "Compare [COMPANY]'s free cash flow yield to [PEER1] and [PEER2]"
  • "Analyze [COMPANY]'s working capital changes driving operating cash flow"

© OctagonAI, 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 4 other files (references) in skills/cash-flow-statement of OctagonAI/skills.

  • SKILL.md
  • README.md
  • marketplace.json
  • references/interpreting-results.md
  • references/mcp-setup.md

Open the folder on GitHubat commit 51e938c

Compare with similar skills

Cash Flow Statement 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.

Cash Flow Statement compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Cash Flow Statement this skillOctagonAI/skills127—~1kAutomated safety check: PassMIT
Creating Financial ModelsChen-zexi/open-ptc-agent7293 repos~1.3kAutomated safety check: PassMIT
Stock APIzhangxiangliang/stock-api2k—~507Automated safety check: PassMIT
Tradingview MCPatilaahmettaner/tradingview-mcp5k—~1.3kAutomated safety check: PassMIT
Dr Manhattanguzus/dr-manhattan204—~2kAutomated safety check: PassApache-2.0
Agentic Trading DeskOft3r/agentic-trading-desk306—~5.1kAutomated safety check: PassMIT

Similar skills

  • Creating Financial Models

    Chen-zexi/open-ptc-agent

    This skill provides an advanced financial modeling suite with DCF analysis, sensitivity testing, Monte Carlo simulations, and scenario planning for investment decisions

    729 GitHub starsUsed in 3 repos~1.3k tokens
    Business, Finance & HRAuto-check passed
  • Stock API

    zhangxiangliang/stock-api

    Fetch real-time stock quotes, K-line (candlestick) history, and search symbols for China A-shares, Hong Kong, and US markets.

    2k GitHub stars~507 tokensUpdated yesterday
    Business, Finance & HRAuto-check passed
  • Tradingview MCP

    atilaahmettaner/tradingview-mcp

    AI Trading Intelligence — live prices, 30+ technical indicators, backtesting (6 strategies), walk-forward overfitting detection, trade logs, equity curves, licensed news sentiment (Marketaux), and…

    5k GitHub stars~1.3k tokensUpdated yesterday
    Business, Finance & HRAuto-check passed
  • Dr Manhattan

    guzus/dr-manhattan

    Trade prediction markets (Polymarket, Kalshi, Opinion, Limitless, Predict.fun) using a unified CCXT-style API.

    204 GitHub stars~2k tokensUpdated 2 mo ago
    Business, Finance & HRAuto-check passed
  • Agentic Trading Desk

    Oft3r/agentic-trading-desk

    Personal trading desk for short-term technical analysis on stocks/ETFs via Robinhood MCP.

    306 GitHub stars~5.1k tokensUpdated 1 mo ago
    Business, Finance & HRAuto-check passed
  • Earnings Analysis

    Wind-Alice/AliceMarket

    Create professional equity research earnings update reports (8-12 pages, 3,000-5,000 words) analyzing quarterly results for companies already under coverage.

    134 GitHub starsUsed in 3 repos~2.2k tokens
    Business, Finance & HRAuto-check passed

More from OctagonAI/skills

All 53 skills in this repo
  • Analyst Estimates

    OctagonAI/skills

    Retrieve analyst financial estimates including Revenue and EPS projections with low/high ranges and analyst coverage.

    127 GitHub stars~1.1k tokensUpdated 4 mo ago
    Auto-check passed
  • Balance Sheet

    OctagonAI/skills

    Retrieve detailed balance sheet statement data including Total Assets, Current Assets, Non-Current Assets, Liabilities, Equity, and Net Debt for public companies.

    127 GitHub stars~1k tokensUpdated 4 mo ago
    Auto-check passed
  • Balance Sheet Growth

    OctagonAI/skills

    Retrieve year-over-year growth in balance sheet items including Total Assets, Total Liabilities, Shareholders Equity, Cash, and Inventories.

    127 GitHub stars~940 tokensUpdated 4 mo ago
    Auto-check passed
  • Batch Market Cap

    OctagonAI/skills

    Retrieve market capitalization data for multiple companies at once using Octagon MCP.

    127 GitHub stars~1.6k tokensUpdated 4 mo ago
    Auto-check passed
  • Cash Flow Growth

    OctagonAI/skills

    Retrieve year-over-year growth in cash flow metrics including Operating Cash Flow, Free Cash Flow, and Net Cash Flow.

    127 GitHub stars~862 tokensUpdated 4 mo ago
    Auto-check passed
  • Commodities List

    OctagonAI/skills

    Retrieve the full catalog of tradable commodities across energy, metals, and agriculture using Octagon MCP.

    127 GitHub stars~1.9k tokensUpdated 4 mo ago
    Auto-check passed

Questions about Cash Flow Statement

What does Cash Flow Statement do?

Retrieve real-time or historical cash flow statement data including Net Income, Operating Cash Flow, Investing Cash Flow, Financing Cash Flow, Free Cash Flow, and Cash Position for public companies. Cash Flow Statement is an agent skill from OctagonAI/skills. Retrieve real-time or historical cash flow statement data including Net Income, Operating Cash Flow, Investing Cash Flow, Financing Cash Flow, Free Cash Flow, and Cash Position for public companies.

When should I use Cash Flow Statement?

Cash Flow Statement fits situations like: analyzing cash generation; capital allocation; liquidity trends.

How do I install Cash Flow Statement in Claude Code?

Run `npx skills add OctagonAI/skills --skill cash-flow-statement -a claude-code`. Or copy the skill folder (skills/cash-flow-statement in OctagonAI/skills) into .claude/skills/cash-flow-statement in your project. Claude Code loads it when a task matches its description.

How do I install Cash Flow Statement in Codex?

Run `npx skills add OctagonAI/skills --skill cash-flow-statement -a codex`. Or copy the skill folder (skills/cash-flow-statement in OctagonAI/skills) into .agents/skills/cash-flow-statement in your project. Codex loads it when a task matches its description.

Can I use Cash Flow Statement 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 OctagonAI/skills --skill cash-flow-statement -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/cash-flow-statement, .gemini/skills/cash-flow-statement, .github/skills/cash-flow-statement and .opencode/skills/cash-flow-statement in your project.

What does Cash Flow Statement need to run?

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

Does Cash Flow Statement 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 Cash Flow Statement 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 Cash Flow Statement use?

Cash Flow Statement 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 Cash Flow Statement use?

About 1k tokens (SKILL.md is roughly 4.1k 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 1.6k tokens, read only when the agent opens those files.

What are the alternatives to Cash Flow Statement?

Skills that share tags, products or a category with Cash Flow Statement: Creating Financial Models (Chen-zexi/open-ptc-agent, 729 stars), Stock API (zhangxiangliang/stock-api, 2k stars), Tradingview MCP (atilaahmettaner/tradingview-mcp, 5k stars) and Dr Manhattan (guzus/dr-manhattan, 204 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Cash Flow Statement?

OctagonAI (a GitHub organization) maintains it in OctagonAI/skills, which has 127 GitHub stars. The repository holds 53 skills in this directory. The repository was last updated on June 5, 2026.

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