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 endpoints, fields, and limits throughout, with confirmation gates for write operations and clean one-level-deep external references. Its only structural limitation is that detailed task workflows live in linked external skills, leaving inline workflow sequencing implicit rather than explicit.
Suggestions
Inline a brief numbered sequence (route → read page → confirm environment → confirm write → proceed) at the top of the Operational workflows section so the ordering of safety checkpoints is explicit in SKILL.md itself rather than implied.
For the highest-risk workflow (Stripe Billing Meters migration), add one or two inline validation steps — e.g., verify the parallel-run comparison matches before cutover — so destructive operations have a validate-before-proceed checkpoint visible without opening the external skill.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every line carries Metronome-specific knowledge Claude cannot know — 'POST /v1/ingest with a bare JSON array of 1 to 100 event objects', '24 hours after billing_period_end_date by default', '1000 is 10.00 USD', '250 line items per Stripe invoice' — with zero space spent explaining concepts Claude already knows. Not 4: not even minor trimming opportunities exist; the routing tables and rule list are pure high-signal content. | 5 / 5 |
Actionability | Guidance is fully concrete: exact endpoints ('POST /v2/contracts/edit', 'POST /v1/credits/migrateToContracts'), field names ('transaction_id', 'usage_filter', 'rollover_fraction', 'spend_threshold_configuration'), a routing table mapping each task to a specific API and doc page, and exact request-body shape ('not wrapped in an object'). Per the rubric's instruction-skill note, the absence of code is not penalized; the guidance is specific enough to execute directly, and gaps are closed by mandated doc reads. | 5 / 5 |
Workflow Clarity | There is a clear routing sequence (match the task in the table → read the linked page/skill in full → confirm environment and get explicit user confirmation before any write) with real checkpoints for risky operations, including separate confirmation for Stripe writes ('identify the Stripe account and mode behind the Stripe key'). Not 5: the multi-step sequences for the actual tasks (migration, setup, contract creation) are delegated to linked external skills rather than sequenced inline, so validation feedback loops within this body are confirmation gates rather than full validate-fix-retry loops. | 4 / 5 |
Progressive Disclosure | The body is a clear overview with well-signaled, one-level-deep references: a routing table of doc pages per task, a workflows table of external skills, and a fallback ('use the documentation index... append .md to the page URL to fetch it as Markdown'). Not 4: navigation is fully organized with no buried references and no inline content that belongs in a separate file — the critical-rules list is appropriately kept in the main file as the always-loaded core. | 5 / 5 |
Total | 19 / 20 Passed |