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
npx skills add AojdevStudio/Finance-Guru --skill fin-core -a claude-codeWhat 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
datebefore analysing my portfolio. - Use
src.analysis.total_return_clito calculate portfolio returns and show the result as JSON. - Run
portfolio-syncingbefore quoting my current balance.
How to install fin-core
1Skills CLI (Vercel)
npx skills add AojdevStudio/Finance-Guru --skill fin-core -a claude-code2Manually: put the files in place
~/.claude/skills/fin-core/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/fin-core/
1Skills CLI (Vercel)
npx skills add AojdevStudio/Finance-Guru --skill fin-core -a codex2Manually: put the files in place
.agents/skills/fin-core/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add AojdevStudio/Finance-Guru --skill fin-core -a cursor2Manually: put the files in place
.cursor/skills/fin-core/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install AojdevStudio/Finance-Guru .claude/skills/fin-core2Manually: put the files in place
.github/skills/fin-core/SKILL.md1Skills CLI (Vercel)
npx skills add AojdevStudio/Finance-Guru --skill fin-core -a gemini-cli2Platform CLI
gemini skills install https://github.com/AojdevStudio/Finance-Guru --path .claude/skills/fin-coreManually: put the files in place
.devin/skills/fin-core/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add AojdevStudio/Finance-Guru --skill fin-core -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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.