Claude Trading Skills

Build disciplined, repeatable trading workflows with a modern TypeScript platform.

This repository gives you:

• a strict TypeScript CLI for workflow execution and metadata validation,
• a large skill catalog for market analysis, screening, and review loops,
• optional Redis-backed state caching for faster repeated runs.

Designed for discretionary traders who want better process quality, not "black-box" auto trading.

Educational use only. Not financial advice.

---

Why This Repo Stands Out

• TypeScript-first runtime: strongly typed CLI, validators, config, and tooling.
• Skill-rich ecosystem: reusable modules for regime analysis, idea generation, sizing, and postmortems.
• Workflow orchestration: YAML-driven playbooks with clear decision gates.
• Production hygiene: strict lint/typecheck/test pipeline and deterministic builds.
• Flexible operation: runs locally with or without Redis.

---

Quick Start (3 Minutes)

git clone https://github.com/tradermonty/claude-trading-skills.git
cd claude-trading-skills
npm install
cp .env.example .env
npm run validate

If validation passes, you are ready.

---

First Commands To Run

npx trading-skills list
npx trading-skills workflows
npx trading-skills workflow market-regime-daily
npx trading-skills validate
npx trading-skills validate-index --strict-workflows

---

Project Layout

claude-trading-skills/
├── src/                  # TypeScript runtime, CLI, config, validators
├── tests/                # Vitest suites
├── skills/               # Skill content and execution assets
├── workflows/            # YAML workflow definitions
├── skillsets/            # Installable bundles by use-case
├── skills-index.yaml     # Canonical skill registry
├── docs/                 # Architecture and contributor docs
└── package.json          # Build/test/lint scripts

---

TypeScript Development

npm run dev
npm run typecheck
npm run lint
npm run test
npm run build
npm run validate

npm run validate is the canonical local gate before pushing.

---

Environment Configuration

Copy .env.example to .env and adjust:

• LOG_LEVEL (info, debug, error)
• REDIS_ENABLED (true or false)
• REDIS_URL (defaults to local Redis)
• REDIS_KEY_PREFIX
• REDIS_CACHE_TTL_SECONDS
• SKILLS_DIR
• SKILLS_INDEX_PATH
• WORKFLOWS_DIR

No Redis? Set REDIS_ENABLED=false and continue.

---

Recommended Workflows

• Daily market posture: market-regime-daily
• Swing scan routine: swing-opportunity-daily
• Weekly portfolio review: core-portfolio-weekly
• Trade journaling loop: trade-memory-loop
• Monthly performance review: monthly-performance-review

Workflow truth source lives in workflows/ and skills-index.yaml.

---

Troubleshooting

• Type errors after pulling: run npm install then npm run typecheck.
• Lint failures: run npm run lint and fix reported files.
• Workflow validation errors: run npx trading-skills validate-index --strict-workflows.
• Redis unavailable: set REDIS_ENABLED=false in .env.

---

Contributing

1. Create a feature branch.
2. Make focused changes.
3. Run npm run validate.
4. Update relevant docs when behavior changes.
5. Open a PR with clear test evidence.

For deeper architecture context, see docs/STRUCTURE.md and docs/AUDIT.md.

---

FAQ

Is this an autonomous trading bot?
No. It structures analysis and decision quality; humans remain in control.

Can I run without Redis?
Yes. Redis is optional.

What is the canonical registry?
skills-index.yaml.

---

License

MIT. See LICENSE.