tradermonty/claude-trading-skills
Claude Code skills for equity investors and traders — market analysis, technical charting, economic calendars, screeners, and trading strategy development.
About tradermonty/claude-trading-skills
tradermonty/claude-trading-skills is an open-source project on GitHub, mainly written in Python. Claude Code skills for equity investors and traders — market analysis, technical charting, economic calendars, screeners, and trading strategy development. It currently holds 3,842 stars and 842 forks with 74 open issues, and was last pushed on 2026-11-12 (repository created 2025-10-19).
Project Overview
Git Homed tracks it on the Today's Trending board, currently at rank #9 with 837 new stars today.
GitHub Repository Details
README
Claude Trading Skills
Claude Trading Skills started as a personal project to use AI to improve my own trading process.
Claude Trading Skills is a Claude Skills-based trading workflow toolkit for time-constrained individual investors.
It is designed for investors who use long-term investing, ETFs, and dividend stocks as their core, while using disciplined swing trading as a satellite strategy when market conditions are favorable.
The goal is not to outsource buy/sell decisions to AI. The goal is to structure market review, risk management, trade planning, journaling, and continuous improvement. It is open source because the workflows, checklists, and review habits behind better trading decisions can improve through shared practice.
This is not a signal service or a promise of profitability. It is a toolkit for traders who want to build a better decision process.
The project follows a first for self, open for others stance: it is built first as a practical workflow the author uses, then shared openly for others who face similar constraints.
📖 Documentation site:
Project vision: PROJECT_VISION.md
日本語版READMEはREADME.ja.mdをご覧ください。
Disclaimer
This repository is for educational, research, and process-improvement purposes only. It is not financial advice, investment advisory service, tax advice, legal advice, a signal service, or a broker execution platform. Trading and investing involve risk, including loss of principal. Past performance, backtests, screens, reports, and AI-generated analysis do not guarantee future results. All trading decisions, position sizing, tax/regulatory compliance, and broker usage are the user's responsibility.
The project is provided under the MIT License, AS IS, WITHOUT WARRANTY.
Who This Is For
This repository is designed for:
- Time-constrained individual investors
- Long-term investors who also want disciplined swing-trading upside
- Dividend and ETF investors who want structured portfolio review
- Traders who want to manage risk before finding trade candidates
- Investors who want to journal and improve their decision process
Recommended Starting Path
New users should start with one of these operational workflows. Each link points to a machine-readable manifest under workflows/ that names the exact skills, decision gates, and artifacts in order.
| Goal | Workflow | Anchor Skills | API Profile |
| --- | --- | --- | --- |
| 15-minute daily market check | market-regime-daily | market-breadth-analyzer, uptrend-analyzer, exposure-coach | No API for basic path |
| Weekly long-term portfolio review | core-portfolio-weekly (sample) | portfolio-manager, kanchi-dividend-review-monitor, trader-memory-core | Alpaca required; manual CSV is a degraded fallback |
| Find swing candidates only when risk is allowed | swing-opportunity-daily (sample) | vcp-screener, drawdown-circuit-breaker, technical-analyst, position-sizer, trader-memory-core, pre-trade-discipline-gate | FMP for screeners; local state for risk and discipline gates |
| Record and learn from every closed trade | trade-memory-loop | trader-memory-core, signal-postmortem | No API for manual path |
| Review monthly performance and adjust rules | monthly-performance-review (sample) | trader-memory-core, signal-postmortem, backtest-expert | No API for manual path |
See workflows/README.md for how to read a manifest and run it manually. For a one-page "which workflow fits my situation?" guide, see Find Your Workflow (日本語).
New here? Follow Your First Week (日本語) from installation through a no-paid-data-API market check, first journal entry, and first weekly review.
See Example Outputs
These visual excerpts use fictional data to show the kinds of results you can review before setting up a skill. They are illustrations, not live market readings or trading instructions.
Select a preview to open the full-size SVG; on a phone, zoom after opening.
Choose a workflow: Trading Skills Navigator recommends a starting path from your goal.
Review market risk: The market-regime-daily workflow ends with an Exposure Coach posture for human review, not an order.
Learn from closed trades: Weekly Performance Digest summarizes realized outcomes and process lessons.
What This Actually Costs
Claude Web Skills are currently available on Free, Pro, Max, Team, and Enterprise accounts; see Anthropic's current Skills help because access can change. Claude Code has separate account requirements, and the Claude.ai Free plan does not include it; see the Claude Code setup guide. FMP, FINVIZ Elite, and Alpaca are optional data or broker integrations for specific workflows. The five-skill starter path below works with public CSVs, chart screenshots, and local files, so it does not require a paid market-data API subscription.
No API Key Starter Path
If you do not have FMP / FINVIZ / Alpaca subscriptions, start with these five skills and run them manually:
1. market-breadth-analyzer — public CSV breadth scoring; no API key
2. uptrend-analyzer — public CSV uptrend participation; no API key
3. position-sizer — pure calculation; no I/O
4. trader-memory-core — local YAML journaling
5. signal-postmortem — review framework
This path lets you review market conditions, size trades, journal decisions, and review outcomes without paid data APIs. Note: "no API" does not mean "no external data" — these skills still need public CSVs, chart screenshots, or local files. See each skill's integrations: entry in skills-index.yaml for exact input requirements.
Canonical source:skills-index.yamlis the authoritative index of all skills. If this README,CLAUDE.md, or docs disagree with the index, the index is correct. The same applies to multi-skill workflows —workflows/*.yamlis canonical.
Repository Layout
skills//– Source folder for each trading skill. ContainsSKILL.md, reference material, and any helper scripts.skills-index.yaml– Canonical metadata index for every skill (id, category, integrations, workflows back-references).workflows/– Operational workflow manifests for the Core + Satellite routines (canonical, validator-enforced via--strict-workflows).skill-packages/– Pre-built.skillarchives ready to upload to Claude's web app Skills tab.docs/– Documentation site content, generated skill pages, anddocs/dev/metadata-and-workflow-schema.md(schema spec).scripts/– Repository-level automation, including the schema validator and one-shot bootstrap helper.skillsets/– Purpose-specific install bundles defining required / recommended / optional skills for major goals (6 skillsets shipped: market-regime, core-portfolio, dividend-income, swing-opportunity, trade-memory, strategy-research; consumed by the Navigator).
Getting Started
First time here? Read the FAQ for plan, cost, safety, and scope answers.
See the Changelog for changes and the release compatibility and migration policy before updating an installed skill.
Use with Claude Web App
1. Open the latest GitHub Release and download the.skill asset that matches the skill you want, plus SHA256SUMS. Verify its hash as described in the release policy. If the Releases page is empty, follow the source-folder installation path below or build a local package with scripts/package_skills.py.
2. For an individual account, open Settings > Capabilities and enable Code execution and file creation. Team and Enterprise users may need an organization owner to enable Skills.
3. Open Customize > Skills, upload the ZIP, confirm it appears in the list, and enable it if needed (see Anthropic's current Skills help).
Use with Claude Code (desktop or CLI)
1. Clone or download this repository. 2. Copy the desired skill folder (e.g.,backtest-expert) to ~/.claude/skills/ for personal use or .claude/skills/ inside a project (see the Claude Code setup guide).
3. Claude Code detects changes in an existing skills directory. Restart it only if you created the top-level skills directory after the session started.
Tip:.skillpackages are built from the source folders with tests and local build artifacts omitted. Edit a source folder if you want to customize a skill, then runpython3 scripts/package_skills.py --skillbefore uploading to the web app.
Supported platforms
The shared project environment supports Python 3.11 to 3.13 on Linux, Windows, and macOS. Packaged standalone skills retain a Python 3.9 source floor. A root-project combination counts as supported only if it is exercised by the project's CI; other combinations in that range are best-effort and unverified. See docs/dev/compatibility-matrix.md for the exact supported matrix and how it is enforced.
Companion Work Package
Want a ready-to-run agent-style workflow? See the companion Hermes Trading Research Agent Work Package.
It packages these skills into a Hermes profile with task-oriented slash-command routines such as
/pre-market-routine, /after-close-review, /trade-journal, /weekly-portfolio-review, and
/monthly-performance-review.
This is a research, journaling, and risk-review assistant, not an automated trading system. It does not place orders, provide a signal service, or run hidden scheduled jobs; human decision gates remain central.
Core Skill Areas
This repository contains skills across the following areas:
| Area | Example Skills |
| --- | --- |
| Market Regime | market-breadth-analyzer, uptrend-analyzer, exposure-coach |
| Core Portfolio | portfolio-manager, us-undervalued-growth-screener |
| Dividend Income | kanchi-dividend-sop, value-dividend-screener, dividend-growth-pullback-screener |
| Swing Opportunities | vcp-screener, canslim-screener, breakout-trade-planner |
| Trade Planning | position-sizer, technical-analyst, pre-trade-discipline-gate |
| Trade Memory | trader-memory-core, signal-postmortem |
| Strategy Research | backtest-expert, manifoldbt-backtester, edge-pipeline-orchestrator |
| Advanced Satellite | parabolic-short-trade-planner, earnings-trade-analyzer, options-strategy-advisor |
The detailed catalog below is auto-generated from skills-index.yaml by scripts/generate_catalog_from_index.py. To update a skill's description, edit its skills-index.yaml entry and re-run the generator (python3 scripts/generate_catalog_from_index.py). For a more navigable version, use the documentation site. For an auto-generated overview of skill lifecycle, test coverage, and runtime health, see the Quality Dashboard.
Detailed Skill Catalog
Market Regime
| Skill | Summary | Integrations | Role | Status |
|---|---|---|---|---|
| Breadth Chart Analyst (breadth-chart-analyst) | This skill should be used when analyzing market breadth charts, specifically the S&P 500 Breadth Index (200-Day MA based) and the US Stock Market Uptrend Stock Ratio charts. | chart_image required | standalone | production |
| COT Contrarian Detector (cot-contrarian-detector) | Detects crowded speculative (large-speculator) positioning in CFTC futures markets using Commitment of Traders data, implementing step 1 of Jason Shapiro's contrarian methodology. | fmp required | workflow_step | production |
| Crypto Regime Analyzer (crypto-regime-analyzer) | Quantifies crypto market regime health (0-100 composite, 100 = risk-on) from six components using free keyless public data. | coingecko required, binance_funding _recommended_, prices_json optional | standalone | beta |
| Downtrend Duration Analyzer (downtrend-duration-analyzer) | Analyze historical downtrend durations and generate interactive HTML histograms showing typical correction lengths by sector and market cap. | fmp required | research_only | production |
| Exposure Coach (exposure-coach) | Generate a one-page Market Posture summary with net exposure ceiling, growth-vs-value bias, participation breadth, and new-entry-allowed vs cash-priority recommendation by integrating signals from breadth, regime, and flow analysis skills. | local_calculation — | workflow_step | production |
| FTD Detector (ftd-detector) | Detects Follow-Through Day (FTD) signals for market bottom confirmation using William O'Neil's methodology. | fmp required | standalone | production |
| IBD Distribution Day Monitor (ibd-distribution-day-monitor) | Detect IBD-style Distribution Days for QQQ/SPY (close down at least 0.2% on higher volume), track 25-session expiration and 5% invalidation, count d5/d15/d25 clusters, classify market risk (NORMAL/CAUTION/HIGH/SEVERE), and emit TQQQ/QQQ... | fmp required | standalone | production |
| Macro Regime Detector (macro-regime-detector) | Detect structural macro regime transitions (1-2 year horizon) using cross-asset ratio analysis. | yfinance required, fmp optional | workflow_step | production |
| Market Breadth Analyzer (market-breadth-analyzer) | Quantifies market breadth health using TraderMonty's public CSV data. | public_csv required | workflow_step | production |
| Market Environment Analysis (market-environment-analysis) | Comprehensive market environment analysis and reporting tool. | websearch required, chart_image optional | workflow_step | production |
| Market News Analyst (market-news-analyst) | This skill should be used when analyzing recent market-moving news events and their impact on equity markets and commodities. | websearch required | workflow_step | production |
| Market Top Detector (market-top-detector) | Assesses heuristic market top risk using O'Neil Distribution Days, Minervini Leading Stock Deterioration, and Monty Defensive Sector Rotation. | fmp required, public_csv optional | workflow_step | production |
| News Reaction Failure Analyzer (news-reaction-failure-analyzer) | Judges whether a market failed to react to news favorable to a crowded speculative position, implementing step 2 of Jason Shapiro's contrarian methodology with a Monte-Carlo-verified drift-significance verdict test. | fmp required, websearch required | workflow_step | production |
| Sector Analyst (sector-analyst) | This skill should be used when analyzing sector rotation patterns and market cycle positioning. | chart_image required | workflow_step | production |
| Uptrend Analyzer (uptrend-analyzer) | Analyzes market breadth using Monty's Uptrend Ratio Dashboard data to diagnose the current market environment. | public_csv required | workflow_step | production |
| US Market Bubble Detector (us-market-bubble-detector) | Evaluates market bubble risk through quantitative data-driven analysis using the revised Minsky/Kindleberger framework v2.1. | user_input required | standalone | production |
Core Portfolio
| Skill | Summary | Integrations | Role | Status |
|---|---|---|---|---|
| Portfolio Manager (portfolio-manager) | Comprehensive portfolio analysis using Alpaca MCP Server integration to fetch holdings and positions, then analyze asset allocation, risk metrics, individual stock positions, diversification, and generate rebalancing recommendations. | alpaca optional | workflow_step | production |
| US Undervalued Growth Screener (us-undervalued-growth-screener) | Screen and rank US-listed small- and mid-cap undervalued-growth stocks with a generated stable-first FMP client, persistent SQLite cache, adaptive listing enumeration, FY1 estimate normalization, verified 20-day liquidity, deterministic four-lane discovery, forward same-basis valuation, standard and SBC-adjusted FCF, dilution, peer, cycle and LOE controls, strict final evaluation, prepublication audit, and a self-contained evidence bundle. | fmp _recommended_, alternate_market_data optional, sec_edgar required, company_ir required, official_macro required, local_calculation — | standalone | beta |
Dividend Income
| Skill | Summary | Integrations | Role | Status |
|---|---|---|---|---|
| Dividend Growth Pullback Screener (dividend-growth-pullback-screener) | Use this skill to find high-quality dividend growth stocks (12%+ annual dividend growth, 1.5%+ yield) that are experiencing temporary pullbacks, identified by RSI oversold conditions (RSI ≤40). | fmp required, finviz _recommended_ | workflow_step | production |
| Kanchi Dividend Review Monitor (kanchi-dividend-review-monitor) | Monitor dividend portfolios with Kanchi-style forced-review triggers (T1-T5) and convert anomalies into OK/WARN/REVIEW states without auto-selling. | fmp _recommended_ | workflow_step | production |
| Kanchi Dividend SOP (kanchi-dividend-sop) | Convert Kanchi-style dividend investing into a repeatable US-stock operating procedure. | fmp _recommended_ | workflow_step | production |
| Kanchi Dividend US Tax Accounting (kanchi-dividend-us-tax-accounting) | Provide US dividend tax and account-location workflow for Kanchi-style income portfolios. | local_calculation — | workflow_step | production |
| Value Dividend Screener (value-dividend-screener) | Screen US stocks for high-quality dividend opportunities combining value characteristics (P/E ratio under 20, P/B ratio under 2), attractive yields (3% or higher), and consistent growth (dividend/revenue/EPS trending up over 3 years). | fmp required, finviz _recommended_ | workflow_step | production |
Swing Opportunity
| Skill | Summary | Integrations | Role | Status |
|---|---|---|---|---|
| Breakout Trade Planner (breakout-trade-planner) | Generate Minervini-style breakout trade plans from VCP screener output with worst-case risk calculation, portfolio heat management, and Alpaca-compatible order templates (stop-limit bracket for pre-placement, limit bracket for post-confi... | local_calculation — | workflow_step | production |
| CANSLIM Screener (canslim-screener) | Screen US stocks using William O'Neil's CANSLIM growth stock methodology. | fmp required | workflow_step | production |
| Finviz Screener (finviz-screener) | Build and open FinViz screener URLs from natural language requests. | finviz optional | standalone | production |
| Stockbee Exhaustion Hammer Screener (stockbee-exhaustion-hammer-screener) | Screen US stocks for Stockbee-style selling-exhaustion hammer candidates using quality/liquidity gates, prior momentum, pullback depth, undercut/reclaim, hammer geometry, volume confirmation, market gate, and risk-distance filters. | fmp required, prices_json optional, profiles_json optional, local_calculation — | workflow_step | beta |
| Stockbee Momentum Burst Screener (stockbee-momentum-burst-screener) | Screen US stocks for Stockbee-style 3-5 day momentum burst candidates using 4% breakout, dollar breakout, range expansion, volume expansion, setup quality, and risk-distance filters. | fmp required, prices_json optional, local_calculation — | workflow_step | beta |
| Theme Detector (theme-detector) | Detect and analyze trending market themes across sectors. | fmp optional, finviz _recommended_ | workflow_step | production |
| VCP Screener (vcp-screener) | Screen S&P 500 stocks for Mark Minervini's Volatility Contraction Pattern (VCP). | fmp required | workflow_step | production |
Trade Planning
| Skill | Summary | Integrations | Role | Status |
|---|---|---|---|---|
| Contrarian Setup Gate (contrarian-setup-gate) | Offline synthesis gate that combines COT crowding, news-reaction failure, and weekly price-action confirmation into one actionable setup_status via a fail-closed precedence state machine, implementing the decision center of Jason Shapiro's contrarian methodology. | local_calculation — | workflow_step | production |
| Drawdown Circuit Breaker (drawdown-circuit-breaker) | Account-level circuit breaker that reads trader-memory-core state and decides whether new trade risk is allowed today using daily loss limits, losing-streak cooldowns, and weekly/monthly drawdown halts. | local_calculation — | workflow_step | production |
| Futures Position Sizer (futures-position-sizer) | Calculate contract-based futures position sizes from a direction, entry, and stop-loss, using a verified 23-market contract-spec table (multiplier, tick size, tick value), implementing step 4 of Jason Shapiro's contrarian pipeline. | local_calculation — | workflow_step | production |
| Position Sizer (position-sizer) | Calculate risk-based position sizes for long stock trades. | local_calculation — | workflow_step | production |
| Pre-Trade Discipline Gate (pre-trade-discipline-gate) | Offline manual-execution checklist gate that blocks planless, oversized, revenge-risk, market-regime-blocked, or circuit-breaker-blocked entries and journals the result. | local_calculation — | workflow_step | production |
| Technical Analyst (technical-analyst) | This skill should be used when analyzing weekly price charts for stocks, stock indices, cryptocurrencies, or forex pairs. | chart_image required, fmp optional | workflow_step | production |
| US Stock Analysis (us-stock-analysis) | Comprehensive US stock analysis including fundamental analysis (financial metrics, business quality, valuation), technical analysis (indicators, chart patterns, support/r