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

69

1.08x
Quality

80%

Does it follow best practices?

Impact

100%

1.08x

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

SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./skills/upgrade-stripe/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

81%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.

A strong, information-dense body that stays almost entirely on Stripe-specific knowledge Claude cannot be assumed to know, with executable code across the dynamically-typed SDKs, a sequenced upgrade checklist, explicit pre-cutover validation, and a rollback path. Remaining gaps are minor: a few generic-knowledge passages to trim, and prose-only coverage of the strongly-typed SDK update and webhook-secret cutover.

DimensionReasoningScore

Conciseness

The body is dense with Stripe-specific, non-generic facts (monthly release cadence, thin vs. snapshot events, fixed versions in strongly-typed SDKs, 255-char object IDs, 72-hour rollback window), and hard-coded example versions are mitigated by the explicit instruction to "Replace bundled API versions shown in those examples with the selected target". Not 5 because a few passages explain things Claude already knows, notably the generic MAJOR/MINOR/PATCH semantic-versioning bullets in the mobile SDK section, and the prose could be tightened in places. Not 3 because these are minor, isolated instances rather than padded sections.

4 / 5

Actionability

Mostly executable guidance: copy-paste code for global config (Python, Ruby, Node), per-request override, the curl Stripe-Version test header, script-tag/npm install for Stripe.js, and concrete update commands ("npm update stripe", "pip install --upgrade stripe"). Not 5 because two common paths are prose-only: the strongly-typed SDK (Java/Go/.NET) update is described as "update the SDK to target a new API version" with no package/release mechanics, and the webhook signing-secret cutover has no code or commands.

4 / 5

Workflow Clarity

The 9-step Upgrade Checklist gives a clear sequence with explicit validation checkpoints — "Test your integration against the new API version using the Stripe-Version header", "create and test a replacement destination", dual-secret acceptance "during testing and cutover", and disabling the old destination after cutover — plus an explicit error-recovery path ("For 72 hours after upgrading, you can roll back to your previous API version in Workbench"). The destructive/batch cap does not apply since validation and rollback steps are present.

5 / 5

Progressive Disclosure

No bundle files exist, so the skill is a single ~200-line file with well-organized section headers and clearly signaled one-level-deep external links (docs.stripe.com). This exceeds the under-50-line simple-skill exception, and sections like Stripe.js and Mobile SDK versioning could be split into reference files if the skill grows, so it is not 5 — but structure and navigation are good with no buried or nested references.

4 / 5

Total

17

/

20

Passed

Description

70%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.

A distinct, domain-specific description that clearly states what the skill covers across the full range of Stripe surfaces. Its main weakness is the absence of any explicit "when to use" trigger clause, which caps completeness, and a single-verb action list that leaves the upgrade process itself unspecified.

Suggestions

Add an explicit trigger clause, e.g. "Use when the user asks to upgrade, update, or migrate a Stripe integration to a newer API version or SDK release, or mentions Stripe version pins or the Stripe-Version header."

Include the common user synonyms ("update", "migrate", "bump") alongside "upgrading" to broaden natural trigger-term coverage.

Enumerate one or two concrete actions of the upgrade process itself (e.g., comparing pinned versions, reviewing the API changelog, testing with the Stripe-Version header) to sharpen the "what".

DimensionReasoningScore

Specificity

The description enumerates concrete upgrade targets — "Stripe API versions, webhook endpoints, server-side SDKs, Stripe.js, and mobile SDKs" — giving the scope real specificity, but "upgrading" is the only verb and the concrete actions of the upgrade process itself (e.g., checking the changelog, updating version pins, testing) are not listed. This sits between anchor 3 (1-2 concrete actions) and anchor 5 (multiple distinct actions), noticeably above the midpoint.

4 / 5

Completeness

The "what" is clear ("Guide for upgrading Stripe API versions, webhook endpoints, server-side SDKs, Stripe.js, and mobile SDKs"), but there is no "Use when..." clause or any equivalent explicit trigger guidance. Per the judging guidelines, a missing trigger clause caps completeness at 3.

3 / 5

Trigger Term Quality

"upgrading", "Stripe API versions", "webhook endpoints", "server-side SDKs", "Stripe.js", and "mobile SDKs" are natural phrases a user with this need would say. Common synonyms and variations such as "update", "migrate", or "bump" a Stripe version/SDK are missing, so it falls just short of comprehensive keyword coverage.

4 / 5

Distinctiveness Conflict Risk

"Guide for upgrading Stripe API versions, webhook endpoints, server-side SDKs, Stripe.js, and mobile SDKs" names a narrow, well-defined niche with distinct Stripe-specific triggers; minimal risk of firing for an unrelated skill. Not 4 because there is no meaningful overlap with adjacent skills — the Stripe framing fully disambiguates.

5 / 5

Total

16

/

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

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.