Finance Skills for Claude Code

A collection of Claude Code skill plugins for financial services. 84 skills across
7 domain plugins teach Claude investment management, regulatory compliance, advisory
workflows, trading operations, and more — so it can assist with finance questions,
build financial tools, and flag compliance concerns.

Built by Joel Lewis.

Contributions welcome! Found a way to improve a skill or have a new one to add?
See CONTRIBUTING.md.

Disclaimer: These skills are provided as-is for educational and informational
purposes only. The authors make no representations or warranties regarding the
accuracy, completeness, or currentness of this content. Nothing in these skills
constitutes financial, legal, tax, or investment advice. Users should independently
verify any information before relying on it in a professional or personal context.
See LICENSE for full terms.

Plugins

core — Mathematical Foundations

Always installed. Provides the math that every other plugin builds on.

Python reference scripts included for all three skills.

wealth-management — Investment Knowledge

Investment knowledge for personal and institutional wealth management. Covers the full
investment lifecycle from risk measurement through reporting.

Risk measurement: Historical volatility estimators, drawdown analysis, historical
VaR, parametric VaR, Monte Carlo VaR, CVaR/Expected Shortfall, GARCH, implied
volatility surfaces.

Asset classes: Equities (factors, index construction, earnings), fixed income
(sovereign, municipal, corporate, structured), commodities, real assets, alternatives,
fund vehicles, currencies and FX, digital assets.

Valuation: Quantitative models (DCF, DDM, comparables, residual income) and
qualitative assessment (moats, management quality, ESG).

Portfolio construction: Diversification theory, mean-variance optimization,
Black-Litterman, risk parity, Kelly criterion, position sizing, calendar- and
threshold-based rebalancing.

Policy and planning: IPS construction, tax-aware investing, asset location,
tax-loss harvesting (dedicated workflow skill), performance attribution (Brinson,
factor-based).

Personal finance: Debt prioritization, mortgage and loan analysis, emergency fund
sizing, savings goals, liquidity management.

Behavioral finance: Cognitive biases, nudges, emotional discipline.

Reporting: Risk-adjusted performance ratios, performance reports, benchmark
comparison, goal progress tracking.

32 skills. Python scripts for quantitative skills (risk, performance metrics, and core
math).

compliance — US Securities Regulatory Guidance

Guidance-only (no Python scripts). Skills teach Claude how to flag problems and share
distilled knowledge from public compliance guides, SEC/FINRA enforcement actions, and
industry practice. All skills cite specific rule numbers and act sections.

16 skills.

advisory-practice — Front Office Systems

Teaches Claude how advisor platforms work so it can help design, evaluate, or integrate
with them. Covers the full advisor workflow from client onboarding through reporting.

12 skills.

trading-operations — Order Lifecycle and Execution

Order lifecycle from entry through settlement. Serves advisor, algorithmic, and
client-direct trading contexts.

9 skills.

client-operations — Account Lifecycle and Servicing

Back-office account operations and servicing workflows.

8 skills.

data-integration — Reference Data and Integration

Data foundations that every financial system depends on.

4 skills.

Installation

Option 1: Claude Code Marketplace (Recommended)

Install via Claude Code's built-in plugin system:

/install JoelLewis/finance_skills

Option 2: npx skills

Use npx skills to install skills directly:

# Install all skills
npx skills add JoelLewis/finance_skills

# Install specific plugins
npx skills add JoelLewis/finance_skills --plugin wealth-management

# List available plugins
npx skills add JoelLewis/finance_skills --list

Option 3: install.sh (Symlink)

Clone the repo and use the included installer, which symlinks skills into your
project so updates are reflected immediately:

git clone https://github.com/JoelLewis/finance_skills.git
cd finance_skills

# Install a single plugin
./install.sh --plugin wealth-management --target /path/to/your/project

# Install all plugins
./install.sh --plugin all --target /path/to/your/project

# List available plugins
./install.sh --list

The installer always installs core first (implicit dependency), then any declared
plugin dependencies, then symlinks each skill into <target>/.claude/skills/.

Option 4: Clone and Copy

Copy skills directly without symlinks:

git clone https://github.com/JoelLewis/finance_skills.git
mkdir -p /path/to/your/project/.claude/skills

