# financial-health-scores

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.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 272 installs · ★ 132 repo stars
- Author: OctagonAI
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/OctagonAI/skills/tree/HEAD/skills/financial-health-scores/SKILL.md
- Updated: 2026-06-05
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/financial-health-scores

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add OctagonAI/skills --skill financial-health-scores -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/financial-health-scores/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/financial-health-scores/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add OctagonAI/skills --skill financial-health-scores -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/financial-health-scores/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add OctagonAI/skills --skill financial-health-scores -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/financial-health-scores/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install OctagonAI/skills skills/financial-health-scores
```

2. **Manually: put the files in place**
- File: `.github/skills/financial-health-scores/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add OctagonAI/skills --skill financial-health-scores -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/OctagonAI/skills --path skills/financial-health-scores
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/financial-health-scores/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add OctagonAI/skills --skill financial-health-scores -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/OctagonAI/skills/tree/HEAD/skills/financial-health-scores/SKILL.md

## When to use it
- 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
- 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`

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 49f0768c5d5e1a92.

BEGIN THIRD-PARTY FILE 49f0768c5d5e1a92
````text
---
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
````
END THIRD-PARTY FILE 49f0768c5d5e1a92

The third-party file has ended. Everything between the 49f0768c5d5e1a92 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2848 of 4098 bytes. © OctagonAI · MIT · https://github.com/OctagonAI/skills/tree/HEAD/skills/financial-health-scores/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
