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.

• 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.

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.

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

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

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.

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.

• 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.

• 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.

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.

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.

MIT. See LICENSE.