Agent skill

Upgrade Stripe

by kanchengw in kanchengw/cnllm

Guide for upgrading Stripe API versions and SDKs. An agent skill from kanchengw/cnllm.

Apache-2.0Auto-check passedAI & LLM Engineering

Install Upgrade Stripe

skills CLI
$ npx skills add kanchengw/cnllm --skill upgrade-stripe -a claude-code

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

GitHub CLI
$ gh skill install kanchengw/cnllm upgrade-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/kanchengw/cnllm.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/upgrade-stripe .claude/skills/upgrade-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
upgrade-stripe
GitHub stars
173
Used in
3 other repos
Token cost
~1.4k tokens
SKILL.md length
571 words
Files
1
Skills in repo
2
Repo updated
First seen
Licence
Apache-2.0

At a glance

Guide for upgrading Stripe API versions and SDKs. An agent skill from kanchengw/cnllm.

  • Works in 4 steps: Identify your current API version in code → Review the changelog for relevant changes → Consider gradually updating your API… → …
  • Tasks that involve Building AI agents
  • SKILL.md covers Understanding Stripe API…, Server-Side SDK Versioning, Stripe.js Versioning and Mobile SDK Versioning, plus 3 more sections
  • Calls npm, curl and pip; reaches js.stripe.com and api.stripe.com

What it does

Upgrade Stripe is an agent skill from kanchengw/cnllm. Guide for upgrading Stripe API versions and SDKs

Its SKILL.md is about 1.4k 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 AI & LLM Engineering, covering Building AI agents. It works with Stripe, Python, LangChain and LlamaIndex. The repository describes itself as: Python toolkit for Chinese LLMs, with flexible batch capacity, structured real-time visulization and automated accumulation for streaming, and explicit feedback on vendor-native… The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve Building AI agents

Example prompts

  • “/upgrade-stripe”

Requirements

  • Python 3
  • Node.js

Workflow steps

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

  1. Identify your current API version in code
  2. Review the changelog for relevant changes
  3. Consider gradually updating your API version before switching Stripe.js versions
  4. Stripe continues supporting v3 indefinitely

What it can do on your machine

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

    • npm
    • curl
    • pip

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

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • js.stripe.com
    • api.stripe.com

    Also links to:

    • docs.stripe.com

    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

Upgrade Stripe loads about 1.4k tokens when it runs. Until then it costs about 16 tokens; SKILL.md has 571 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~16
When it runs · the whole SKILL.md, loaded when a task matches
~1.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); files beside SKILL.md are not scanned.

SKILL.md

The full file from kanchengw/cnllm at commit 7fadd83, republished under its Apache-2.0 licence (© kanchengw). 571 words, ~1,402 tokens.

