Content
93%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 dense, high-signal routing skill: concrete API rules, explicit confirmation gates around every write (including separate verification for Stripe writes), and clean progressive disclosure to per-task sub-skills and documentation. The only structural gap is the absence of error-recovery/feedback-loop guidance for the multi-step workflows it dispatches to.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every line carries Metronome-specific facts Claude cannot know ("`POST /v1/credits/migrateToContracts`", "24 hours after `billing_period_end_date` by default", "sandbox and production share `https://api.metronome.com`; the token determines the environment"); there is no padding and no explanation of concepts Claude already knows, so the length reflects coverage, not verbosity. | 5 / 5 |
Actionability | Guidance is fully concrete and executable for an instruction-only skill: exact endpoints and shapes ("`POST /v1/ingest` with a bare JSON array of 1 to 100 event objects as the request body, not wrapped in an object"), field-level rules ("take only `product_id`, `name`, `description`, and `priority`"), and hard limits ("Never exceed 250 line items per Stripe invoice", "`1000` is 10.00 USD"). | 5 / 5 |
Workflow Clarity | The routing sequence is clear (route → read the linked page → confirm environment → get explicit user confirmation before writes → identify the Stripe account/mode via `GET /v1/account` for Stripe-touching steps), and validation checkpoints for the destructive/batch operations are present so the rubric's cap at 3 does not apply. However, there are no error-recovery feedback loops (validate → fix → retry) for the workflows it gates, which keeps it below the anchor-5 example. | 4 / 5 |
Progressive Disclosure | The body is a well-organized overview that delegates all detail to one-level-deep, clearly signaled references — two routing tables with descriptive "What it does" columns for the Metronome sub-skills and doc links, plus a fallback ("use the documentation index… append `.md` to the page URL") — with no buried or nested references. | 5 / 5 |
Total | 19 / 20 Passed |