Agent skill

Fin Guru Output Contract

by AojdevStudio in 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.

Custom licenceAuto-check passedDocuments & Office

Install Fin Guru Output Contract

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

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

GitHub CLI
$ gh skill install AojdevStudio/Finance-Guru fin-guru-output-contract --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-output-contract .claude/skills/fin-guru-output-contract && 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-output-contract
GitHub stars
322
Token cost
~529 tokens
SKILL.md length
253 words
Files
1
Skills in repo
18
Repo updated
First seen
Licence
Custom licence

At a glance

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.

  • Works in 6 steps: Bottom line. One or two sentences that… → Numbers. A table with the columns… → Assumptions and gaps. The inputs you… → …
  • You write an analysis
  • SKILL.md covers Fail closed and When the answer becomes a file
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Fin Guru Output Contract is an agent skill from 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. Use when you write an analysis, a review, a strategy, a lesson, an onboarding update, or a merged answer. Not for filling a document template (use fin-guru-create-doc) or running the calculators (use fin-guru-quant-analysis).

Its SKILL.md is about 530 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 Documents & Office. 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

  • You write an analysis
  • An onboarding update
  • A merged answer

Example prompts

  • “/fin-guru-output-contract”

Workflow steps

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

  1. Bottom line. One or two sentences that answer the question asked.
  2. Numbers. A table with the columns Metric, Value, and Source command. Copy each value from a command you ran in this session. Pass --output…
  3. Assumptions and gaps. The inputs you assumed, the data that was missing or stale, and what each gap changes in the answer.
  4. Confidence. High, medium, or low, with the reason.
  5. Evidence. The commands you ran, one per line, so the owner can run them again. Then each source you cited, with its publisher, date, and…
  6. Disclaimer. Educational only, not investment advice, consult a licensed professional, the risk disclosure, the date stamp, and the data…

What it can do on your machine

Read from SKILL.md and the folder at commit a81bcd7. 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

    No scripts in the folder and no shell commands in SKILL.md.

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

  • Network

    No URLs in SKILL.md.

    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 Output Contract loads about 529 tokens when it runs. Until then it costs about 108 tokens; SKILL.md has 253 words of instructions outside code blocks.

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

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 253 words (~529 tokens).

“Every answer from an analysis skill or specialist has these six parts, in this order. A skill or agent may add a named section after Numbers, such as an implementation plan. Role-specific rules follow this contract.”

— opening of SKILL.md by AojdevStudio, Custom licence
name
fin-guru-output-contract

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .claude/skills/fin-guru-output-contract of AojdevStudio/Finance-Guru.

Open the folder on GitHubat commit a81bcd7

Compare with similar skills

Fin Guru Output Contract 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 Output Contract compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Fin Guru Output Contract this skillAojdevStudio/Finance-Guru322—~529Automated safety check: PassCustom licence
Markdown Article FormatterJimLiu/baoyu-skills26k6 repos~3.5kAutomated safety check: PassMIT
MarkitdownImCa0/just-laws78214 repos~3.2kAutomated safety check: NotesMIT
Obsidian MarkdownAtmosphere/atmosphere3.8k20 repos~1.3kAutomated safety check: PassApache-2.0
DOCXrvdbreemen/OTGW-firmware20733 repos~4.3kAutomated safety check: PassProprietary
Gzh Designisjiamu/gzh-design-skill3.9k1 repos~2.2kAutomated safety check: PassAGPL-3.0

Similar skills

  • Markdown Article Formatter

    JimLiu/baoyu-skills

    Reformats plain text or Markdown articles with frontmatter, a title, a summary, headings, bold, lists and code blocks, and saves a separate formatted copy.

    26k GitHub starsUsed in 6 repos~3.5k tokens
    Documents & OfficeAuto-check passed
  • Markitdown

    ImCa0/just-laws

    Convert files and office documents to Markdown. An agent skill from ImCa0/just-laws.

    782 GitHub starsUsed in 14 repos~3.2k tokens
    Documents & OfficeAuto-check: notes
  • Obsidian Markdown

    Atmosphere/atmosphere

    Create and edit Obsidian Flavored Markdown with wikilinks, embeds, callouts, properties, and other Obsidian-specific syntax.

    3.8k GitHub starsUsed in 20 repos~1.3k tokens
    Documents & OfficeAuto-check passed
  • DOCX

    rvdbreemen/OTGW-firmware

    A skill your agent uses whenever the user wants to create, read, edit, or manipulate Word documents (.docx files).

    207 GitHub starsUsed in 33 repos~4.3k tokens
    Documents & OfficeAuto-check passed
  • Gzh Design

    isjiamu/gzh-design-skill

    微信公众号文章排版引擎,将 Markdown 转换为可直接粘贴到公众号编辑器的 HTML。主题风格从 references/theme-index.md 注册的自定义主题库中选取,自动章节编号、关键词下划线标记、引言卡片、目录导航、代码块、图片/GIF、作者签名。支持 Markdown / Word(.docx) / PDF / 纯文本输入(非 Markdown…

    3.9k GitHub starsUsed in 1 repo~2.2k tokens
    Documents & OfficeAuto-check passed
  • Reads, creates and edits Word .docx files with python-docx, and drops to raw OOXML for tracked changes, comments and byte-exact edits.

    41k GitHub stars~2.5k tokensUpdated yesterday
    Documents & OfficeAuto-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 Quant Analysis

    AojdevStudio/Finance-Guru

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

    322 GitHub stars~838 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 Output Contract

What does Fin Guru Output Contract do?

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. Fin Guru Output Contract is an agent skill from 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.

When should I use Fin Guru Output Contract?

Fin Guru Output Contract fits situations like: you write an analysis; an onboarding update; A merged answer.

How do I install Fin Guru Output Contract in Claude Code?

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

How do I install Fin Guru Output Contract in Codex?

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

Can I use Fin Guru Output Contract 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-output-contract -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-output-contract, .gemini/skills/fin-guru-output-contract, .github/skills/fin-guru-output-contract and .opencode/skills/fin-guru-output-contract in your project.

What does Fin Guru Output Contract need to run?

SKILL.md names no scripts, command-line tools or credentials: Fin Guru Output Contract is instructions for the agent only.

Does Fin Guru Output Contract access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Fin Guru Output Contract 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 Output Contract use?

Fin Guru Output Contract 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 Output Contract use?

About 529 tokens (SKILL.md is roughly 2.1k 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 Output Contract?

Skills that share tags, products or a category with Fin Guru Output Contract: Markdown Article Formatter (JimLiu/baoyu-skills, 26k stars), Markitdown (ImCa0/just-laws, 782 stars), Obsidian Markdown (Atmosphere/atmosphere, 3.8k stars) and DOCX (rvdbreemen/OTGW-firmware, 207 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Fin Guru Output Contract?

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