Content
88%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.
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.
| Dimension | Reasoning | Score |
|---|---|---|
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 |