Official agent skill

Financial Insights

by stripe in stripe/link-cli

Reads a user's Link transactions, balances, financial sources, and precomputed insights to answer questions about spending, available funds, connected accounts, and account activity.

OfficialMITAuto-check passed

Install Financial Insights

skills CLI
$ npx skills add stripe/link-cli --skill financial-insights -a claude-code

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

GitHub CLI
$ gh skill install stripe/link-cli financial-insights --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/stripe/link-cli.git skills-src && mkdir -p .claude/skills && cp -r skills-src/packages/integrations/eve/extension/skills/financial-insights .claude/skills/financial-insights && 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
financial-insights
GitHub stars
844
Token cost
~2.5k tokens
SKILL.md length
1,245 words
Files
1
Skills in repo
7
Repo updated
First seen
Licence
MIT

At a glance

Reads a user's Link transactions, balances, financial sources, and precomputed insights to answer questions about spending, available funds, connected accounts, and account activity.

  • Works in 2 steps: If you do not already know the… → Call list_insights with only the IDs the…
  • Transaction history
  • SKILL.md covers Authentication and access, Choose the right tools, Amounts and sources and Transactions, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Financial Insights is an agent skill from stripe/link-cli, published by the product's own GitHub organization. Reads a user's Link transactions, balances, financial sources, and precomputed insights to answer questions about spending, available funds, connected accounts, and account activity. Use for balance checks, transaction history, spending summaries, shopping patterns, and source capabilities.

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

The repository describes itself as: Let your agents spend on your behalf. Your payment credentials are never exposed. You approve every purchase. The licence is MIT.

When your agent uses it

  • Transaction history
  • Spending summaries
  • Shopping patterns
  • Source capabilities

Example prompts

  • “Use the financial-insights skill to read a user's Link transactions, balances, financial sources, and precomputed insights to answer questions about…”
  • “/financial-insights”

Workflow steps

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

  1. If you do not already know the applicable insight ID or its access
  2. Call list_insights with only the IDs the task needs, for example

What it can do on your machine

Read from SKILL.md and the folder at commit 52dfdb3. 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 (its code samples are json).

    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

Financial Insights loads about 2.5k tokens when it runs. Until then it costs about 78 tokens; SKILL.md has 1,245 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~78
When it runs · the whole SKILL.md, loaded when a task matches
~2.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 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

The full file from stripe/link-cli at commit 52dfdb3, republished under its MIT licence (© stripe). 1,245 words, ~2,509 tokens.

