Content
72%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is a well-structured, lean process guide with concrete file paths and commands, but it stops short of fully executable specifics in several steps and lacks explicit validation checkpoints in its workflow.
Suggestions
Add a concrete trajectory-example template or snippet in the 'Write JTBD-like trajectory examples' section instead of only pointing to the Product analytics preset.
Insert explicit validation checkpoints into the flow (e.g., 'run the mode's tests; if failing, fix tool/scaffolding and re-run') to add a validate→fix→retry feedback loop.
For the scaffolding step, show the minimal AgentToolkit/AgentModeDefinition skeleton so the guidance is copy-paste ready rather than purely descriptive.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and concrete — specific file paths and commands earn their tokens, and the intro paragraph explains the PostHog-internal mode architecture rather than generic concepts Claude already knows. | 3 / 3 |
Actionability | It provides concrete file paths, commands (`hogli build:schema`), and one real code snippet, but several steps are directional without executable specifics — e.g., 'Write JTBD-like trajectory examples ... Check the Product analytics preset for reference' gives no concrete example to follow. | 2 / 3 |
Workflow Clarity | Steps are clearly sequenced via section headers (name → schema → scaffolding → tools → toolkit → examples → frontend → flag → tests), but validation checkpoints are only implicit/scattered (verify backend-first, run tests at the end) with no explicit validate→fix→retry feedback loop. | 2 / 3 |
Progressive Disclosure | It is a single, well-organized file with clear section navigation and no nested references; no bundle files exist, so the appropriately-contained overview with well-signaled sections fits the simple-skill case. | 3 / 3 |
Total | 10 / 12 Passed |