Content
85%Weight 40%Scale 1-3Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is well-structured and actionable with concrete templates and clear decision logic, scoring well on actionability, workflow clarity, and progressive disclosure. Its main weakness is conciseness: a speculative future-mode section and some re-stated detection content consume tokens that could be trimmed.
Suggestions
Cut or condense the 'The slack mode (when it exists)' section to a one-line forward note, since it cannot fire in the current version and adds ~13 lines of non-actionable content.
Tighten 'Detecting that you're outside PostHog Desktop' to avoid restating the client-kind list already given in the intro; lead with the tool-surface signal it identifies as the reliable check.
Consider collapsing the comparison table's redundant prose into the table itself to reduce surrounding explanation.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly lean and skill-specific without over-explaining known concepts, but the speculative 'The slack mode (when it exists)' section (~13 lines that will not fire in v0) and the 'Detecting that you're outside PostHog Desktop' section restating the intro add tokens that could be tightened. | 2 / 3 |
Actionability | For an instruction-only skill it gives concrete, copy-pasteable templates (the blockquote reference/summary examples) and specific numeric guidance ('1-3 tool calls per turn', 'A 200-line agent.md is OK; a 2000-line source is not'), which is actionable rather than abstract. | 3 / 3 |
Workflow Clarity | Compensating moves are sequenced (1-3) and the 'Detecting' section lays out explicit decision branches (focus_*/toast present → PostHog Desktop; absent → text-only); no destructive or batch operations require validation loops here. | 3 / 3 |
Progressive Disclosure | A single self-contained SKILL.md organized into well-labeled sections with no need for external bundle references (no references/scripts/assets exist); the inline file paths are illustrative user-facing examples, not nested skill references, so well-organized sections suffice for a 3. | 3 / 3 |
Total | 11 / 12 Passed |