# fin-core

fin-core loads Finance Guru settings, the user profile and portfolio sync details at session start. It gives financial agents a defined workflow and access to CLI calculators.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 1 install · ★ 336 repo stars
- Author: AojdevStudio
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/AojdevStudio/Finance-Guru/tree/HEAD/.claude/skills/fin-core/SKILL.md
- Updated: 2026-10-23
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/fin-core

## What it does

At session start, the `load-fin-core-config` hook prints `config.yaml`, `user-profile.yaml` and `system-context.md`, then reports the last balance sync. Profile and strategy values come from `.env` rather than being fixed in the skill. The available CLI modules cover tasks such as risk analysis, return calculations, options and hedging.

The skill routes work through research, quantitative analysis, strategy and artifact creation. Run a calculator with `uv run python -m`; use `--output json` where that CLI supports it. Run `date` before market research or analysis so the agent has the current date.

Portfolio positions and balances sync from SnapTrade; bank and card activity syncs from SimpleFIN. Run `portfolio-syncing` before quoting a position or balance. Some calculators use broker CSVs in `imports/`, so check the file date before relying on their dollar figures. An older CSV can disagree with the current ledger.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add AojdevStudio/Finance-Guru --skill fin-core -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/fin-core/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/fin-core/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add AojdevStudio/Finance-Guru --skill fin-core -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/fin-core/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add AojdevStudio/Finance-Guru --skill fin-core -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/fin-core/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install AojdevStudio/Finance-Guru .claude/skills/fin-core
```

2. **Manually: put the files in place**
- File: `.github/skills/fin-core/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add AojdevStudio/Finance-Guru --skill fin-core -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/AojdevStudio/Finance-Guru --path .claude/skills/fin-core
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/fin-core/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add AojdevStudio/Finance-Guru --skill fin-core -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/AojdevStudio/Finance-Guru/tree/HEAD/.claude/skills/fin-core/SKILL.md

## When to use it
- load system settings and the user profile at session start
- route a finance request through research, quantitative analysis and strategy
- run a CLI calculator for portfolio risk or returns
- check a broker CSV date before using its figures

## Example prompts
- Load the Finance Guru context, then run `date` before analysing my portfolio.
- Use `src.analysis.total_return_cli` to calculate portfolio returns and show the result as JSON.
- Run `portfolio-syncing` before quoting my current balance.

## Similar
- [trader-memory-core](https://affpapa.org/en/nevibecode/skills/trader-memory-core.md) — skill · 3700 installs
- [longbridge](https://affpapa.org/en/nevibecode/skills/longbridge.md) — skill · 4500 installs
- [longbridge-portfolio](https://affpapa.org/en/nevibecode/skills/longbridge-portfolio.md) — skill · 4000 installs
- [stanley-druckenmiller-investment](https://affpapa.org/en/nevibecode/skills/stanley-druckenmiller-investment.md) — skill · 3900 installs
- [fixed-income-portfolio](https://affpapa.org/en/nevibecode/skills/fixed-income-portfolio.md) — skill · 1900 installs
- [client-review](https://affpapa.org/en/nevibecode/skills/client-review.md) — skill · 1100 installs

From the same set: [aojdevstudio/finance-guru](https://affpapa.org/en/nevibecode/by/aojdevstudio/finance-guru.md) — 2 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
