Agent skill

Transaction Syncing

by AojdevStudio in AojdevStudio/Finance-Guru

Refresh investment activities and card/bank expenses into familyoffice.db, then review spending.

Custom licenceAuto-check: notes

Install Transaction Syncing

skills CLI
$ npx skills add AojdevStudio/Finance-Guru --skill transaction-syncing -a claude-code

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

GitHub CLI
$ gh skill install AojdevStudio/Finance-Guru transaction-syncing --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/TransactionSyncing .claude/skills/transaction-syncing && 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
transaction-syncing
GitHub stars
322
Token cost
~3.5k tokens
SKILL.md length
1,325 words
Files
3
Skills in repo
18
Repo updated
First seen
Licence
Custom licence

At a glance

Refresh investment activities and card/bank expenses into familyoffice.db, then review spending.

  • User mentions sync transactions
  • SKILL.md covers Step 0: Refresh (sync-first,…, ⚠️ The two feeds do not run at…, Direction and sign and ⚠️ Household spending lives in…, plus 8 more sections
  • Calls uv, sqlite3 and bun
  • Transaction history

What it does

Transaction Syncing is an agent skill from AojdevStudio/Finance-Guru. Refresh investment activities and card/bank expenses into familyoffice.db, then review spending. Investment activities come from the DB transactions table (SnapTrade); debit-card and bank spending comes from the DB banktransactions table (SimpleFIN), auto-categorized. Sync-first so nothing is stale. USE WHEN user mentions "sync transactions", "transaction history", "expense tracker", "categorize spending", OR "update expenses".

Its SKILL.md is about 3.5k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files (for example `CategoryRules.md` and `workflows/IngestTransactions.md`).

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

  • User mentions sync transactions
  • Transaction history
  • Expense tracker
  • Categorize spending

Example prompts

  • “sync transactions”
  • “transaction history”
  • “expense tracker”
  • “/transaction-syncing”

Requirements

  • Python 3

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

    Shell commands in SKILL.md call:

    • uv
    • sqlite3
    • bun

    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

Transaction Syncing loads about 3.5k tokens when it runs. Until then it costs about 113 tokens; SKILL.md has 1,325 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:304
    ATABASE_URL` is set in the project-root `.env`
  • NoteMentions a .env fileSKILL.md:305
    SS_URL` is set in **`apps/simplefin-sync/.env`**, not the
  • NoteMentions a .env fileSKILL.md:307
    ken is read by the Bun app from its own `.env`.
  • NoteMentions a .env fileSKILL.md:308
    Checking the root `.env` for it produces a false "MISSING" (hit 2026-08-04).

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 1,325 words (~3,469 tokens).

“Refresh financial activity into family_office.db: investment activities (transactions table) and card/bank spending (bank_transactions table), auto-categorized for budget review.”

— opening of SKILL.md by AojdevStudio, Custom licence
name
transaction-syncing

Read the full SKILL.md on GitHub

Files

SKILL.md and 2 other files in .claude/skills/TransactionSyncing of AojdevStudio/Finance-Guru.

  • SKILL.md
  • CategoryRules.md
  • workflows/IngestTransactions.md

Open the folder on GitHubat commit a81bcd7

Compare with similar skills

Transaction Syncing 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.

Transaction Syncing compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Transaction Syncing this skillAojdevStudio/Finance-Guru322—~3.5kAutomated safety check: NotesCustom licence
Open Banking Iodavila7/claude-code-templates32k—~472Automated safety check: PassMIT
React Syncvercel/next.js143k—~486Automated safety check: PassMIT
gbrain Syncgarrytan/gstack136k—~15kAutomated safety check: NotesMIT
Model Bank Metadatalobehub/lobehub83k—~2kAutomated safety check: PassCustom licence
Expense Accountingsickn33/agentic-awesome-skills47k1 repos~6.5kAutomated safety check: PassMIT

Similar skills

  • Open Banking Io

    davila7/claude-code-templates

    Read bank account balances and transactions from EU/UK banks via the open-banking.io PSD2 API.

    32k GitHub stars~472 tokensUpdated today
    Auto-check passed
  • React Sync

    vercel/next.js

    Official

    Build local React changes in the bundle variants consumed by Next.js, sync them into a local Next.js checkout, and test the resulting integration.

    143k GitHub stars~486 tokensUpdated today
    Auto-check passed
  • gbrain Sync

    garrytan/gstack

    Re-indexes a repository into gbrain and refreshes the agent search guidance in CLAUDE.md, safe to run again whenever search results look stale.

    136k GitHub stars~15k tokensUpdated today
    Agent WorkflowsAuto-check: notes
  • Model Bank Metadata

    lobehub/lobehub

    Fills and maintains the knowledgeCutoff, family and generation fields on model cards in LobeHub's model bank, from a single new model up to repo-wide backfills.

    83k GitHub stars~2k tokensUpdated today
    AI & LLM EngineeringAuto-check passed
  • Expense Accounting

    sickn33/agentic-awesome-skills

    Expense accounting register: expense number and date, payee with PAN and VAT, bill reference, document type, amount with VAT, ledger account, approver and status.

    47k GitHub starsUsed in 1 repo~6.5k tokens
    Business, Finance & HRAuto-check passed
  • Index Refresh

    paperclipai/paperclip

    A skill your agent uses when an LLM Wiki operation issue requests an index refresh.

    99k GitHub stars~994 tokensUpdated today
    Knowledge ManagementAuto-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 today
    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 today
    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 today
    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 today
    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 today
    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 today
    Auto-check passed

Questions about Transaction Syncing

What does Transaction Syncing do?

Refresh investment activities and card/bank expenses into familyoffice.db, then review spending. Transaction Syncing is an agent skill from AojdevStudio/Finance-Guru.db, then review spending.

When should I use Transaction Syncing?

Transaction Syncing fits situations like: user mentions sync transactions; transaction history; expense tracker; categorize spending.

How do I install Transaction Syncing in Claude Code?

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

How do I install Transaction Syncing in Codex?

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

Can I use Transaction Syncing 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 transaction-syncing -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/transaction-syncing, .gemini/skills/transaction-syncing, .github/skills/transaction-syncing and .opencode/skills/transaction-syncing in your project.

What does Transaction Syncing need to run?

Going by SKILL.md and its folder, Transaction Syncing needs the command-line tools its instructions call (uv, sqlite3 and bun). Our summary lists: Python 3.

Does Transaction Syncing 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 Transaction Syncing safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Transaction Syncing use?

Transaction Syncing 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 Transaction Syncing use?

About 3.5k tokens (SKILL.md is roughly 14k 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 Transaction Syncing?

Skills that share tags, products or a category with Transaction Syncing: Open Banking Io (davila7/claude-code-templates, 32k stars), React Sync (vercel/next.js, 143k stars), gbrain Sync (garrytan/gstack, 136k stars) and Model Bank Metadata (lobehub/lobehub, 83k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Transaction Syncing?

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.