Download SKILL.mdSave it as .claude/skills/financial-insights/SKILL.md (or your agent's skills folder).
name
financial-insights
description
Reads a user's Link transactions, balances, financial sources, and precomputed insights to answer questions about spending, available funds, connected accounts, and account activity. Use for balance checks, transaction history, spending summaries, shopping patterns, and source capabilities.
license
MIT
metadata.author
stripe
metadata.url
link.com/agents

Financial insights

Use this skill for read-only questions about the user's Link financial data. Call the extension's native tools with their discovered mount prefix, such as link__list_transactions. Inputs and results are structured objects; use the tool schemas for parameter names and constraints.

For purchases or payment credentials, load the mounted create-payment-credential skill instead.

Authentication and access

The application configures the wallet and authorization provider. If Eve asks the user to connect Link, let that authorization finish before continuing. Do not ask for tokens in chat. If access is denied or a tool reports missing permissions, explain what data could not be retrieved and stop. Do not repeatedly retry the same denied operation.

Choose the right tools

Use the smallest set that answers the question.

User asks aboutTool
Purchases, merchants, spend, income, deposits, recurring paymentslist_transactions
Current balance, available funds, cash positionlist_balances
Connected accounts, source details, data capabilitieslist_sources
Precomputed signals, such as top brands per shopping categorylist_available_insight_types, then list_insights

For restaurant spending last month, retrieve transactions for that period. For an account balance, retrieve balances. For connected accounts, retrieve sources. Combine tools only when the question requires it, such as joining source names to balances.

Amounts and sources

Financial-data amounts are integers in the currency's smallest unit. Format using the currency's ISO 4217 minor-unit exponent; do not always divide by 100. For example, 152340 represents $1,523.40 USD.

Only transaction amount uses negative values for money leaving the account and positive values for money entering. Interpret balance fields according to their balance type. Keep currencies separate when aggregating.

A source is an account connected to Link. Use its id to join records exposing source_id. Do not guess which account owns a transaction whose source_id is null. Sources can describe banks, cards, and other account types.

Transactions

Call list_transactions with the relevant filters, for example:

json
{
  "start_date": "2025-01-01",
  "end_date": "2025-01-31",
  "category": "groceries",
  "origin": "external_connection",
  "sources": ["<source_id>"],
  "limit": 100
}

Choose dates and filters from the user's question; omit unnecessary fields.

InputMeaning
start_date, end_dateInclusive dates in YYYY-MM-DD format
categoryCategory filter
originlink or external_connection
sourcesArray of source IDs

Useful response fields:

FieldInterpretation
amountNegative for outflows; positive for inflows
originLink-native or from an external connection
categoryMay be null when unclassified
statusAPI-provided status; do not assume a closed set of values or interpret/filter an unfamiliar status without knowing its meaning

Distinguish spending from credits, deposits, and refunds. Explain whether a reported total is gross spending or net movement. Group by merchant, category, source, currency, or period only when relevant. Label summaries based on a limited window or partial pagination accordingly.

Balances

Call list_balances with {} for an initial page, or filter by sources:

json
{ "sources": ["<source_id>"], "limit": 100 }
FieldInterpretation
typecash or credit; determines which sub-object is present
currentBalance before pending transactions; not necessarily available funds
cash.availableCurrency-to-amount mapping for available cash, accounting for pending activity
credit.usedCurrency-to-amount mapping for credit used
as_ofLast update time; the data may be stale

Use current for a general balance question and cash.available when the user asks about available cash. Do not present credit used as available funds. Preserve currencies, summarize by source, and mention relevant freshness limits.

Sources

Call list_sources with {} or pagination arguments.

FieldMeaning
idSource identifier used by balances and transactions
name, typeDisplay name and account type
capabilitiesData capabilities with status values, such as balances.status
external_connection.statusConnection status at the external institution
granted_actionsActions the user has granted for this source

Use capabilities and granted actions to understand what data is accessible. Summarize institution, account type, and connection status when relevant. Avoid exposing full account numbers, tokens, or unnecessary identifiers.

Show full SKILL.md (653 more words)Show less

Insights

Insights are signals Link computes ahead of time, such as top_brand_by_transaction_count_per_category_t180d (top brands per shopping category over the last 180 days, by transaction count). New types can appear without an extension release.

  1. If you do not already know the applicable insight ID or its access requirement, call list_available_insight_types with {}. Each type has an id, a description, and, when the current grant needs more access, an authorization_remediation with the scope or authorization_details required.
  2. Call list_insights with only the IDs the task needs, for example { "insights": ["top_brand_by_transaction_count_per_category_t180d"] }. Omit insights only when the user asks for an overview of all insights.

Both tools accept limit (1 to 100, default 10) and starting_after (the last returned insight id); they do not accept ending_before.

Handle each result by status and error_code:

ResultMeaningWhat to do
readyComputed; data holds { label, value } entriesUse it and mention as_of when freshness matters
pendingNot computed yetTreat as unavailable for this answer. Do not call again in a loop
no_data with error_code: missing_permissionsThe grant lacks accessExplain the access listed in authorization_remediation (below)
no_data with error_code: internal_errorLink could not compute itSay the insight is temporarily unavailable
no_data with no error_codeNo qualifying activity in the authorized dataSay no qualifying activity was found for the access granted

Never report missing permissions, pending, or failed results as zero activity.

For missing_permissions, tell the user which access is missing (for example, transaction access for a Link payment detail) and why. Access comes from the application's authorization provider, never from chat. If Eve presents an authorization challenge, let the user complete it, then call list_insights once more for the same IDs. If authorization is declined or access is still missing, continue without the insight and say so. Request nothing beyond the supplied remediation.

Values are tagged by type. number_of_items values carry number_of_items.label, naming what was counted (such as the brand), and number_of_items.count; the entry label names the category, for example "Top brand from Clothing and accessories shopping category" with J.crew and a count of 10. The number_of_items.label may be absent. For an unfamiliar type, describe only what its fields make clear, or omit it.

Insights describe observed history. Explicit user instructions and stated preferences always override them. Describe a pattern as observed, for example "your recent transactions point to J.crew for clothing", not as a preference the user declared. Results cover only authorized sources; mention that coverage may be incomplete.

Pagination

list_transactions, list_balances, and list_sources accept:

InputMeaning
limitResults per page, from 1 to 100
starting_afterCursor for the next page
ending_beforeCursor for reverse navigation

Responses contain data and may contain has_more. When has_more is true, derive starting_after from the last returned item:

ToolCursor field
list_transactionsid
list_balancessource_id
list_sourcesid

For example, continue a transaction query with the same filters and starting_after: "<last_transaction_id>". Change only the cursor across pages. Stop when has_more is false or absent, or when the user's non-exhaustive lookup is satisfied. If more results are reported but the page is empty or lacks a usable cursor, stop and explain that pagination could not continue.

Fully paginate when a complete bounded result is needed, such as a total for a specified month. Do not present a partial page's sum as the complete total.

Answer the question

State the answer first, followed by the relevant period and source. Mention limitations such as missing categories, pending activity, stale balances, partial results, or inaccessible accounts. Summarize rather than dumping raw records or object IDs.

If the tools return no matching data, say that no data was available for the requested filters and access. That does not prove no activity occurred or that an inaccessible balance is zero. Report uncertain derived insights as uncertain. Mention as_of when stale data could change the answer.

This skill does not move money, initiate payments, or modify sources. Retrieve only relevant financial data and never expose payment credentials.

© stripe, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in packages/integrations/eve/extension/skills/financial-insights of stripe/link-cli.

Open the folder on GitHubat commit 52dfdb3

Compare with similar skills

Financial Insights 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.

Financial Insights compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Financial Insights this skillstripe/link-cli844—~2.5kAutomated safety check: PassMIT
Financial Analystalirezarezvani/claude-skills28k1 repos~1.8kAutomated safety check: PassMIT
External Linksthedaviddias/Front-End-Checklist74k—~773Automated safety check: PassMIT
Financial Data Cross-Validationxbtlin/ai-berkshire17k—~1.4kAutomated safety check: PassMIT
Blocked Linksthedaviddias/Front-End-Checklist74k—~585Automated safety check: PassMIT
Internal Linksthedaviddias/Front-End-Checklist74k—~770Automated safety check: PassMIT

Similar skills

  • Financial Analyst

    alirezarezvani/claude-skills

    Runs financial ratio analysis, DCF valuation, budget variance reports and rolling forecasts from statement data using four bundled Python scripts.

    28k GitHub starsUsed in 1 repo~1.8k tokens
    Business, Finance & HRAuto-check passed
  • External Links

    thedaviddias/Front-End-Checklist

    A skill your agent uses when auditing content pages for citation quality, suggesting authoritative sources to link for factual claims, or reviewing whether a page's external link attributes…

    74k GitHub stars~773 tokensUpdated 4 days ago
    Research & ScienceAuto-check passed
  • A research rule set for pulling company financials from prioritized sources by market and cross-checking every key figure against two independent sources.

    17k GitHub stars~1.4k tokensUpdated 2 days ago
    Business, Finance & HRAuto-check passed
  • Blocked Links

    thedaviddias/Front-End-Checklist

    A skill your agent uses when reviewing HTML source and JavaScript for links or resource URLs pointing to domains listed in common adblocker filter lists.

    74k GitHub stars~585 tokensUpdated 4 days ago
    Auto-check passed
  • Internal Links

    thedaviddias/Front-End-Checklist

    A skill your agent uses when auditing a site's internal link structure, identifying pages that need more incoming links, generating contextual linking opportunities between related content, or…

    74k GitHub stars~770 tokensUpdated 4 days ago
    Marketing & SEOAuto-check passed
  • Invalid Links

    thedaviddias/Front-End-Checklist

    A skill your agent uses when auditing a page's link elements for crawlability, reviewing JavaScript-heavy SPAs where navigation may not use <a href tags, or checking that dynamically generated links…

    74k GitHub stars~806 tokensUpdated 4 days ago
    Marketing & SEOAuto-check passed

More from stripe/link-cli

  • Financial Insights

    stripe/link-cli

    Official

    Reads a user's Link financial data — transactions, balances, and wallet sources — so agents can answer questions about spending and available source capabilities.

    844 GitHub starsUsed in 1 repo~4.5k tokens
    Auto-check passed
  • Official

    Creates and manages Link spend requests and retrieves approved one-time-use payment credentials.

    844 GitHub stars~2.2k tokensUpdated today
    Auto-check passed
  • Official

    Gets secure, one-time-use payment credentials (cards, tokens) from a Link wallet so agents can complete purchases on behalf of users.

    844 GitHub starsUsed in 1 repo~8.9k tokens
    Auto-check passed
  • Check Link Wallet

    stripe/link-cli

    Official

    Reads the connected Link account, the cards and bank accounts saved in its wallet, its saved shipping addresses, and the status of existing spend requests.

    844 GitHub stars~683 tokensUpdated today
    Auto-check passed
  • Complete Link Purchase

    stripe/link-cli

    Official

    Buys something on a merchant site with a Link wallet by asking the user to authorize a one-time virtual card, then retrieving the credential and entering it at checkout.

    844 GitHub stars~2k tokensUpdated today
    Auto-check passed
  • Use Link Identity

    stripe/link-cli

    Official

    Use Link CLI's identity commands when a service requests a Link Agent Attestation Token (AAT) or signed user claims such as email.

    844 GitHub stars~1.5k tokensUpdated today
    Auto-check passed

Questions about Financial Insights

What does Financial Insights do?

Reads a user's Link transactions, balances, financial sources, and precomputed insights to answer questions about spending, available funds, connected accounts, and account activity. Financial Insights is an agent skill from stripe/link-cli, published by the product's own GitHub organization. Reads a user's Link transactions, balances, financial sources, and precomputed insights to answer questions about spending, available funds, connected accounts, and account activity.

When should I use Financial Insights?

Financial Insights fits situations like: transaction history; spending summaries; shopping patterns; source capabilities.

How do I install Financial Insights in Claude Code?

Run `npx skills add stripe/link-cli --skill financial-insights -a claude-code`. Or copy the skill folder (packages/integrations/eve/extension/skills/financial-insights in stripe/link-cli) into .claude/skills/financial-insights in your project. Claude Code loads it when a task matches its description.

How do I install Financial Insights in Codex?

Run `npx skills add stripe/link-cli --skill financial-insights -a codex`. Or copy the skill folder (packages/integrations/eve/extension/skills/financial-insights in stripe/link-cli) into .agents/skills/financial-insights in your project. Codex loads it when a task matches its description.

Can I use Financial Insights 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 stripe/link-cli --skill financial-insights -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/financial-insights, .gemini/skills/financial-insights, .github/skills/financial-insights and .opencode/skills/financial-insights in your project.

What does Financial Insights need to run?

SKILL.md names no scripts, command-line tools or credentials: Financial Insights is instructions for the agent only.

Does Financial Insights 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 Financial Insights 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 Financial Insights use?

Financial Insights is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Financial Insights use?

About 2.5k tokens (SKILL.md is roughly 10k 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 Financial Insights?

Skills that share tags, products or a category with Financial Insights: Financial Analyst (alirezarezvani/claude-skills, 28k stars), External Links (thedaviddias/Front-End-Checklist, 74k stars), Financial Data Cross-Validation (xbtlin/ai-berkshire, 17k stars) and Blocked Links (thedaviddias/Front-End-Checklist, 74k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Financial Insights?

stripe (a GitHub organization, an official publisher) maintains it in stripe/link-cli, which has 844 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on October 10, 2026.

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