Content
86%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, execution-first skill: complete copy-paste code for the full checkout→webhook→gating flow, a well-sequenced workflow with a verification step and key gotchas, and clean single-file organization. The only improvements are minor — trimming the redundant intro paragraph and duplicate signature-verification note, and adding an end-to-end webhook test step.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dominated by lean, executable code with terse steps, but the opening paragraph ("Wire Stripe to Convex using @convex-dev/stripe: a checkout action, an httpAction webhook registered by the component (signature-verified automatically), subscription state stored in the component's tables...") restates what the Workflow shows, signature-verification handling is stated twice (step 4 and the Rules bullet), and the version pin "@convex-dev/stripe@^0.1.4" is time-sensitive without a deprecated/old-patterns section. Not 5 for these minor trims; well above 3 since nothing explains concepts Claude already knows. | 4 / 5 |
Actionability | Three complete, copy-paste-ready files (convex.config.ts, convex/http.ts, convex/billing.ts with argument/return validators and auth checks), exact commands ("npm install @convex-dev/stripe", "npx convex dev --once"), and dashboard steps naming exact webhook events. The common cases (checkout, webhook registration, subscription gating) are all covered with executable code; the one delegation ("use the `env` micro power" for keys) is explicit rather than a gap. | 5 / 5 |
Workflow Clarity | Seven clearly sequenced steps with one explicit validation checkpoint ("Verify output shows `✔ Installed component stripe.`"), plus a gotcha called out (the required .js import extension). Not 5 because there is no end-to-end webhook verification or error-recovery loop (e.g., testing with a Stripe CLI event or a test checkout run); not 3 because a concrete checkpoint and key pitfalls are present, and the operation is additive rather than destructive/batch. | 4 / 5 |
Progressive Disclosure | This is a single-file skill with no references/, scripts/, or assets/ directories, and all content is needed for the one task. It is well organized into a short overview, a numbered Workflow, and a Rules section, with no inlined material that belongs in separate files — matching the simple-skill exception where well-organized sections alone warrant a 5. | 5 / 5 |
Total | 18 / 20 Passed |