CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

upgrade-stripe

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

1.02x
Quality

73%

Does it follow best practices?

Impact

100%

1.02x

1 of 3 eval scenarios. Add 2 more for a full score.

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./providers/antigravity/plugin/skills/upgrade-stripe/SKILL.md

The canonical home for this skill is upgrade-stripe in stripe/ai

SKILL.md
Quality
Evals
Security

Quality

Content

67%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The content is a well-structured, highly actionable upgrade guide with a strong sequenced checklist, careful webhook cutover handling, and executable examples for the common languages. Its main weaknesses are stale-prone hardcoded version numbers repeated through code examples and some padding (semver basics) that could be trimmed. Splitting per-SDK detail into reference files would improve token efficiency further.

Suggestions

Replace hardcoded API versions in code examples with a clearly marked placeholder (or define the target version once at the top and reference it) so examples don't go stale when a new API version ships.

Trim the MAJOR.MINOR.PATCH semantic-versioning explanation in the Mobile SDK section — Claude already knows semver; keep only the React Native 0.x.y deviation, which is the non-obvious part.

Move the per-SDK versioning details (server-side, Stripe.js, mobile) into references/ files and keep SKILL.md as a lean overview plus the upgrade checklist and testing steps.

DimensionReasoningScore

Conciseness

The body is mostly tight and instructional, but it embeds time-sensitive version numbers (e.g., '2026-10-28.endive' hardcoded in ~8 code examples) outside any 'old patterns'/'deprecated' section — partially mitigated by the instruction to "Replace bundled API versions shown in those examples with the selected target" — and explains semantic versioning (MAJOR/MINOR/PATCH) that Claude already knows. This fits anchor 3 (mostly efficient with some unnecessary explanation or tightening possible) rather than 4.

3 / 5

Actionability

Concrete, executable guidance dominates: copy-paste-ready Python/Ruby/JS client config, a per-request override, a curl example with the Stripe-Version header, commands like "npm update stripe" and "pip install --upgrade stripe", and a very specific webhook-destination replacement procedure. Minor gaps keep it at anchor 4 rather than 5: no concrete commands for selecting Java/Go/.NET SDK releases or updating mobile SDKs.

4 / 5

Workflow Clarity

The 9-step Upgrade Checklist is clearly sequenced with real checkpoints: test via the Stripe-Version header before changing defaults, accept both signing secrets during testing and cutover, disable the old destination after cutover, and a 72-hour rollback window. It falls short of anchor 5 only because the validate -> fix -> re-test feedback loop is implied ("Test your integration") rather than explicitly spelled out.

4 / 5

Progressive Disclosure

No bundle files exist, and the ~190-line body is organized under clear section headers with deep detail delegated via clearly signaled, one-level-deep links to official Stripe docs (e.g., "See [Set a Stripe API version for your SDK](https://docs.stripe.com/sdks/set-version.md) for details"). This matches anchor 4 (good structure, most content appropriately placed); it is not 5 because per-SDK versioning sections (server-side, Stripe.js, mobile) could be split into reference files to keep SKILL.md a leaner overview.

4 / 5

Total

15

/

20

Passed

Description

65%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is precise and highly distinctive, clearly scoping the skill to Stripe upgrades across five named components. Its main weakness is the missing "Use when..." trigger clause, which caps completeness and limits natural trigger-phrase coverage. Adding explicit usage triggers and a second concrete action verb would raise it further.

Suggestions

Add a "Use when..." clause with concrete trigger phrases, e.g., "Use when the user asks to upgrade or update a Stripe integration, bump the Stripe API version, or migrate Stripe SDKs/webhooks."

Include additional concrete actions beyond "upgrading", such as comparing pinned API versions, testing with the Stripe-Version header, and migrating snapshot webhook events to thin events.

Add natural synonyms users might say ("update Stripe", "migrate Stripe API", "newest Stripe API version") to broaden trigger-term coverage.

DimensionReasoningScore

Specificity

"Guide for upgrading Stripe API versions, webhook endpoints, server-side SDKs, Stripe.js, and mobile SDKs" names the domain and enumerates five concrete upgrade targets, but the sole action verb is "upgrading" — no additional concrete actions (compare pinned versions, migrate events, test) are stated. This matches anchor 3 (domain plus 1-2 concrete actions, not comprehensive) rather than 4, which requires several distinct specific actions.

3 / 5

Completeness

The description clearly answers "what" (a guide for upgrading Stripe API versions, webhook endpoints, and SDKs) but contains no "Use when..." clause or equivalent trigger guidance, which caps completeness at 3 per the judging guidelines. It is not 4 because "when" is entirely absent rather than present-but-imprecise.

3 / 5

Trigger Term Quality

"Stripe", "upgrading", "API versions", "webhook endpoints", "SDKs", "Stripe.js", and "mobile SDKs" are phrases users would naturally say when needing this skill. A few natural variations are missing (e.g., "update Stripe integration", "migrate Stripe", "bump API version"), so it fits anchor 4 (good keyword coverage, a few natural terms missing) rather than anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

"Stripe" plus the enumerated components (API versions, webhook endpoints, server-side SDKs, Stripe.js, mobile SDKs) establish a clear niche with distinct triggers and minimal conflict risk with other skills, matching anchor 5. It is not below 5 because no generic or overlapping language appears.

5 / 5

Total

15

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

stripe/ai

Path

providers/antigravity/plugin/skills/upgrade-stripe/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.