Content
67%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 well-structured routing skill: decisive integration recommendations, concrete CLI commands, explicit critical rules with a validation checkpoint, and an appropriately disclosed reference bundle. Main weaknesses are time-sensitive version data inlined at the top (hurting maintainability and conciseness), fragmented sandbox/MCP setup guidance, and inconsistent reference link formatting.
Suggestions
Move the SDK version table and pinned API version (2026-09-30.endive) into a clearly labeled section or reference file so time-sensitive data doesn't clutter the always-loaded body and go stale in place.
Consolidate the sandbox setup guidance (lines 35-39) into one sequenced mini-workflow: create sandbox → claim if using MCP → verify auth with `stripe whoami --format json`, instead of three fragmented conditionals.
Use consistent clickable markdown links in the routing table's Details column (e.g., [payments.md](references/payments.md)) instead of the angle-bracket `<references/payments.md>` notation.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient tables and imperative rules, but the SDK version table (Ruby 20.0.0 … .NET 53.0.0) and pinned API version "2026-09-30.endive" are time-sensitive version data presented outside any old-patterns/deprecated section, which the rubric explicitly penalizes. The sandbox/MCP rules ("If `stripe sandbox create` is used, don't use MCP") also fragment one flow with slight redundancy. | 3 / 5 |
Actionability | Concrete, executable commands (`npm i -g @stripe/cli`, `stripe sandbox create`, `stripe sandbox claim`, `stripe whoami --format json`) and exact parameter guidance (`payment_method_types: ['card_present']`, `allowed_payment_method_types`, `integration_identifier`) with a decisive routing table. Falls short of 5 because no copy-paste-ready code examples cover the common creation flows; exceeds 3 since guidance is concrete rather than pseudocode. | 4 / 5 |
Workflow Clarity | The routing table plus "Read the relevant reference file before answering any integration question or writing code" gives an unambiguous decision flow, and the automatic_tax rule embeds an explicit checkpoint ("read the tax reference and confirm the user has an active registration"). Not 5 because the sandbox/CLI/MCP setup steps are scattered across separate paragraphs rather than clearly sequenced. | 4 / 5 |
Progressive Disclosure | Appropriately split overview: the body stays lean and points to six one-level-deep reference files, all of which exist in references/ (payments, connect, billing, tax, treasury, security), each mapped by task in the routing table. Minor gap: the table uses non-clickable angle-bracket paths (`<references/payments.md>`) inconsistently with the real markdown link `[tax reference](references/tax.md)`, so navigation signaling is not fully uniform. | 4 / 5 |
Total | 15 / 20 Passed |