Content
61%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 body is highly actionable with executable code, but it is verbose for a SKILL.md, lacks validation feedback loops for irreversible payment operations, and references bundle files that are missing.
Suggestions
Move the pattern catalog into the referenced bundle files (references/*.md, assets/*.py) and actually ship them, so SKILL.md becomes a lean overview with one-level-deep pointers.
Add explicit validation/reconciliation steps (e.g., verify PaymentIntent status, confirm webhook signature before fulfilling, reconcile invoice paid state) for destructive/batch payment operations.
Fix the broken 'resources/implementation-playbook.md' reference to match the 'references/' directory, and trim the Core Concepts section that restates Stripe basics.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient code-centric content, but the ~450-line body re-explains Stripe basics Claude already knows (e.g., 'Product: What you're selling', 'Price: How much and how often') and duplicates webhook-handling across the secure-endpoint and best-practices sections. | 3 / 5 |
Actionability | Copy-paste-ready, executable Python/JS covering the common cases — checkout sessions, payment intents, subscriptions, customer portal, webhook verification, refunds, disputes, and test cards. | 5 / 5 |
Workflow Clarity | Sequences appear in places (e.g., the test flow), but there are no explicit validation checkpoints or validate->fix->retry feedback loops for destructive financial operations (charges, refunds), which caps workflow clarity at 3 per the rubric. | 3 / 5 |
Progressive Disclosure | A large amount of content that belongs in separate files is inlined, and the Resources section points to files (references/*.md, assets/*.py, resources/implementation-playbook.md) that do not exist on disk; the 'resources/' path also mismatches the listed 'references/' directory. | 2 / 5 |
Total | 13 / 20 Passed |