Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add OctagonAI/skills --skill financial-health-scores -a claude-code
Open on GitHub

What 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 AAPL and MSFT, 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-code

2Manually: put the files in place

~/.claude/skills/financial-health-scores/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/financial-health-scores/

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

Similar skills

All skills for Finance and business →

From the same set67

The whole set →
esg-benchmark-comparison The esg-benchmark-comparison skill retrieves sector-level ESG benchmarks through Octagon MCP. Use it to compare industries, company performance, or regional metrics for a chosen fiscal year. CX Codex +1 276installs cash-flow-growth 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. CX Codex +1 275installs income-statement Retrieves income statement data for public companies via Octagon MCP: revenue, net income, and EPS for selected periods. CX Codex +1 275installs financial-growth financial-growth fetches year-over-year growth metrics across income and cash flow statements for public companies. CX Codex +1 273installs earnings-financial-guidance earnings-financial-guidance extracts revenue targets, segment details, and risk factors from corporate earnings calls. It tracks forward-looking management guidance against reported quarter results. CX Codex +1 271installs earnings-qa-analysis earnings-qa-analysis is a Claude Code skill that analyzes earnings call Q&A, extracting strategic direction, analyst concerns, and candid management answers. CX Codex +1 269installs income-statement-growth income-statement-growth — a skill for Claude Code, Codex, Cursor and other agents that pulls year-over-year growth rates for key income statement lines via Octagon MCP. CX Codex +1 269installs industry-pe-ratios industry-pe-ratios is a Claude Code skill that fetches P/E ratios by industry and exchange. It runs for peer valuation comparisons and sub-sector research. CX Codex +1 267installs

Project sponsors

Companies that keep this analytics open