financial-health-scores
Retrieve financial health scores including Altman Z-Score and Piotroski Score for public companies. Use when assessing bankruptcy risk, financial strength, value investing screening, or credit quality analysis.
Best use case
financial-health-scores is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Retrieve financial health scores including Altman Z-Score and Piotroski Score for public companies. Use when assessing bankruptcy risk, financial strength, value investing screening, or credit quality analysis.
Teams using financial-health-scores should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/financial-health-scores/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How financial-health-scores Compares
| Feature / Agent | financial-health-scores | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Retrieve financial health scores including Altman Z-Score and Piotroski Score for public companies. Use when assessing bankruptcy risk, financial strength, value investing screening, or credit quality analysis.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# Financial Health Scores
Retrieve financial health scores including Altman Z-Score and Piotroski Score 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 financial health scores for <TICKER>, including the Altman Z-Score and Piotroski Score.
```
**MCP Call:**
```json
{
"server": "octagon-mcp",
"toolName": "octagon-agent",
"arguments": {
"prompt": "Retrieve financial health scores for TSLA, including the Altman Z-Score and Piotroski Score"
}
}
```
## Output Format
The agent returns health scores with supporting metrics:
**Altman Z-Score:** 16.84 (calculated using working capital, total assets, retained earnings, EBIT, and market cap). A score above 3.0 indicates low bankruptcy risk.
**Piotroski Score:** 6 (out of a maximum 9). This score assesses profitability, leverage, liquidity, and operating efficiency.
**Supporting Financial Metrics:**
| Metric | Value (USD) |
|--------|-------------|
| Working Capital | 36,928,000,000 |
| Total Assets | 137,806,000,000 |
| Retained Earnings | 39,003,000,000 |
| EBIT | 5,616,000,000 |
| Market Cap | 1,400,635,834,800 |
| Total Liabilities | 54,941,000,000 |
| Revenue | 94,827,000,000 |
**Data Source:** octagon-financials-agent
## Altman Z-Score Interpretation
The Altman Z-Score predicts bankruptcy probability:
| Z-Score Range | Interpretation |
|---------------|----------------|
| > 3.0 | Safe Zone - Low bankruptcy risk |
| 1.8 - 3.0 | Grey Zone - Moderate risk, needs monitoring |
| < 1.8 | Distress Zone - High bankruptcy risk |
### Z-Score Formula
```
Z = 1.2(WC/TA) + 1.4(RE/TA) + 3.3(EBIT/TA) + 0.6(MC/TL) + 1.0(Rev/TA)
```
Where:
- WC = Working Capital
- TA = Total Assets
- RE = Retained Earnings
- EBIT = Earnings Before Interest and Taxes
- MC = Market Cap
- TL = Total Liabilities
- Rev = Revenue
## Piotroski Score Interpretation
The Piotroski F-Score (0-9) assesses financial strength:
| Score Range | Interpretation |
|-------------|----------------|
| 8-9 | Strong - High quality value stock |
| 5-7 | Moderate - Average financial health |
| 0-4 | Weak - Poor financial health |
### Piotroski Components (9 criteria)
**Profitability (4 points):**
1. Positive Net Income
2. Positive Operating Cash Flow
3. Return on Assets improvement
4. OCF > Net Income (accruals quality)
**Leverage/Liquidity (3 points):**
5. Lower long-term debt ratio
6. Higher current ratio
7. No new share issuance
**Operating Efficiency (2 points):**
8. Higher gross margin
9. Higher asset turnover
## Analysis Tips
### Combined Assessment
Use both scores together:
- High Z-Score + High Piotroski = Financially healthy
- High Z-Score + Low Piotroski = Watch operating trends
- Low Z-Score + High Piotroski = Leverage concern
- Low Z-Score + Low Piotroski = Avoid or deep value
### Value Investing Application
Piotroski Score designed for:
- Screening high book-to-market stocks
- Identifying quality within value
- Avoiding value traps
### Credit Analysis
Z-Score useful for:
- Bond investment decisions
- Supplier credit assessment
- Counterparty risk evaluation
### Sector Considerations
Scores work best for:
- Manufacturing companies (Z-Score original use)
- Mature businesses with stable operations
- Less reliable for: financials, early-stage, asset-light
## Follow-up Queries
Based on results, suggest deeper analysis:
- "What factors contributed to [COMPANY]'s Piotroski Score versus industry peers?"
- "How does [COMPANY]'s Altman Z-Score compare to its historical averages?"
- "Break down the individual components of [COMPANY]'s Piotroski Score"
- "Compare [COMPANY]'s financial health scores to [PEER1] and [PEER2]"Related Skills
historical-financial-ratings
Retrieve historical financial ratings and key metric scores over time using Octagon MCP. Use when analyzing overall ratings, return on assets, return on equity, discounted cash flow scores, debt-to-equity scores, and letter grades (A+, A, B, etc.) for any public company.
financial-metrics-analysis
Analyze year-over-year growth in income statement items and financial metrics using Octagon MCP. Use when retrieving YoY Revenue Growth, Cost of Revenue Growth, Gross Profit Growth, Operating Income Growth, Net Income Growth, or comparing financial performance across fiscal periods for any public company.
financial-growth
Retrieve comprehensive year-over-year growth in key financial metrics including Revenue, Gross Profit, Operating Income, Net Income, EPS, and Free Cash Flow. Use when analyzing overall company financial performance trends across income statement and cash flow.
financial-analyst-master
Comprehensive equity research analyst skill that orchestrates all Octagon financial analysis skills. Use when conducting full company analysis, writing initiation of coverage reports, performing due diligence, or creating investment recommendations with quantitative support.
earnings-financial-guidance
Extract and analyze financial guidance and forward-looking statements from earnings transcripts, including segment guidance, risk factors, and guidance vs. actuals comparison.
stock-quote
Retrieve real-time stock quotes using Octagon MCP. Use when you need current price, day range, 52-week range, volume, market cap, and moving averages for any publicly traded stock.
stock-price-change
Retrieve stock price change statistics across multiple time periods using Octagon MCP. Use when analyzing short-term and long-term returns, comparing performance across timeframes, and evaluating momentum and historical growth.
stock-performance
Retrieve stock price data and performance metrics using Octagon MCP. Use when analyzing daily closing prices, trading volume, price trends, historical performance, and comparing stock movements over specific time periods.
stock-historical-index
Retrieve full historical end-of-day price data for market indices using Octagon MCP. Use when analyzing index performance over time, tracking market trends, calculating returns, and understanding market context for individual stock analysis.
stock-grades
Retrieve the latest stock grades and ratings from top analysts and financial institutions using Octagon MCP. Use when tracking analyst upgrades, downgrades, rating changes, and institutional sentiment over time.
sector-performance-snapshot
Retrieve a snapshot of market sector performance using Octagon MCP. Use when analyzing sector-wide metrics including revenue, EBITDA, net income, market cap, and enterprise value for companies within a specific sector and exchange.
sector-pe-ratios
Retrieve sector P/E ratios using Octagon MCP. Use when comparing company valuations to sector benchmarks, analyzing sector valuations across exchanges, and understanding market-wide valuation trends.