Content
100%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 lean, high-signal overview that routes each workflow to the right reference with explicit gates (search-first, confirmation) and concrete project-specific rules. It adds only knowledge Claude could not infer about this codebase and assumes competence throughout.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with project-specific facts (naming tables, tracking-pattern routing, pipeline destinations, key file registry) and contains no explanations of concepts Claude already knows. The only rationale prose (constraint 1's declarative-helper exemption) is non-obvious repository knowledge that earns its tokens, fitting anchor 5's "every token earns its place". | 5 / 5 |
Actionability | Concrete, executable guidance throughout: a copy-paste grep command, exact file paths ("static/app/utils/analytics.tsx", "static/gsApp/utils/rawTrackAnalyticsEvent.tsx"), and a situation-to-pattern routing table that tells the reader exactly which pattern and reference to use. Per the scoring notes, an instruction-heavy skill with this specificity meets the fully-actionable anchor. | 5 / 5 |
Workflow Clarity | Multi-step workflows are explicitly sequenced with validation gates: "NEVER create a new event without checking if one already exists" with numbered search steps, Amplitude-first with grep fallback, an AskUserQuestion confirmation gate ("Do not proceed to instrumentation without explicit confirmation"), and a troubleshooting reference covering error recovery (events not firing, TypeScript errors). This matches anchor 5's explicit-checkpoint and feedback-loop pattern; the work is not destructive or batch, so no cap applies. | 5 / 5 |
Progressive Disclosure | SKILL.md is a genuine overview: four references (amplitude-mcp.md, event-definitions.md, tracking-patterns.md, troubleshooting.md) — all verified to exist — each clearly signaled with when to read it ("Read references/event-definitions.md for step-by-step instructions", the "Open reference" routing column, and the troubleshooting "when:" bullets). References are one level deep and easy to navigate, matching anchor 5 exactly. | 5 / 5 |
Total | 20 / 20 Passed |