New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Stripe

by magnus919 in magnus919/agent-skills

Read Stripe account state from a terminal or agent: balance, payment intents, and subscriptions — and perform guarded mutations like canceling a subscription — backed by a bundled stripe-cli script…

MITAuto-check passed

Install Stripe

skills CLI
$ npx skills add magnus919/agent-skills --skill stripe -a claude-code

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

GitHub CLI
$ gh skill install magnus919/agent-skills stripe --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/magnus919/agent-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/stripe .claude/skills/stripe && 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
stripe
GitHub stars
115
Token cost
~2.4k tokens
SKILL.md length
1,043 words
Files
7 (incl. scripts, references)
Skills in repo
131
Repo updated
First seen
Licence
MIT

At a glance

Read Stripe account state from a terminal or agent: balance, payment intents, and subscriptions — and perform guarded mutations like canceling a subscription — backed by a bundled stripe-cli script…

  • Works in 5 steps: Read-only first. Balance, payment, and… → Guard every mutation. State-changing… → Respect bounded reads. Stripe paginates… → …
  • An agent needs to answer questions about account balance
  • SKILL.md covers Operating contract, The stripe-cli script, Operating loop and Read surface: balance,…, plus 7 more sections
  • Runs Python scripts from its folder; needs STRIPE_API_KEY

What it does

Stripe is an agent skill from magnus919/agent-skills. Read Stripe account state from a terminal or agent: balance, payment intents, and subscriptions — and perform guarded mutations like canceling a subscription — backed by a bundled stripe-cli script that is read-only first and gates every state-changing command behind a --dry-run/--yes confirmation. Use when an agent needs to answer questions about account balance, recent payments, active subscriptions, or apply a confirmed subscription cancellation. Do not use for building Stripe payments into an application…

Its SKILL.md is about 2.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 10 other files, including scripts and reference files (for example `README.md`, `evals/evals.json` and `references/00-source-index.md`). Compatibility notes: The bundled stripe-cli script runs on Python 3.9+ with only the standard library. --help and the read-only surface (balance, payments, subscriptions) need no…

It works with Stripe. The repository describes itself as: Curated collection of AI agent skills for Hermes and other agent frameworks. The licence is MIT.

When your agent uses it

  • An agent needs to answer questions about account balance
  • Recent payments
  • Active subscriptions
  • Apply a confirmed subscription cancellation

Example prompts

  • “/stripe”

Requirements

  • Python 3
  • A credential in STRIPE_API_KEY
  • Compatibility (from SKILL.md): The bundled stripe-cli script runs on Python 3.9+ with only the standard library. --help and the read-only surface (balance, payments, subscriptions) need no network beyond api.stripe.com; live reads require a Stripe secret or restricted API key with read access and network access to api.stripe.com.

Workflow steps

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

  1. Read-only first. Balance, payment, and subscription queries run freely and never change anything. The bundled stripe-cli script's primary…
  2. Guard every mutation. State-changing operations — canceling a subscription — require an explicit human directive plus --dry-run preview…
  3. Respect bounded reads. Stripe paginates with limit and has_more; never page past what the task needs. stripe-cli --limit caps every listing.
  4. Keep evidence bounded. Quote short IDs, amounts, and statuses; never dump full API keys, customer data, or raw payloads into chat. Amounts…
  5. Treat money data as sensitive. Balances, payments, and subscription details are financial records; quote only what the question needs and…

What it can do on your machine

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

    Ships 1 file in scripts/ (Python), which the agent can run.

    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 these keys or tokens, usually read from environment variables:

    • STRIPE_API_KEY

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

  • Compatibility

    The bundled stripe-cli script runs on Python 3.9+ with only the standard library. --help and the read-only surface (balance, payments, subscriptions) need no network beyond api.stripe.com; live reads require a Stripe secret or restricted API key with read access and network access to api.stripe.com.

    From compatibility in the SKILL.md frontmatter.

