fundamentals — Claude Code skill: data and installation
The fundamentals skill retrieves financial statements, earnings, and company metrics from Yahoo Finance. Use it when an agent needs fundamental analysis for a ticker.
MIT 188 installs ★ 417 updated 2026-10-21
npx skills add staskh/trading_skills --skill fundamentals -a claude-codeWhat fundamentals does
The skill runs scripts that query Yahoo Finance for a ticker symbol. It can return key metrics, recent quarterly and annual income-statement data, plus historical and estimated earnings. The --type option selects all, financials, earnings, or info.
A second script computes Piotroski’s F-Score from 9 checks covering profitability, cash flow, leverage, liquidity, dilution, margins, and asset turnover. Its JSON includes the score, each pass/fail criterion, the values used, and a financial-health interpretation. Checks 5–9 compare annual figures across the latest and prior fiscal years.
The skill depends on pandas and yfinance, and the package declares trading-skills as a dependency. When uv or pyproject.toml is unavailable, use python in place of uv run python. Time-based calculations use America/New_York; generated JSON must include generated_at and data_delay. Without pandas and yfinance, the analysis scripts will not run.
What it helps with
- retrieve company metrics for a ticker
- inspect quarterly and annual financials
- compare reported and estimated earnings
- score a company with Piotroski F-Score
Example prompts for the agent
- Fetch the fundamental data for
SYMBOLand summarize its key metrics. - Compare reported earnings with estimates for
SYMBOL. - Run the Piotroski F-Score for
SYMBOLand explain every criterion.
How to install fundamentals
1Skills CLI (Vercel)
npx skills add staskh/trading_skills --skill fundamentals -a claude-code2Manually: put the files in place
~/.claude/skills/fundamentals/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/fundamentals/
1Skills CLI (Vercel)
npx skills add staskh/trading_skills --skill fundamentals -a codex2Manually: put the files in place
.agents/skills/fundamentals/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add staskh/trading_skills --skill fundamentals -a cursor2Manually: put the files in place
.cursor/skills/fundamentals/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install staskh/trading_skills .claude/skills/fundamentals2Manually: put the files in place
.github/skills/fundamentals/SKILL.md1Skills CLI (Vercel)
npx skills add staskh/trading_skills --skill fundamentals -a gemini-cli2Platform CLI
gemini skills install https://github.com/staskh/trading_skills --path .claude/skills/fundamentalsManually: put the files in place
.devin/skills/fundamentals/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add staskh/trading_skills --skill fundamentals -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 fundamentals
How do I install fundamentals in Claude Code?
Run npx skills add staskh/trading_skills --skill fundamentals -a claude-code, then check ~/.claude/skills/fundamentals/SKILL.md.
What does fundamentals do?
It queries Yahoo Finance for ticker-level metrics, financial statements, and earnings. It can also calculate Piotroski’s F-Score with a criterion-by-criterion breakdown.
Which dependencies does the skill need?
The scripts use pandas and yfinance. The package also declares trading-skills as a dependency.
Source text
SKILL.md · MIT
--- name: fundamentals description: Get fundamental financial data including financials, earnings, and key metrics. Use when user asks about financials, earnings, revenue, profit, balance sheet, income statement, or company fundamentals. dependencies: ["trading-skills"] --- # Fundamentals Fetch fundamental financial data from Yahoo Finance. ## Instructions > **Note:** If `uv` is not installed or `pyproject.toml` is not found, replace `uv run python` with `python` in all commands below. ```bash uv run python scripts/fundamentals.py SYMBOL [--type TYPE] ``` ## Arguments - `SYMBOL` - Ticker symbol - `--type` - Data type: all, financials, earnings, info (default: all) ## Output Returns JSON with: - `info` - Key metrics (market cap, PE, EPS, dividend, etc.) - `financials` - Recent quarterly/annual income statement data - `earnings` - Historical and estimated earnings Present key metrics clearly. Compare actual vs estimated earnings if relevant. --- ## Piotroski F-Score Calculate Piotroski's F-Score to evaluate a company's financial strength using 9 fundamental criteria. ### Instructions ```bash uv run python scripts/piotroski.py SYMBOL ``` ### What is Piotroski F-Score? Piotroski's F-Score is a fundamental analysis tool developed by Joseph Piotroski that evaluates a company's financial strength using 9 criteria. Each criterion scores 1 point if passed, 0 if failed, for a maximum score of 9. ### The 9 Criteria 1. **Positive Net Income** - Company is profitable 2. **Positive ROA** - Assets are generating returns 3. **Positive Operating Cash Flow** - Company generates cash from operations 4. **Cash Flow > Net Income** - High-quality earnings (cash exceeds accounting profit) 5. **Lower Long-Term Debt** - Decreasing leverage (improving financial position) 6. **Higher Current Ratio** - Improving liquidity 7. **No New Shares Issued** - No dilution (or share buybacks) 8. **Higher Gross Margin** - Improving profitability efficiency 9. **Higher Asset Turnover** - More efficient use of assets ### Score Interpretation - **8-9:** Excellent - Very strong financial health - **6-7:** Good - Strong financial health - **4-5:** Fair - Moderate financial health - **0-3:** Poor - Weak financial health ### Output Returns JSON with: - `score` - F-Score (0-9) - `max_score` - Maximum possible score (9) - `criteria` - Detailed breakdown of each criterion with pass/fail status and values - `interpretation` - Text description of financial health level - `data_available` - Boolean indicating if year-over-year comparison data is available for criteria 5-9 ### Implementation Details - Criteria 1-4 use quarterly financial data (most recent year) - Criteria 5-9 use annual financial data for year-over-year comparisons - Compares most recent fiscal year vs previous fiscal year ### Use Cases Use Piotroski F-Score when: - Evaluating fundamental financial strength - Screening for value stocks with improving fundamentals - Assessing financial health trends - Comparing financial strength across companies - Identifying companies with strong fundamentals but undervalued prices ## Dependencies - `pandas` - `yfinance` ## Timezone All timestamps and time-based calculations must use the `America/New_York` timezone. All JSON output must include `generated_at` (NY time string) and `data_delay` fields.
© staskh · MIT · staskh/trading_skills