# vreddy0082/claude-trading-skills architecture

> Architecture diagram of the GitHub repository vreddy0082/claude-trading-skills, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-14). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vreddy0082/claude-trading-skills
- Repository: https://github.com/vreddy0082/claude-trading-skills

## Overview

Claude Trading Skills is a collection of human-directed trading and investing workflows, not an automated trading or broker-execution platform. The principal loop is to review market conditions, apply risk gates, evaluate candidates, plan and size trades, then journal outcomes and learn from them. Separate workflows support long-term portfolio and dividend reviews. The graph combines these documented capabilities with sampled implementation areas; many individual skills and their internal calls were not sampled, so their connections are shown only where the README supports them.

Main entry points: [`workflows`](https://github.com/vreddy0082/claude-trading-skills/tree/main/workflows) (Workflow manifests), [`skills/trading-skills-navigator/scripts/recommend.py`](https://github.com/vreddy0082/claude-trading-skills/blob/main/skills/trading-skills-navigator/scripts/recommend.py) (Workflow navigator), [`skills/ftd-detector/scripts/fmp_client.py`](https://github.com/vreddy0082/claude-trading-skills/blob/main/skills/ftd-detector/scripts/fmp_client.py) (FMP data client), [`skills/portfolio-manager`](https://github.com/vreddy0082/claude-trading-skills/tree/main/skills/portfolio-manager) (Portfolio review)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Workflow entry points"]
  node_manifests["Workflow manifests"]
  node_navigator["Workflow navigator<br/>[recommend.py]"]
end

subgraph group_market["Market research"]
  node_breadth["Market breadth"]
  node_uptrend["Uptrend analysis"]
  node_growth["Growth screening"]
  node_ftd["FMP data client<br/>[fmp_client.py]"]
  node_vcp["VCP screening"]
end

subgraph group_risk["Risk and planning"]
  node_exposure["Exposure coaching"]
  node_circuit["Drawdown gate"]
  node_technical["Technical analysis"]
  node_sizing["Position sizing"]
  node_discipline["Pre-trade gate"]
end

subgraph group_portfolio["Portfolio routines"]
  node_portfolio["Portfolio review"]
  node_dividend["Dividend review"]
end

subgraph group_learning["Memory and improvement"]
  node_memory[("Trader memory")]
  node_postmortem["Signal postmortem"]
  node_backtest["Backtest analysis"]
end

node_investor(("Individual investor"))
node_fmp{{"FMP service"}}
node_alpaca{{"Alpaca service"}}

node_investor -->|"chooses workflow"| node_navigator
node_navigator -->|"recommends path"| node_manifests
node_investor -->|"follows workflow"| node_manifests
node_manifests -->|"daily review"| node_breadth
node_manifests -->|"daily review"| node_uptrend
node_manifests -->|"review posture"| node_exposure
node_manifests -->|"screens candidates"| node_vcp
node_manifests -->|"gates risk"| node_circuit
node_manifests -->|"reviews setups"| node_technical
node_manifests -->|"sizes trades"| node_sizing
node_manifests -->|"checks discipline"| node_discipline
node_manifests -->|"reviews portfolio"| node_portfolio
node_manifests -->|"reviews dividends"| node_dividend
node_manifests -->|"records trades"| node_memory
node_manifests -->|"reviews outcomes"| node_postmortem
node_manifests -->|"reviews rules"| node_backtest
node_growth -->|"uses client"| node_ftd
node_ftd -.->|"requests data"| node_fmp
node_portfolio -.->|"connects broker"| node_alpaca

click node_manifests "https://github.com/vreddy0082/claude-trading-skills/tree/main/workflows"
click node_navigator "https://github.com/vreddy0082/claude-trading-skills/blob/main/skills/trading-skills-navigator/scripts/recommend.py"
click node_breadth "https://github.com/vreddy0082/claude-trading-skills/tree/main/skills/market-breadth-analyzer"
click node_uptrend "https://github.com/vreddy0082/claude-trading-skills/tree/main/skills/uptrend-analyzer"
click node_growth "https://github.com/vreddy0082/claude-trading-skills/tree/main/skills/us-undervalued-growth-screener/scripts"
click node_ftd "https://github.com/vreddy0082/claude-trading-skills/blob/main/skills/ftd-detector/scripts/fmp_client.py"
click node_vcp "https://github.com/vreddy0082/claude-trading-skills/tree/main/skills/vcp-screener"
click node_exposure "https://github.com/vreddy0082/claude-trading-skills/tree/main/skills/exposure-coach"
click node_circuit "https://github.com/vreddy0082/claude-trading-skills/tree/main/skills/drawdown-circuit-breaker"
click node_technical "https://github.com/vreddy0082/claude-trading-skills/tree/main/skills/technical-analyst"
click node_sizing "https://github.com/vreddy0082/claude-trading-skills/tree/main/skills/position-sizer"
click node_discipline "https://github.com/vreddy0082/claude-trading-skills/tree/main/skills/pre-trade-discipline-gate"
click node_portfolio "https://github.com/vreddy0082/claude-trading-skills/tree/main/skills/portfolio-manager"
click node_dividend "https://github.com/vreddy0082/claude-trading-skills/tree/main/skills/kanchi-dividend-review-monitor"
click node_memory "https://github.com/vreddy0082/claude-trading-skills/tree/main/skills/trader-memory-core/scripts"
click node_postmortem "https://github.com/vreddy0082/claude-trading-skills/tree/main/skills/signal-postmortem"
click node_backtest "https://github.com/vreddy0082/claude-trading-skills/tree/main/skills/backtest-expert"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_manifests,node_navigator toneBlue
class node_breadth,node_uptrend,node_growth,node_ftd,node_vcp toneAmber
class node_exposure,node_circuit,node_technical,node_sizing,node_discipline toneMint
class node_portfolio,node_dividend toneRose
class node_memory,node_postmortem,node_backtest,node_investor,node_fmp,node_alpaca toneIndigo
```

## Components

### Workflow entry points

- [Workflow manifests](https://github.com/vreddy0082/claude-trading-skills/tree/main/workflows): `workflows`
- [Workflow navigator](https://github.com/vreddy0082/claude-trading-skills/blob/main/skills/trading-skills-navigator/scripts/recommend.py): `skills/trading-skills-navigator/scripts/recommend.py`

### Market research

- [Market breadth](https://github.com/vreddy0082/claude-trading-skills/tree/main/skills/market-breadth-analyzer): `skills/market-breadth-analyzer`
- [Uptrend analysis](https://github.com/vreddy0082/claude-trading-skills/tree/main/skills/uptrend-analyzer): `skills/uptrend-analyzer`
- [Growth screening](https://github.com/vreddy0082/claude-trading-skills/tree/main/skills/us-undervalued-growth-screener/scripts): `skills/us-undervalued-growth-screener/scripts`
- [FMP data client](https://github.com/vreddy0082/claude-trading-skills/blob/main/skills/ftd-detector/scripts/fmp_client.py): `skills/ftd-detector/scripts/fmp_client.py`
- [VCP screening](https://github.com/vreddy0082/claude-trading-skills/tree/main/skills/vcp-screener): `skills/vcp-screener`

### Risk and planning

- [Exposure coaching](https://github.com/vreddy0082/claude-trading-skills/tree/main/skills/exposure-coach): `skills/exposure-coach`
- [Drawdown gate](https://github.com/vreddy0082/claude-trading-skills/tree/main/skills/drawdown-circuit-breaker): `skills/drawdown-circuit-breaker`
- [Technical analysis](https://github.com/vreddy0082/claude-trading-skills/tree/main/skills/technical-analyst): `skills/technical-analyst`
- [Position sizing](https://github.com/vreddy0082/claude-trading-skills/tree/main/skills/position-sizer): `skills/position-sizer`
- [Pre-trade gate](https://github.com/vreddy0082/claude-trading-skills/tree/main/skills/pre-trade-discipline-gate): `skills/pre-trade-discipline-gate`

### Portfolio routines

- [Portfolio review](https://github.com/vreddy0082/claude-trading-skills/tree/main/skills/portfolio-manager): `skills/portfolio-manager`
- [Dividend review](https://github.com/vreddy0082/claude-trading-skills/tree/main/skills/kanchi-dividend-review-monitor): `skills/kanchi-dividend-review-monitor`

### Memory and improvement

- [Trader memory](https://github.com/vreddy0082/claude-trading-skills/tree/main/skills/trader-memory-core/scripts): `skills/trader-memory-core/scripts`
- [Signal postmortem](https://github.com/vreddy0082/claude-trading-skills/tree/main/skills/signal-postmortem): `skills/signal-postmortem`
- [Backtest analysis](https://github.com/vreddy0082/claude-trading-skills/tree/main/skills/backtest-expert): `skills/backtest-expert`

### Other components

- **Individual investor**
- **FMP service**
- **Alpaca service**

## Connections

- Individual investor → Workflow navigator: chooses workflow (evidence: `README.md`)
- Workflow navigator → Workflow manifests: recommends path (evidence: `README.md`)
- Individual investor → Workflow manifests: follows workflow (evidence: `README.md`)
- Workflow manifests → Market breadth: daily review (evidence: `README.md`)
- Workflow manifests → Uptrend analysis: daily review (evidence: `README.md`)
- Workflow manifests → Exposure coaching: review posture (evidence: `README.md`)
- Workflow manifests → VCP screening: screens candidates (evidence: `README.md`)
- Workflow manifests → Drawdown gate: gates risk (evidence: `README.md`)
- Workflow manifests → Technical analysis: reviews setups (evidence: `README.md`)
- Workflow manifests → Position sizing: sizes trades (evidence: `README.md`)
- Workflow manifests → Pre-trade gate: checks discipline (evidence: `README.md`)
- Workflow manifests → Portfolio review: reviews portfolio (evidence: `README.md`)
- Workflow manifests → Dividend review: reviews dividends (evidence: `README.md`)
- Workflow manifests → Trader memory: records trades (evidence: `README.md`)
- Workflow manifests → Signal postmortem: reviews outcomes (evidence: `README.md`)
- Workflow manifests → Backtest analysis: reviews rules (evidence: `README.md`)
- Growth screening → FMP data client: uses client (evidence: `skills/us-undervalued-growth-screener/scripts/pipeline_enrichment.py`)
- FMP data client → FMP service: requests data
- Portfolio review → Alpaca service: connects broker (evidence: `README.md`)