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 body is a tight, fully executable runbook: concrete commands with examples, an explicit verify step in the workflow, and unusually good operational pitfalls (credential-leak vectors, billing reality, orphaned resources). The only gaps are minor: a trimmable posture paragraph and no use of progressive disclosure despite a moderately long body.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean: every section adds tool-specific facts Claude would not know (vault path, .env behavior, catalog command), with no padding about what Stripe or SaaS is. Not 5 because the 'Gated [linux, macos]...' paragraph is meta-commentary about skill posture that earns little operational value and could be trimmed. | 4 / 5 |
Actionability | Every step is a copy-paste-ready command (stripe projects init/catalog/add neon/postgres/list), with concrete service examples, exact file paths (.projects/vault/vault.json, .env), and install commands for both platforms. Specific examples cover the common cases fully. | 5 / 5 |
Workflow Clarity | The procedure is a clearly sequenced init → catalog → add → verify workflow with an explicit validation step (step 4 'Verify' via stripe projects list) and a separate health-check Verification section. Error-recovery guidance is present in Pitfalls (grep the catalog before failing an add, check .gitignore before writes, check provider dashboard after remove), satisfying the feedback-loop requirement for the destructive remove/upgrade operations, so the cap does not apply. | 5 / 5 |
Progressive Disclosure | Sections are well-organized and appropriately sized with no buried references and no content that clearly belongs in a separate file. Not 5 because the skill ships no bundle files at all and keeps everything inline (install instructions, pitfalls, procedure) in a ~107-line body; at that size a references/ split for install/pitfalls detail would reach the 'clear overview with one-level-deep references' anchor. | 4 / 5 |
Total | 18 / 20 Passed |