Agent skill

Fin Guru Quant Analysis

by AojdevStudio in AojdevStudio/Finance-Guru

Quantitative analysis of tickers or the portfolio through the engine's calculators.

Custom licenceAuto-check passedBusiness, Finance & HR

Install Fin Guru Quant Analysis

skills CLI
$ npx skills add AojdevStudio/Finance-Guru --skill fin-guru-quant-analysis -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install AojdevStudio/Finance-Guru fin-guru-quant-analysis --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/AojdevStudio/Finance-Guru.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/fin-guru-quant-analysis .claude/skills/fin-guru-quant-analysis && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
fin-guru-quant-analysis
GitHub stars
322
Token cost
~838 tokens
SKILL.md length
237 words
Files
1
Skills in repo
18
Repo updated
First seen
Licence
Custom licence

At a glance

Quantitative analysis of tickers or the portfolio through the engine's calculators.

  • Works in 9 steps: Plan — Define statistical modeling… → Data Validation — Use… → Risk Metrics — Use risk_metrics_cli.py… → …
  • The owner asks how risky a holding is
  • SKILL.md covers Capability probe, Workflow Steps, CLI Commands and Output, plus 1 more section
  • Calls uv

What it does

Fin Guru Quant Analysis is an agent skill from AojdevStudio/Finance-Guru. Quantitative analysis of tickers or the portfolio through the engine's calculators. Covers risk metrics (VaR, CVaR, Sharpe, Sortino, drawdown, beta), momentum, volatility regime, correlation, factor models, backtests, and portfolio optimization. Use when the owner asks how risky a holding is, wants risk or return statistics, compares tickers on risk, asks for an optimal allocation, or wants a strategy backtested. Not for news and catalysts (use fin-guru-research) or buy and sell decisions (use fin-guru-strategize).

Its SKILL.md is about 840 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Business, Finance & HR, covering Trading and backtesting and Statistics. The repository describes itself as: Self-hosted family office engine: typed Python calculators, a private SQLite ledger, and specialist agents for Claude Code and Codex. Agents propose. Typed code computes.

When your agent uses it

  • The owner asks how risky a holding is
  • Return statistics
  • Compares tickers on risk
  • Asks for an optimal allocation

Example prompts

  • “/fin-guru-quant-analysis”

Requirements

  • Python 3

Workflow steps

9 steps, taken from the first numbered list in SKILL.md.

  1. Plan — Define statistical modeling objectives, metrics, and assumptions
  2. Data Validation — Use data_validator_cli.py for statistical validity (outliers, gaps, splits)
  3. Risk Metrics — Use risk_metrics_cli.py for VaR/CVaR/Sharpe/Sortino/Drawdown (minimum 90 days)
  4. Momentum Analysis — Use momentum_cli.py for confluence analysis
  5. Volatility Metrics — Use volatility_cli.py for regime analysis
  6. Correlation Analysis — Use correlation_cli.py for diversification and covariance matrices
  7. Factor Analysis — Use factors_cli.py for Fama-French 3-factor, Carhart 4-factor models
  8. Strategy Validation — Use backtester_cli.py with transaction costs and realistic slippage
  9. Portfolio Optimization — Use optimizer_cli.py for mean-variance, risk parity, max Sharpe, Black-Litterman

What it can do on your machine

Read from SKILL.md and the folder at commit 90c235e. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • uv

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use uv, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Fin Guru Quant Analysis loads about 838 tokens when it runs. Until then it costs about 136 tokens; SKILL.md has 237 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~136
When it runs · the whole SKILL.md, loaded when a task matches
~838

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 237 words (~838 tokens).

“Execute structured quantitative analysis workflows with statistical validation.”

— opening of SKILL.md by AojdevStudio, Custom licence
name
fin-guru-quant-analysis

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .claude/skills/fin-guru-quant-analysis of AojdevStudio/Finance-Guru.

Open the folder on GitHubat commit 90c235e

Compare with similar skills

Fin Guru Quant Analysis next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Fin Guru Quant Analysis compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Fin Guru Quant Analysis this skillAojdevStudio/Finance-Guru322—~838Automated safety check: PassCustom licence
Comps Analysisginlix-ai/LangAlpha1.8k—~6.4kAutomated safety check: PassApache-2.0
Alpha Zoo Factor LibrariesHKUDS/Vibe-Trading35k—~950Automated safety check: PassMIT
Factor Research with IC and IRHKUDS/Vibe-Trading35k—~2.1kAutomated safety check: PassMIT
Risk Measurement and Stress TestingHKUDS/Vibe-Trading35k—~3.8kAutomated safety check: PassMIT
Correlation and Cointegration AnalysisHKUDS/Vibe-Trading35k—~10kAutomated safety check: PassMIT