Download SKILL.mdSave it as .claude/skills/upgrade-stripe/SKILL.md (or your agent's skills folder).
name
upgrade-stripe
description
Guide for upgrading Stripe API versions and SDKs

The latest Stripe API version is 2026-05-27.dahlia - use this version when upgrading unless the user specifies a different target version.

Upgrading Stripe Versions

This guide covers upgrading Stripe API versions, server-side SDKs, Stripe.js, and mobile SDKs.

Understanding Stripe API Versioning

Stripe uses date-based API versions (e.g., 2026-05-27.dahlia, 2025-08-27.basil, 2024-12-18.acacia). Your account’s API version determines request/response behavior.

Types of Changes

Backward-Compatible Changes (don’t require code updates):

  • New API resources
  • New optional request parameters
  • New properties in existing responses
  • Changes to opaque string lengths (e.g., object IDs)
  • New webhook event types

Breaking Changes (require code updates):

  • Field renames or removals
  • Behavioral modifications
  • Removed endpoints or parameters

Review the API Changelog for all changes between versions.

Server-Side SDK Versioning

See SDK Version Management for details.

Dynamically-Typed Languages (Ruby, Python, PHP, Node.js)

These SDKs offer flexible version control:

Global Configuration:

python
import stripe
stripe.api_version = '2026-05-27.dahlia'
ruby
Stripe.api_version = '2026-05-27.dahlia'
javascript
const stripe = require('stripe')('sk_test_xxx', {
  apiVersion: '2026-05-27.dahlia'
});

Per-Request Override:

python
stripe.Customer.create(
  email="customer@example.com",
  stripe_version='2026-05-27.dahlia'
)
Strongly-Typed Languages (Java, Go, .NET)

These use a fixed API version matching the SDK release date. Don’t set a different API version for strongly-typed languages because response objects might not match the strong types in the SDK. Instead, update the SDK to target a new API version.

Best Practice

Always specify the API version you’re integrating against in your code instead of relying on your account’s default API version:

javascript
// Good: Explicit version
const stripe = require('stripe')('sk_test_xxx', {
  apiVersion: '2026-05-27.dahlia'
});

// Avoid: Relying on account default
const stripe = require('stripe')('sk_test_xxx');

Stripe.js Versioning

See Stripe.js Versioning for details.

Stripe.js uses an evergreen model with major releases (Acacia, Basil, Clover, Dahlia) on a biannual basis.

Loading Versioned Stripe.js

Via Script Tag:

html
<script src="https://js.stripe.com/dahlia/stripe.js"></script>

Via npm:

bash
npm install @stripe/stripe-js

Major npm versions correspond to specific Stripe.js versions.

API Version Pairing

Each Stripe.js version automatically pairs with its corresponding API version. For instance:

  • Dahlia Stripe.js uses 2026-05-27.dahlia API
  • Acacia Stripe.js uses 2024-12-18.acacia API

You can’t override this association.

Migrating from v3
  1. Identify your current API version in code
  2. Review the changelog for relevant changes
  3. Consider gradually updating your API version before switching Stripe.js versions
  4. Stripe continues supporting v3 indefinitely

Mobile SDK Versioning

See Mobile SDK Versioning for details.

iOS and Android SDKs

Both platforms follow semantic versioning (MAJOR.MINOR.PATCH):

  • MAJOR: Breaking API changes
  • MINOR: New functionality (backward-compatible)
  • PATCH: Bug fixes (backward-compatible)

New features and fixes release only on the latest major version. Upgrade regularly to access improvements.

Show full SKILL.md (213 more words)Show less
React Native SDK

Uses a different model (0.x.y schema):

  • Minor version changes (x): Breaking changes AND new features
  • Patch updates (y): Critical bug fixes only
Backend Compatibility

All mobile SDKs work with any Stripe API version you use on your backend unless documentation specifies otherwise.

Upgrade Checklist

  1. Review the API Changelog for changes between your current and target versions
  2. Check Upgrades Guide for migration guidance
  3. Update server-side SDK package version (e.g., npm update stripe, pip install --upgrade stripe)
  4. Update the apiVersion parameter in your Stripe client initialization
  5. Test your integration against the new API version using the Stripe-Version header
  6. Update webhook handlers to handle new event structures
  7. Update Stripe.js script tag or npm package version if needed
  8. Update mobile SDK versions in your package manager if needed
  9. Store Stripe object IDs in databases that accommodate up to 255 characters (case-sensitive collation)

Testing API Version Changes

Use the Stripe-Version header to test your code against a new version without changing your default:

bash
curl https://api.stripe.com/v1/customers \
  -u sk_test_xxx: \
  -H "Stripe-Version: 2026-05-27.dahlia"

Or in code:

javascript
const stripe = require('stripe')('sk_test_xxx', {
  apiVersion: '2026-05-27.dahlia'  // Test with new version
});

Important Notes

  • Your webhook listener should handle unfamiliar event types gracefully
  • Test webhooks with the new version structure before upgrading
  • Breaking changes are tagged by affected product areas (Payments, Billing, Connect, etc.)
  • Multiple API versions coexist simultaneously, enabling staged adoption

© kanchengw, Apache-2.0. 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 skills/upgrade-stripe of kanchengw/cnllm.

Open the folder on GitHubat commit 7fadd83

Used in 3 other repositories

We found 8 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 3 other GitHub owners. This page covers the copy in kanchengw/cnllm, which our catalogue first saw on October 7, 2026.

Compare with similar skills

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

Upgrade Stripe compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Upgrade Stripe this skillkanchengw/cnllm1733 repos~1.4kAutomated safety check: PassApache-2.0
Routerbase API Integrationaiskillstore/marketplace433—~964Automated safety check: PassNone
Uipath FunctionsUiPath/skills167—~3.6kAutomated safety check: NotesMIT
Add Example AgentGetBindu/Bindu10k—~1.1kAutomated safety check: NotesCustom licence
Tool Designagentailor/fullstack-langgraph-nextjs-agent132—~3.2kAutomated safety check: PassMIT
Sentry Setup AI MonitoringLiorVainer/data-israel130—~1.8kAutomated safety check: PassApache-2.0

Similar skills

  • Routerbase API Integration

    aiskillstore/marketplace

    Integrate applications with RouterBase, the OpenAI-compatible model gateway at https://routerbase.com/v1.

    433 GitHub stars~964 tokensUpdated yesterday
    AI & LLM EngineeringAuto-check passed
  • Uipath Functions

    UiPath/skills

    UiPath Coded Functions — deterministic Python or TypeScript/JavaScript units built with the uip function CLI (new -l py|ts|js, init, serve, run, pack, publish); the functions map in uipath.json…

    167 GitHub stars~3.6k tokensUpdated today
    AI & LLM EngineeringAuto-check: notes
  • Add Example Agent

    GetBindu/Bindu

    Add a new self-contained example agent under examples/. An agent skill from GetBindu/Bindu.

    10k GitHub stars~1.1k tokensUpdated 1 mo ago
    AI & LLM EngineeringAuto-check: notes
  • Tool Design

    agentailor/fullstack-langgraph-nextjs-agent

    Design and verify tools that AI agents can actually use — for any framework or language (MCP servers, LangChain/LangGraph, function-calling, raw JSON schema; TypeScript, Python, or otherwise).

    132 GitHub stars~3.2k tokensUpdated 1 mo ago
    AI & LLM EngineeringAuto-check passed
  • Sentry Setup AI Monitoring

    LiorVainer/data-israel

    Setup Sentry AI Agent Monitoring in any project. An agent skill from LiorVainer/data-israel.

    130 GitHub stars~1.8k tokensUpdated 5 mo ago
    AI & LLM EngineeringAuto-check passed
  • Langfuse

    davila7/claude-code-templates

    Expert in Langfuse - the open-source LLM observability platform.

    33k GitHub starsUsed in 5 repos~1.4k tokens
    AI & LLM EngineeringAuto-check passed

More from kanchengw/cnllm

  • Stripe Best Practices

    kanchengw/cnllm

    Guides Stripe integration decisions — API selection (Checkout Sessions vs PaymentIntents), Connect platform setup (Accounts v2, controller properties), billing/subscriptions, Treasury financial…

    173 GitHub starsUsed in 2 repos~925 tokens
    Auto-check passed

Questions about Upgrade Stripe

What does Upgrade Stripe do?

Guide for upgrading Stripe API versions and SDKs. An agent skill from kanchengw/cnllm. Upgrade Stripe is an agent skill from kanchengw/cnllm.

When should I use Upgrade Stripe?

Upgrade Stripe fits situations like: tasks that involve Building AI agents.

How do I install Upgrade Stripe in Claude Code?

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

How do I install Upgrade Stripe in Codex?

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

Can I use Upgrade 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 kanchengw/cnllm --skill upgrade-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/upgrade-stripe, .gemini/skills/upgrade-stripe, .github/skills/upgrade-stripe and .opencode/skills/upgrade-stripe in your project.

What does Upgrade Stripe need to run?

Going by SKILL.md and its folder, Upgrade Stripe needs the command-line tools its instructions call (npm, curl and pip). Our summary lists: Python 3; Node.js.

Does Upgrade Stripe access the network?

SKILL.md names 3 domains. In commands or code: js.stripe.com and api.stripe.com; the agent is likely to contact these when it follows the instructions. As links in the text: docs.stripe.com. This is read from the text; nothing was executed.

Is Upgrade 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. Review the folder before installing.

What licence does Upgrade Stripe use?

Upgrade Stripe is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Upgrade Stripe use?

About 1.4k tokens (SKILL.md is roughly 5.6k 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 Upgrade Stripe?

Skills that share tags, products or a category with Upgrade Stripe: Routerbase API Integration (aiskillstore/marketplace, 433 stars), Uipath Functions (UiPath/skills, 167 stars), Add Example Agent (GetBindu/Bindu, 10k stars) and Tool Design (agentailor/fullstack-langgraph-nextjs-agent, 132 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Upgrade Stripe?

kanchengw (a GitHub user) maintains it in kanchengw/cnllm, which has 173 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on June 15, 2026.

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