cash-flow-growth — Claude Code skill: what it does, how to install
cash-flow-growth pulls year-over-year growth for operating, free, and net cash flow of public companies via Octagon MCP. Useful when reviewing corporate liquidity and capital efficiency.
MIT 275 installs ★ 132 updated 2026-06-05
npx skills add OctagonAI/skills --skill cash-flow-growth -a claude-codeWhat cash-flow-growth does
This skill sends a structured prompt to the octagon-agent tool hosted on octagon-mcp. It fetches historical financial data for a selected stock ticker, filters records by fiscal year (FY) or quarter (Q), and outputs year-over-year percentage changes in a Markdown table.
The response covers three key metrics: Operating Cash Flow growth, Free Cash Flow growth, and Net Cash Flow growth. Once the table arrives, the agent outlines observations on capital expenditure trends, earnings quality, and working capital changes.
The skill relies entirely on octagon-mcp, so it will fail if the Octagon MCP server is not configured in your agent environment beforehand.
What it helps with
- pull year-over-year operating and free cash flow growth for public stocks
- spot divergences between operational cash generation and net income
- track multi-year liquidity trajectories across quarterly or annual periods
- inspect capital expenditure patterns relative to operational cash flow
Example prompts for the agent
- Retrieve cash-flow growth metrics for AAPL, limited to 5 records and filtered by period FY
- Pull quarterly cash flow growth metrics for TSLA with 4 records
- Check Free Cash Flow and Net Cash Flow trends for MSFT over the last 3 fiscal years
How to install cash-flow-growth
1Skills CLI (Vercel)
npx skills add OctagonAI/skills --skill cash-flow-growth -a claude-code2Manually: put the files in place
~/.claude/skills/cash-flow-growth/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/cash-flow-growth/
1Skills CLI (Vercel)
npx skills add OctagonAI/skills --skill cash-flow-growth -a codex2Manually: put the files in place
.agents/skills/cash-flow-growth/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add OctagonAI/skills --skill cash-flow-growth -a cursor2Manually: put the files in place
.cursor/skills/cash-flow-growth/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install OctagonAI/skills skills/cash-flow-growth2Manually: put the files in place
.github/skills/cash-flow-growth/SKILL.md1Skills CLI (Vercel)
npx skills add OctagonAI/skills --skill cash-flow-growth -a gemini-cli2Platform CLI
gemini skills install https://github.com/OctagonAI/skills --path skills/cash-flow-growthManually: put the files in place
.devin/skills/cash-flow-growth/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add OctagonAI/skills --skill cash-flow-growth -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about cash-flow-growth
How to install cash-flow-growth in Claude Code?
Run npx skills add OctagonAI/skills --skill cash-flow-growth -a claude-code in your terminal. The configuration installs to ~/.claude/skills/cash-flow-growth/SKILL.md.
What metrics does cash-flow-growth track?
It reports YoY percentage changes for Operating Cash Flow, Free Cash Flow (OCF minus Capex), and Net Cash Flow covering operating, investing, and financing activities.
What are the prerequisites for cash-flow-growth?
You must have octagon-mcp configured in your AI agent. The skill dispatches queries directly to the octagon-agent tool on that MCP server.
Source text
SKILL.md · MIT
---
name: cash-flow-growth
description: Retrieve year-over-year growth in cash flow metrics including Operating Cash Flow, Free Cash Flow, and Net Cash Flow. Use when analyzing company cash generation trends, capital allocation efficiency, or liquidity trajectory.
---
# Cash Flow Growth
Retrieve and analyze year-over-year growth in cash flow metrics 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](references/mcp-setup.md) for installation instructions.
## Query Format
```
Retrieve cash-flow growth metrics for <TICKER>, limited to <N> records and filtered by period <FY|Q>.
```
**MCP Call:**
```json
{
"server": "octagon-mcp",
"toolName": "octagon-agent",
"arguments": {
"prompt": "Retrieve cash-flow growth metrics for AAPL, limited to 5 records and filtered by period FY"
}
}
```
## Output Format
The agent returns a table with YoY growth percentages:
| Fiscal Year | Operating Cash Flow Growth (%) | Free Cash Flow Growth (%) | Net Cash Flow Growth (%) |
|-------------|-------------------------------|--------------------------|-------------------------|
| 2025 | -5.73 | -9.23 | 8.55 |
| 2024 | 6.98 | 9.26 | -1.14 |
| 2023 | -9.50 | -10.64 | 1.53 |
| 2022 | 17.41 | 19.89 | -1.84 |
| 2021 | 28.96 | 26.70 | 0.63 |
**Data Source:** octagon-financials-agent
## Key Observations Pattern
After receiving data, generate observations:
1. **Operating cash flow trends**: Core business cash generation ability
2. **Free cash flow health**: Capital available for dividends, buybacks, M&A
3. **Net cash flow direction**: Overall liquidity position changes
4. **Volatility assessment**: Consistency of cash generation
5. **Historical context**: Multi-year patterns and inflection points
## Metrics Reference
| Metric | Definition |
|--------|------------|
| Operating Cash Flow Growth | YoY change in cash from core business operations |
| Free Cash Flow Growth | YoY change in OCF minus Capital Expenditures |
| Net Cash Flow Growth | YoY change in total cash position (OCF + Investing + Financing) |
## Analysis Tips
### Strong Cash Generation
When Operating Cash Flow Growth > Revenue Growth:
- Efficient working capital management
- Strong collections and payables optimization
- Quality earnings (cash backing profits)
### Free Cash Flow Divergence
When FCF Growth differs significantly from OCF Growth:
- Capex changes driving the difference
- Growth investments (negative) or harvesting (positive)
- Check capex as % of revenue trend
### Net Cash Flow Volatility
Net Cash Flow often volatile due to:
- Large debt issuances or repayments
- Share buyback programs
- Dividend policy changes
- M&A activity
### Working Capital Impact
Significant OCF swings often driven by:
- Inventory build/drawdown
- Receivables collection timing
- Payables management
- Deferred revenue changes
### Quality of Earnings Check
Compare to income statement:
- OCF should track or exceed Net Income over time
- Persistent OCF < Net Income signals earnings quality concerns
## Follow-up Queries
Based on results, suggest deeper analysis:
- "What drove the operating cash flow decline in [YEAR]?"
- "Break down [COMPANY]'s working capital changes for the last 3 years"
- "Compare [COMPANY]'s free cash flow yield to industry peers"
- "Analyze [COMPANY]'s capital expenditure trends and guidance"
© OctagonAI · MIT · OctagonAI/skills