Content
81%Weight 40%Scale 1-5Reviews 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.
| Dimension | Reasoning | Score |
|---|---|---|
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 |