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

83%

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

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

SKILL.md
Quality
Evals
Security

Quality

Content

88%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 skill body is a strong, actionable reference: executable examples, a well-sequenced upgrade checklist with explicit testing, cutover, and rollback safeguards, and mostly non-redundant Stripe-specific content. The only improvements are trimming a few generic concept explanations and potentially moving per-platform detail into reference files.

DimensionReasoningScore

Conciseness

The body is dense with Stripe-specific facts Claude cannot reliably know (monthly no-breaking-change cadence, thin vs. snapshot events, snapshot_api_version immutability, 72-hour rollback), and time-sensitive versions are handled self-awarely ('a fallback version dated more than a month ago is probably stale', 'Replace bundled API versions shown in those examples with the selected target'). Minor over-explanation remains — the generic MAJOR.MINOR.PATCH semver bullets and the backward-compatible/breaking-change taxonomy — so it fits 'efficient with minor trimming' rather than the lean anchor.

4 / 5

Actionability

Fully executable guidance throughout: copy-paste-ready client config in Python/Ruby/JavaScript, a curl example with the Stripe-Version test header, concrete update commands ('npm update stripe', 'pip install --upgrade stripe', 'npm install @stripe/stripe-js'), per-language version-pinning rules, and specific doc URLs — covering the common cases.

5 / 5

Workflow Clarity

The 9-step Upgrade Checklist is clearly sequenced with explicit validation checkpoints: test with the Stripe-Version header before switching, 'create and test a replacement destination', dual signing secrets 'during testing and cutover', 'disable or delete the old destination' after cutover, and a 72-hour rollback path, plus conditional branches for unchanged pins and unverified versions.

5 / 5

Progressive Disclosure

No bundle files exist, so inline content is the only option; sections are well-organized with clear headers and one-level-deep external references to docs.stripe.com. Some per-platform detail (SDK snippets, mobile versioning specifics) could live in reference files to slim the main skill, which is the minor gap keeping it below the top anchor.

4 / 5

Total

18

/

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.

The description is specific, Stripe-distinctive, and free of fluff, but it omits any explicit 'when to use' trigger guidance, which caps completeness. Adding a 'Use when...' clause with natural trigger phrases (e.g., upgrade, update, migrate a Stripe integration) would raise both completeness and trigger-term quality.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user asks to upgrade, update, or migrate a Stripe integration, change a pinned API version, or update Stripe SDKs.'

Include natural synonyms and variations users would say — 'update Stripe', 'migrate Stripe API', 'bump API version' — to broaden trigger-term coverage.

Optionally mention verification/testing of upgrades and the rollback window to make capability coverage more comprehensive.

DimensionReasoningScore

Specificity

Names the domain and enumerates concrete targets — 'API versions, webhook endpoints, server-side SDKs, Stripe.js, and mobile SDKs' — which goes beyond 1-2 actions, but a single generic verb ('Guide for upgrading') governs all of them, leaving minor coverage gaps (testing, rollback) that keep it below the comprehensive anchor.

4 / 5

Completeness

The 'what' is clear (upgrading Stripe API versions, webhooks, and SDKs), but there is no 'Use when...' clause or equivalent explicit trigger guidance, which the rubric guideline caps at 3; the 'when' is only weakly implied by the domain itself.

3 / 5

Trigger Term Quality

Includes natural terms users would say ('upgrading', 'Stripe', 'API versions', 'webhook', 'SDKs', 'Stripe.js') with good coverage, but misses common variations and synonyms such as 'update', 'migrate', or 'API version pin', so it falls short of the comprehensive anchor.

4 / 5

Distinctiveness Conflict Risk

'Stripe' combined with specific artifacts (webhook endpoints, Stripe.js, mobile SDKs) carves a clear niche with distinct triggers and minimal risk of firing for the wrong skill.

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

providers/agent-plugins/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.