Similar skills

  • Comps Analysis

    ginlix-ai/LangAlpha

    Comparable company analysis: peer set, operating metrics, valuation multiples, statistics and an implied value.

    1.8k GitHub stars~6.4k tokensUpdated today
    Business, Finance & HRAuto-check passed
  • Alpha Zoo Factor Libraries

    HKUDS/Vibe-Trading

    Browses prebuilt cross-sectional factor libraries (Kakushadze 101, GTJA 191, Qlib 158, Fama-French and Carhart) and benchmarks whole libraries with IC and IR over a stock universe.

    35k GitHub stars~950 tokensUpdated yesterday
    Business, Finance & HRAuto-check passed
  • Evaluates factors across many instruments with IC and IR statistics and quantile backtests, then guides screening and weighting; uses the factor_analysis tool with factor and return CSVs.

    35k GitHub stars~2.1k tokensUpdated yesterday
    Business, Finance & HRAuto-check passed
  • Measures portfolio and backtest risk with VaR, CVaR, maximum drawdown, Monte Carlo simulation, tail modeling and stress tests, using one tested risk module.

    35k GitHub stars~3.8k tokensUpdated yesterday
    Business, Finance & HRAuto-check passed
  • Finds co-moving assets and tests them for cointegration, with workflows for correlation studies, sector clustering, hedge ratios and pair-trading signals.

    35k GitHub stars~10k tokensUpdated yesterday
    Business, Finance & HRAuto-check passed
  • Polymarket

    machina-sports/sports-skills

    Polymarket sports prediction markets — read-only live odds, prices, order books, events, series, and market search.

    242 GitHub stars~1.9k tokensUpdated 2 days ago
    Data & AnalyticsAuto-check passed

More from AojdevStudio/Finance-Guru

All 18 skills in this repo
  • Compliance Scan

    AojdevStudio/Finance-Guru

    Privacy and security compliance scanner for the Finance Guru repo.

    322 GitHub stars~2.6k tokensUpdated yesterday
    Auto-check: notes
  • Dividend Tracking

    AojdevStudio/Finance-Guru

    Refresh the local DB, then read and analyze DIVIDEND rows from familyoffice.db for Layer 2 income tracking.

    322 GitHub stars~1.2k tokensUpdated yesterday
    Auto-check passed
  • Fin Guru Compliance Review

    AojdevStudio/Finance-Guru

    Compliance review of a Finance Guru deliverable or a proposed position.

    322 GitHub stars~801 tokensUpdated yesterday
    Auto-check passed
  • Fin Guru Output Contract

    AojdevStudio/Finance-Guru

    The six-part shape of every Finance Guru analysis answer: bottom line, a numbers table that names the source command, assumptions and gaps, confidence, evidence, and the disclaimer.

    322 GitHub stars~529 tokensUpdated yesterday
    Auto-check passed
  • Fin Guru Strategize

    AojdevStudio/Finance-Guru

    Turn research and quantitative results into a portfolio strategy with allocation changes, entry timing, position sizing, margin and dividend tactics, and an implementation plan with triggers.

    322 GitHub stars~825 tokensUpdated yesterday
    Auto-check passed
  • Finance Report

    AojdevStudio/Finance-Guru

    Generate institutional-quality PDF analysis reports for stocks and ETFs.

    322 GitHub stars~1.7k tokensUpdated yesterday
    Auto-check passed

Questions about Fin Guru Quant Analysis

What does Fin Guru Quant Analysis do?

Quantitative analysis of tickers or the portfolio through the engine's calculators. Fin Guru Quant Analysis is an agent skill from AojdevStudio/Finance-Guru. Quantitative analysis of tickers or the portfolio through the engine's calculators.

When should I use Fin Guru Quant Analysis?

Fin Guru Quant Analysis fits situations like: the owner asks how risky a holding is; return statistics; compares tickers on risk; asks for an optimal allocation.

How do I install Fin Guru Quant Analysis in Claude Code?

Run `npx skills add AojdevStudio/Finance-Guru --skill fin-guru-quant-analysis -a claude-code`. Or copy the skill folder (.claude/skills/fin-guru-quant-analysis in AojdevStudio/Finance-Guru) into .claude/skills/fin-guru-quant-analysis in your project. Claude Code loads it when a task matches its description.

How do I install Fin Guru Quant Analysis in Codex?

Run `npx skills add AojdevStudio/Finance-Guru --skill fin-guru-quant-analysis -a codex`. Or copy the skill folder (.claude/skills/fin-guru-quant-analysis in AojdevStudio/Finance-Guru) into .agents/skills/fin-guru-quant-analysis in your project. Codex loads it when a task matches its description.

Can I use Fin Guru Quant Analysis in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add AojdevStudio/Finance-Guru --skill fin-guru-quant-analysis -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/fin-guru-quant-analysis, .gemini/skills/fin-guru-quant-analysis, .github/skills/fin-guru-quant-analysis and .opencode/skills/fin-guru-quant-analysis in your project.

What does Fin Guru Quant Analysis need to run?

Going by SKILL.md and its folder, Fin Guru Quant Analysis needs the command-line tools its instructions call (uv). Our summary lists: Python 3.

Does Fin Guru Quant Analysis access the network?

SKILL.md contains no URLs. Its commands use uv, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Fin Guru Quant Analysis safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Fin Guru Quant Analysis use?

Fin Guru Quant Analysis has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Fin Guru Quant Analysis use?

About 838 tokens (SKILL.md is roughly 3.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Fin Guru Quant Analysis?

Skills that share tags, products or a category with Fin Guru Quant Analysis: Comps Analysis (ginlix-ai/LangAlpha, 1.8k stars), Alpha Zoo Factor Libraries (HKUDS/Vibe-Trading, 35k stars), Factor Research with IC and IR (HKUDS/Vibe-Trading, 35k stars) and Risk Measurement and Stress Testing (HKUDS/Vibe-Trading, 35k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Fin Guru Quant Analysis?

AojdevStudio (a GitHub user) maintains it in AojdevStudio/Finance-Guru, which has 322 GitHub stars. The repository holds 18 skills in this directory. The repository was last updated on October 6, 2026.

Source: AojdevStudio/Finance-Guru on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.