Context cost

Stripe loads about 2.4k tokens when it runs, and up to ~4.4k if it reads all its reference files. Until then it costs about 164 tokens; SKILL.md has 1,043 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~164
When it runs · the whole SKILL.md, loaded when a task matches
~2.4k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~4.4k

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); the scripts in this folder are not scanned.

SKILL.md

The full file from magnus919/agent-skills at commit 22b4723, republished under its MIT licence (© magnus919). 1,043 words, ~2,438 tokens.

Download SKILL.mdSave it as .claude/skills/stripe/SKILL.md (or your agent's skills folder). This skill also uses 6 other files; get the full folder from GitHub.
name
stripe
description
Read Stripe account state from a terminal or agent: balance, payment intents, and subscriptions — and perform guarded mutations like canceling a subscription — backed by a bundled stripe-cli script that is read-only first and gates every state-changing command behind a --dry-run/--yes confirmation. Use when an agent needs to answer questions about account balance, recent payments, active subscriptions, or apply a confirmed subscription cancellation. Do not use for building Stripe payments into an application (that is Stripe integration development), managing Stripe dashboard settings, or other payment processors (that is their own tooling).
compatibility
The bundled stripe-cli script runs on Python 3.9+ with only the standard library. --help and the read-only surface (balance, payments, subscriptions) need no network beyond api.stripe.com; live reads require a Stripe secret or restricted API key with read access and network access to api.stripe.com.
license
MIT
metadata.source
https://docs.stripe.com/api
metadata.source_index
references/00-source-index.md
metadata.research_checked
2026-10-06

Stripe Operations

Use this skill to read Stripe account state and, with explicit confirmation, perform guarded mutations: account balance, payment intents, subscriptions, and subscription cancellation. This is a tool skill for the Stripe platform. Building Stripe payments into an application is integration development; this skill owns the everyday agent workflow: answering "what is our balance?", "which payments succeeded?", "what subscriptions are active?", and applying a confirmed cancellation.

Operating contract

  1. Read-only first. Balance, payment, and subscription queries run freely and never change anything. The bundled stripe-cli script's primary surface is these reads.
  2. Guard every mutation. State-changing operations — canceling a subscription — require an explicit human directive plus --dry-run preview and --yes confirmation through stripe-cli. Cancellations are financial actions with billing consequences: confirm the subscription, the timing, and the impact before acting.
  3. Respect bounded reads. Stripe paginates with limit and has_more; never page past what the task needs. stripe-cli --limit caps every listing.
  4. Keep evidence bounded. Quote short IDs, amounts, and statuses; never dump full API keys, customer data, or raw payloads into chat. Amounts are formatted by currency and JSON retains the raw integer and currency for audit.
  5. Treat money data as sensitive. Balances, payments, and subscription details are financial records; quote only what the question needs and never expose full card or customer data.

The stripe-cli script

scripts/stripe-cli is an agent-first, stdlib-only CLI over the Stripe API. It is read-only-first: balance, payments, and subscriptions are the primary surface; the only mutation is guarded.

bash
stripe/scripts/stripe-cli --help                          # no key or network needed
stripe/scripts/stripe-cli --json balance show
stripe/scripts/stripe-cli --json --limit 20 payments list
stripe/scripts/stripe-cli --json --limit 20 subscriptions list
stripe/scripts/stripe-cli --json subscriptions get --id sub_123
stripe/scripts/stripe-cli subscriptions cancel --id sub_123 --dry-run   # preview
stripe/scripts/stripe-cli subscriptions cancel --id sub_123 --yes       # confirmed

Exit codes: 0 success, 1 API error or failed check, 2 usage error. Cancellations are guarded: without --dry-run or --yes the script refuses with exit 1 and never calls the API. Reads are bounded by --limit (default 20, max 100).

Operating loop

  1. Scope the question: is this a read (balance, payments, subscriptions) or a mutation (cancel)? Locate the object with the read surface first.
  2. Read with bounds: balance show for available and pending funds; payments list for recent payment intents; subscriptions list/subscriptions get for active subscriptions and their items.
  3. Triage the answer: map the question to evidence (amounts, statuses, customers, period end dates).
  4. Act with confirmation: only a human directive to change, previewed with --dry-run and confirmed with --yes.
  5. Verify: re-read the subscription and confirm cancel_at_period_end is set (cancellation at period end) — and state that the customer keeps service until that date.

Read surface: balance, payments, subscriptions

  • Balance (GET /balance): available and pending balances per currency. A read-only snapshot of account funds.
  • Payments (GET /payment_intents): recent payment intents with amount, currency, status (succeeded, requires_action, etc.), and customer. Bounded by --limit; has_more tells you whether the cap hid further records.
  • Subscriptions (GET /subscriptions, GET /subscriptions/{id}): active subscriptions with status, customer, period end, and items (price, amount, interval). A read before any cancellation.

Stripe amounts use minor units: ordinary zero-decimal currencies such as JPY display as whole units, while other currencies display two decimals. UGX and ISK retain two-decimal API values for backward compatibility, so an amount of 500 displays as 5.00 UGX or 5.00 ISK. JSON preserves the original integer (amount_minor, or unit_amount_minor for subscription prices) and currency next to the formatted display value. HUF and TWD use two decimals for charge/price records (their whole-unit rule applies to manual payouts). Three-decimal currencies that Stripe does not support for presentment are rejected. See references/01-stripe-read-operations.md for sources and details.

Guarded mutation: subscription cancellation

  • subscriptions cancel --id sub_... --dry-run previews the cancellation; --yes confirms and posts cancel_at_period_end=true — the safe default that schedules cancellation at the period end (customer keeps service until then) rather than canceling immediately.
  • The script verifies Stripe confirmed the change (response cancel_at_period_end: true) before reporting success; a mismatch raises an error and no state change is assumed.
  • Cancellation scheduled at period end is reversible by setting cancel_at_period_end=false before the period ends. Immediate cancellation and refunds are deliberately NOT in this skill's mutation surface — they need a human at the Stripe dashboard or a dedicated integration.
Show full SKILL.md (387 more words)Show less

Access model and credentials

  • Stripe authenticates with secret keys (sk_...) or restricted keys (rk_...). Use a restricted key scoped to read-only (balance:read, payment_intents:read, subscriptions:read) for the read surface; add subscriptions:write only where cancellations are genuinely needed.
  • Keys are live or test (sk_live_/sk_test_). Never point live keys at test data or vice versa; verify the key type before running anything that could touch real charges.
  • Store keys in STRIPE_API_KEY, never in code, chat, or commits. Rotate a leaked key immediately in the Stripe dashboard.

Reference routing

Load whenReference
Sources, refresh procedurereferences/00-source-index.md
Endpoints, pagination, cancellation semantics, errorsreferences/01-stripe-read-operations.md

Included artifacts

  • scripts/stripe-cli: bounded, stdlib-only CLI (balance, payments list, subscriptions list/get, guarded cancel; --json; --limit; mutation gated by --dry-run/--yes).
  • tests/test_stripe_cli.py: 14 deterministic tests against a stub Stripe API, including USD/JPY formatting, special currency rules, raw-unit preservation, and the mutation gate.
  • references/: dated source index + Stripe read-operations reference.
  • evals/evals.json: seven output-quality evaluation cases for agent runs.

Verification boundary

ClaimMinimum evidence
Balance is currentstripe-cli balance show --json returns available and pending per currency
A payment succeededstripe-cli payments list --json shows the intent with status succeeded
A subscription is activestripe-cli subscriptions get --json returns status active and period end
A cancellation was acceptedstripe-cli subscriptions cancel --yes exits 0 and the response has cancel_at_period_end: true
A mutation is safe to runstripe-cli subscriptions cancel --dry-run prints the exact subscription ID

Hard boundaries

  • Never cancel a subscription without a human directive, --dry-run preview, and --yes confirmation — cancellations have billing consequences.
  • The mutation surface is limited to scheduling cancellation at period end. Refunds, immediate cancellations, and charge operations are out of scope.
  • Never page reads past --limit; never dump full API keys, customer data, or raw payloads into chat.
  • This skill operates the Stripe API. It does not build payments into applications or cover other payment processors.

When not to use

  • Building Stripe payments into an application (Checkout, Payment Intents in code, webhooks for your app, billing logic) — that is integration development; see backend-engineering.
  • Stripe dashboard administration (account settings, bank accounts, disputes, tax registration) — that is the Stripe Dashboard.
  • Refunds, immediate cancellations, or charge operations — deliberately out of this skill's guarded-mutation surface; those are human decisions in the dashboard or a dedicated integration.
  • Other payment processors (Braintree, Adyen, PayPal) — each has its own API and tooling; this skill covers Stripe.

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

Files

SKILL.md and 6 other files (scripts, references) in stripe of magnus919/agent-skills.

  • SKILL.md
  • README.md
  • evals/evals.json
  • references/00-source-index.md
  • references/01-stripe-read-operations.md
  • scripts/stripe-cli
  • tests/test_stripe_cli.py

Open the folder on GitHubat commit 22b4723

Compare with similar skills

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

Stripe compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Stripe this skillmagnus919/agent-skills115—~2.4kAutomated safety check: PassMIT
Firecrawl Build Onboardingfirecrawl/firecrawl190k1 repos~1.4kAutomated safety check: NotesISC
Minimax PDFpoco-ai/poco-claw1.4k6 repos~2.1kAutomated safety check: PassMIT
Get API Docs with chubandrewyng/context-hub14k1 repos~775Automated safety check: PassMIT
Stripe Projectsfossasia/eventyay1.7k5 repos~2kAutomated safety check: NotesApache-2.0
Effect Client WrapperUsefulSoftwareCo/executor4.1k1 repos~1.4kAutomated safety check: PassMIT

Similar skills

  • Firecrawl Build Onboarding

    firecrawl/firecrawl

    Gets Firecrawl working in a project: signs you in through the browser, saves FIRECRAWL_API_KEY to .env and picks the first SDK or REST path.

    190k GitHub starsUsed in 1 repo~1.4k tokens
    Backend & APIsAuto-check: notes

  • Minimax PDF

    poco-ai/poco-claw

    A skill your agent uses when visual quality and design identity matter for a PDF.

    1.4k GitHub starsUsed in 6 repos~2.1k tokens
    Documents & OfficeAuto-check passed

  • Get API Docs with chub

    andrewyng/context-hub

    Fetches current documentation for third-party APIs and SDKs with the chub CLI before the agent writes code against them, instead of relying on remembered API shapes.

    14k GitHub starsUsed in 1 repo~775 tokens
    DevelopmentAuto-check passed

  • Stripe Projects

    fossasia/eventyay

    A skill your agent uses when the user wants to provision infrastructure or third-party services using Stripe Projects.

    1.7k GitHub starsUsed in 5 repos~2k tokens
    Backend & APIsAuto-check: notes

  • Effect Client Wrapper

    UsefulSoftwareCo/executor

    Pattern for wrapping third-party SDK clients (Stripe, Resend, AWS, etc.) with Effect.

    4.1k GitHub starsUsed in 1 repo~1.4k tokens
    DevelopmentAuto-check passed

  • Stripe Apps

    fossasia/eventyay

    A skill your agent uses when building, modifying, or reviewing a Stripe App — or when the user describes something that implies one (e.g.

    1.7k GitHub starsUsed in 1 repo~3.6k tokens
    Backend & APIsAuto-check passed

More from magnus919/agent-skills

All 131 skills in this repo

  • Artifact Pyramids

    magnus919/agent-skills

    Organize durable agent research outputs as summaries, analysis, and evidence dossiers.

    119 GitHub stars~2.7k tokensUpdated today
    Auto-check passed

  • Ascii City Engine

    magnus919/agent-skills

    Build portable, first-person colored ASCII city engines and small GIS-derived city packs.

    119 GitHub stars~1.1k tokensUpdated today
    Auto-check passed

  • Color Management

    magnus919/agent-skills

    Manage color workflows with ICC profiles, working spaces, gamut mapping, and color science.

    119 GitHub stars~2.6k tokensUpdated today
    Auto-check: notes

  • Data Scientist

    magnus919/agent-skills

    A skill your agent uses for PhD-level expertise in data science, statistics, and machine learning: rigorous statistical analysis, experimental design, causal inference, advanced modeling, research…

    119 GitHub stars~4.1k tokensUpdated today
    Auto-check passed

  • Docker Compose

    magnus919/agent-skills

    Use Docker Compose to define, run, debug, and harden multi-container applications.

    119 GitHub stars~2k tokensUpdated today
    Auto-check: notes

  • Fpga Development

    magnus919/agent-skills

    Design, review, simulate, and verify FPGA logic using explicit RTL contracts, clock and reset models, CDC analysis, timing constraints, and reproducible implementation evidence.

    119 GitHub stars~2.7k tokensUpdated today
    Auto-check passed

Works with

Questions about Stripe

What does Stripe do?

Read Stripe account state from a terminal or agent: balance, payment intents, and subscriptions — and perform guarded mutations like canceling a subscription — backed by a bundled stripe-cli script…. Stripe is an agent skill from magnus919/agent-skills. Read Stripe account state from a terminal or agent: balance, payment intents, and subscriptions — and perform guarded mutations like canceling a subscription — backed by a bundled stripe-cli script that is read-only first and gates every state-changing command behind a --dry-run/--yes confirmation.

When should I use Stripe?

Stripe fits situations like: an agent needs to answer questions about account balance; recent payments; active subscriptions; apply a confirmed subscription cancellation.

How do I install Stripe in Claude Code?

Run `npx skills add magnus919/agent-skills --skill stripe -a claude-code`. Or copy the skill folder (stripe in magnus919/agent-skills) into .claude/skills/stripe in your project. Claude Code loads it when a task matches its description.

How do I install Stripe in Codex?

Run `npx skills add magnus919/agent-skills --skill stripe -a codex`. Or copy the skill folder (stripe in magnus919/agent-skills) into .agents/skills/stripe in your project. Codex loads it when a task matches its description.

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

What does Stripe need to run?

Going by SKILL.md and its folder, Stripe needs Python for the scripts in its folder and credentials named STRIPE_API_KEY. Our summary lists: Python 3; A credential in STRIPE_API_KEY. Compatibility (from SKILL.md): The bundled stripe-cli script runs on Python 3.9+ with only the standard library. --help and the read-only surface (balance, payments, subscriptions) need no network beyond api.stripe.com; live reads require a Stripe secret or restricted API key with read access and network access to api.stripe.com..

Does Stripe 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 Stripe 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Stripe use?

Stripe 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 Stripe use?

About 2.4k tokens (SKILL.md is roughly 9.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2k tokens, read only when the agent opens those files.

What are the alternatives to Stripe?

Skills that share tags, products or a category with Stripe: Firecrawl Build Onboarding (firecrawl/firecrawl, 190k stars), Minimax PDF (poco-ai/poco-claw, 1.4k stars), Get API Docs with chub (andrewyng/context-hub, 14k stars) and Stripe Projects (fossasia/eventyay, 1.7k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Stripe?

magnus919 (a GitHub user) maintains it in magnus919/agent-skills, which has 115 GitHub stars. The repository holds 131 skills in this directory. The repository was last updated on October 10, 2026.

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