Agent skill · Stripe

Upgrade Stripe skill for Claude Code, Codex and Cursor

Steps for moving to a newer Stripe API version and updating SDKs, webhooks and Stripe.js.

Officialname: upgrade-stripe★ 2k (repo)pushed 2026-10-24MITSKILL.md on GitHubchecked 2026-11-07

What it does, in the publisher's words

Guide for upgrading Stripe API versions, webhook endpoints, server-side SDKs, Stripe.js, and mobile SDKs

The description field of the SKILL.md. The agent reads only this at startup and decides from it when to load the full skill.

Install Upgrade Stripe

The skills CLI copies the skill into the folder of each agent you pick (Claude Code, Codex, Cursor, Copilot, Gemini CLI, OpenCode, Windsurf...). Add -g for all projects. Needs Node.js 22.20+. docs

npx skills add stripe/ai --skill upgrade-stripe

This repo is a plugin marketplace. Inside Claude Code, add it and install the plugin that holds the skill (stripe), or copy only this skill into ~/.claude/skills. docs

/plugin marketplace add stripe/ai
/plugin install <plugin>@stripe

# or only this skill:
npx skills add stripe/ai --skill upgrade-stripe -a claude-code

Download the skill folder, zip it, then Customize > Skills > + > Create skill > Upload a skill. Code execution must be on (Settings > Capabilities). docs

git clone --depth 1 https://github.com/stripe/ai.git /tmp/upgrade-stripe-src
cp -r /tmp/upgrade-stripe-src/skills/upgrade-stripe ./upgrade-stripe
zip -r upgrade-stripe.zip upgrade-stripe

Codex reads skills from .agents/skills in the repo or ~/.agents/skills. Type $ in Codex to use one. docs

npx skills add stripe/ai --skill upgrade-stripe -a codex

gh skill (GitHub CLI 2.90+, preview) installs it for Copilot in VS Code, the CLI and the cloud agent. Copilot also reads .github/skills and ~/.copilot/skills. docs

gh skill install stripe/ai upgrade-stripe

Cursor reads .cursor/skills, .agents/skills and ~/.cursor/skills (and .claude/skills). It does not install loose skills from a GitHub URL, so copy it in. docs

npx skills add stripe/ai --skill upgrade-stripe -a cursor

Installs from the GitHub repo; --path picks this skill out of the repo. Default scope is user (all projects). docs

gemini skills install https://github.com/stripe/ai.git --path skills/upgrade-stripe

OpenCode reads .opencode/skills, ~/.config/opencode/skills and the Claude and .agents folders. docs

npx skills add stripe/ai --skill upgrade-stripe -a opencode

Windsurf (now Devin Desktop) reads .devin/skills, .windsurf/skills and ~/.codeium/windsurf/skills. docs

npx skills add stripe/ai --skill upgrade-stripe -a windsurf

Works with

Claude Code, Claude.ai and Claude Desktop, Codex, GitHub Copilot, Cursor, Gemini CLI, OpenCode, Windsurf and other agents that read the open Agent Skills format.

What's in the SKILL.md

18 sections

Choose a target API version
Understanding Stripe API Versioning
Types of Changes
Server-Side SDK Versioning
Dynamically-Typed Languages (Ruby, Python, PHP, Node.js)
Strongly-Typed Languages (Java, Go, .NET)
Best Practice
Stripe.js Versioning
Loading Versioned Stripe.js
API Version Pairing
Migrating from v3
Mobile SDK Versioning
iOS and Android SDKs
React Native SDK
Backend Compatibility
Upgrade Checklist
Testing API Version Changes
Important Notes

Facts

Skill name: upgrade-stripe
Publisher: Stripe (official)
Repo: stripe/ai
License: MIT
SKILL.md size: 1,122 words, 192 lines
Repo stars: 2k (as of 2026-10-24)
SKILL.md checked: 2026-11-07

Pairs with the Stripe MCP server: the server gives the agent the tools, the skill teaches it how to use them.

More skills from stripe/ai

Stripe Connect Advisor: Recommends a Stripe Connect setup for marketplaces and platforms that pay out other parties.
Stripe Best Practices: Helps choose the right Stripe APIs for payments, subscriptions, Connect, tax and key handling.
Stripe Docs: Searches and reads Stripe documentation and API reference from inside the agent.

FAQ

What does the upgrade-stripe skill do?+

Steps for moving to a newer Stripe API version and updating SDKs, webhooks and Stripe.js. In its own SKILL.md, Stripe describes it as: "Guide for upgrading Stripe API versions, webhook endpoints, server-side SDKs, Stripe.js, and mobile SDKs"

How do I install the upgrade-stripe skill?+

Run npx skills add stripe/ai --skill upgrade-stripe and pick your agents, or use the tab for your agent above. In Claude Code the skill ends up in ~/.claude/skills/upgrade-stripe/SKILL.md; in Codex and Cursor in .agents/skills/upgrade-stripe/.

Does Upgrade Stripe work in Codex, Cursor and Copilot, or only Claude?+

It's a standard SKILL.md, so any agent that reads the Agent Skills format can use it: Claude Code, the Claude apps, Codex, GitHub Copilot, Cursor, Gemini CLI, OpenCode, Windsurf and more.

Who maintains Upgrade Stripe?+

Stripe, the company or project behind it, in the stripe/ai repo on GitHub, last pushed 2026-10-24. License: MIT.

Read a skill's SKILL.md and scripts before you install it: skills aren't verified by any agent vendor. Claude skills marketplace · How to install skills · MCP servers