# Copy a single plugin
cp -r finance_skills/plugins/core/skills/* /path/to/your/project/.claude/skills/
cp -r finance_skills/plugins/wealth-management/skills/* /path/to/your/project/.claude/skills/

# Or copy everything
for plugin in finance_skills/plugins/*/; do
  cp -r "$plugin"skills/* /path/to/your/project/.claude/skills/
done

What Gets Installed

your-project/
└── .claude/
    └── skills/
        ├── return-calculations/    # from core
        ├── time-value-of-money/    # from core
        ├── statistics-fundamentals/ # from core
        ├── historical-risk/        # from wealth-management
        └── ...

After installing, Claude will automatically pick up the skills. Verify with:

ls /path/to/your/project/.claude/skills/

Plugin Dependency Graph

core (implicit — always installed)
  ├── wealth-management
  ├── compliance  ←── (recommended for all plugins)
  ├── advisory-practice  ←── depends on wealth-management
  ├── trading-operations
  ├── client-operations
  └── data-integration

Installing advisory-practice automatically installs core and wealth-management.
Installing any plugin automatically installs core.

Repository Structure

finance_skills/
├── README.md
├── PLAN.md                    # Architecture and implementation roadmap
├── CLAUDE.md                  # Claude Code project instructions
├── marketplace.json           # Machine-readable catalog of all plugins
├── install.sh                 # Plugin installer
└── plugins/
    ├── core/
    │   ├── plugin.json
    │   └── skills/
    │       ├── return-calculations/
    │       ├── time-value-of-money/
    │       └── statistics-fundamentals/
    ├── wealth-management/
    │   ├── plugin.json
    │   └── skills/
    │       └── ... (32 skills)
    ├── compliance/
    │   ├── plugin.json
    │   └── skills/
    │       └── ... (16 skills)
    ├── advisory-practice/
    │   ├── plugin.json
    │   └── skills/
    │       └── ... (12 skills)
    ├── trading-operations/
    │   ├── plugin.json
    │   └── skills/
    │       └── ... (9 skills)
    ├── client-operations/
    │   ├── plugin.json
    │   └── skills/
    │       └── ... (8 skills)
    └── data-integration/
        ├── plugin.json
        └── skills/
            └── ... (4 skills)

Skill Template

Each SKILL.md follows a consistent structure:

• Purpose — what the skill enables Claude to do
• When to Use — trigger phrases and situations
• Core Concepts — the domain knowledge, with formulas where applicable
• Key Formulas — reference table (quantitative skills only)
• Worked Examples — concrete scenarios with step-by-step analysis
• Common Pitfalls — mistakes to watch for
• Cross-References — links to related skills in other plugins
• Reference Implementation — pointer to Python script (quantitative skills only)

Compliance and operations skills use scenario-based examples
(Scenario / Compliance Issues / Analysis) and cite specific rule numbers inline.
Quantitative skills include worked numerical examples and runnable Python scripts.

What Are Plugins?

Each plugin is a collection of SKILL.md files (and optional Python reference scripts)
that teach Claude domain knowledge. When installed, Claude can:

• Answer domain-specific questions with regulatory citations and worked examples
• Flag compliance concerns during design discussions
• Generate and explain financial computations
• Assist with building, evaluating, or integrating with financial systems

Plugins are independently installable — pull only the domains your project needs. The
core plugin is implicit and always included.

Plugin Architecture

Design Principles

• core is implicit — always installed; every plugin depends on it
• Plugins are independently installable — a project pulls only the domains it needs
• Cross-plugin references are allowed — skills reference related skills in other plugins via cross-references section
• Skills live in .claude/skills/ — installation symlinks a plugin's skills into the target project's skill directory
• No Python scripts for guidance-only skills — compliance/operations plugins are guidance-only; quantitative plugins may have scripts/ subdirectories

Plugin Dependency Graph

core (implicit — always installed)
  ├── wealth-management
  ├── compliance  ←── (recommended for all plugins)
  ├── advisory-practice  ←── depends on wealth-management
  ├── trading-operations
  ├── client-operations
  └── data-integration

SKILL.md Template

Each skill follows this structure:

---
name: <skill-name>
description: <one-line description used for skill matching>
allowed-tools: ["Bash", "Read", "Write", "Edit"]
---

# <Skill Title>

## Purpose
What this skill enables Claude to do.

## Layer
N — Layer Name

## Direction
retrospective | prospective | both

## When to Use
- Trigger phrases and situations

## Core Concepts
### <Concept>
Explanation with formulas.

## Key Formulas (optional — omit for non-quantitative skills)
| Formula | Expression | Use Case |

## Worked Examples
### Example 1: <title>
**Given:** ... **Calculate:** ... **Solution:** ...
(Compliance/operations skills use scenario-based examples:
**Scenario:** ... **Compliance Issues:** ... **Analysis:** ...)

## Common Pitfalls
- Things to watch out for

## Cross-References
- Related skills

## Reference Implementation (optional — omit for guidance-only skills)
See `scripts/<name>.py` for computational helpers.

Cross-Plugin Connection Registry