Content
64%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The skill provides solid, executable Stripe integration code covering key use cases (payments, subscriptions, refunds, webhooks). However, it suffers from redundancy between the security checklist and best practices sections, lacks a clear end-to-end workflow with validation steps, and doesn't cover Square despite the skill description promising it. The PayPal reference file is missing from the bundle.
Suggestions
Merge the security checklist and best practices sections into a single concise section to eliminate redundancy
Add an end-to-end integration workflow with numbered steps and validation checkpoints (e.g., 1. Set up Stripe account, 2. Configure webhook endpoint, 3. Test with `stripe listen --forward-to`, 4. Verify events received, 5. Deploy)
Either add Square integration content or remove it from the skill's scope/description
Provide the referenced paypal-integration.md bundle file to support the progressive disclosure reference
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The security checklist and best practices sections overlap significantly (both mention webhook signatures, official SDKs, sandbox testing, not storing card data). The Do/Don't section largely restates the checklist. Otherwise the code examples are reasonably lean. | 2 / 3 |
Actionability | Provides fully executable Node.js code for Stripe payment intents, subscriptions, refunds, and webhook handling. The code is copy-paste ready with concrete API calls and proper patterns like cents conversion and signature verification. | 3 / 3 |
Workflow Clarity | The skill presents individual components (payment intent, subscription, webhook) but lacks a clear end-to-end workflow sequence showing how these pieces connect. There are no explicit validation checkpoints or feedback loops for the integration process (e.g., verify webhook endpoint is registered, test with Stripe CLI before deploying). | 2 / 3 |
Progressive Disclosure | References PayPal integration in a separate file which is good structure, but the bundle has no files so the reference is unverifiable. Square integration mentioned in the description is entirely absent. The inline content could benefit from separating the security/best-practices into a reference file to keep the main skill leaner. | 2 / 3 |
Total | 9 / 12 Passed |