financial-health-scores — Claude Code skill: what it does
financial-health-scores is a Claude Code skill that retrieves Altman Z-Score and Piotroski Score for public companies via Octagon MCP. Use the metrics to assess bankruptcy risk and balance sheet quality.
MIT 272 installs ★ 132 updated 2026-06-05
npx skills add OctagonAI/skills --skill financial-health-scores -a claude-codeWhat financial-health-scores does
The skill calls the octagon-agent tool from Octagon MCP and returns two indices. Altman Z-Score is calculated from working capital, assets, retained earnings, EBIT, and market cap; a score above 3.0 signals low bankruptcy risk. Piotroski Score (0 to 9) evaluates profitability, leverage, liquidity, and operating efficiency; 8–9 points means strong financials, 0–4 means weak.
Both metrics work better for mature manufacturing companies. For financials, startups, and asset-light businesses, accuracy drops. To run the skill, Octagon MCP must be configured in your agent — without it, the query will fail.
What it helps with
- assess bankruptcy risk of a public company from balance sheet data
- filter out value traps among cheap stocks
- compare financial health of two companies in the same sector
- check credit quality of a counterparty before a transaction
Example prompts for the agent
- Get financial health metrics for
TSLA— Z-Score and Piotroski - Show Altman Z-Score and Piotroski Score for
AAPLandMSFT, compare the results - Break down Piotroski Score components for
AMZN
How to install financial-health-scores
1Skills CLI (Vercel)
npx skills add OctagonAI/skills --skill financial-health-scores -a claude-code2Manually: put the files in place
~/.claude/skills/financial-health-scores/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/financial-health-scores/
1Skills CLI (Vercel)
npx skills add OctagonAI/skills --skill financial-health-scores -a codex2Manually: put the files in place
.agents/skills/financial-health-scores/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add OctagonAI/skills --skill financial-health-scores -a cursor2Manually: put the files in place
.cursor/skills/financial-health-scores/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install OctagonAI/skills skills/financial-health-scores2Manually: put the files in place
.github/skills/financial-health-scores/SKILL.md1Skills CLI (Vercel)
npx skills add OctagonAI/skills --skill financial-health-scores -a gemini-cli2Platform CLI
gemini skills install https://github.com/OctagonAI/skills --path skills/financial-health-scoresManually: put the files in place
.devin/skills/financial-health-scores/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add OctagonAI/skills --skill financial-health-scores -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 financial-health-scores
How to install financial-health-scores in Claude Code?
Run npx skills add OctagonAI/skills --skill financial-health-scores -a claude-code, then the skill will appear in ~/.claude/skills/financial-health-scores/SKILL.md.
What does financial-health-scores do?
The skill queries Octagon MCP for two financial indices of public companies: Altman Z-Score (bankruptcy risk) and Piotroski Score (balance sheet quality). Returns the metrics with a breakdown.
What does the skill require to work?
Octagon MCP must be configured in your agent. Without it, the query will not execute.
Source text
SKILL.md · MIT
---
name: financial-health-scores
description: 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.
---
# 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]"
© OctagonAI · MIT · OctagonAI/skills