Skip to main content
skill CX Codex

fin-core — Claude Code skill: context and installation

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.

AGPL-3.0 1 installs ★ 336 updated 2026-10-23

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add AojdevStudio/Finance-Guru --skill fin-core -a claude-code
Open on GitHub

What fin-core 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.

What it helps with

  • 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 for the agent

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

How to install fin-core

1Skills CLI (Vercel)

npx skills add AojdevStudio/Finance-Guru --skill fin-core -a claude-code

2Manually: put the files in place

~/.claude/skills/fin-core/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/fin-core/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about fin-core

How do I install fin-core in Claude Code?

Run npx skills add AojdevStudio/Finance-Guru --skill fin-core -a claude-code. The skill file is at ~/.claude/skills/fin-core/SKILL.md.

What does fin-core do?

It loads Finance Guru configuration, the user profile and system context when a session begins. It also defines the financial agent workflow and how to run the calculator CLIs.

Should I sync the portfolio before asking for a balance?

Yes. Run portfolio-syncing before quoting a position or balance. Portfolio data syncs from SnapTrade, while bank and card activity comes from SimpleFIN.

Similar skills

All skills for Finance and business →

From the same set2

Project sponsors

Companies that keep this analytics open