Content
100%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 tight, actionable diagnostic playbook: domain-specific reference tables, concrete tool/filter guidance, an executable SQL fallback, and a well-sequenced broad-to-narrow workflow ending in a handoff decision. It assumes Claude's competence and avoids generic concept explanations. Minor only: the worked example interaction is the longest section and could be trimmed if token budget tightens.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean and information-dense throughout — token tables, tool tables, filter syntax, and an executable SQL snippet — with every section adding PostHog-specific knowledge (log_entries store, log_source_id UUID, ~90-day TTL) rather than generic concepts Claude already knows; not the padded/concept-explaining anchor (1) or the slightly-over-explained anchor (2). | 3 / 3 |
Actionability | Provides concrete tools (endpoint-logs, endpoint-get, execute-sql), exact filter syntax (level=ERROR, search=cache=miss, limit 1–500), and a copy-paste-ready SQL aggregation query with the correct log_source/log_source_id predicates; not vague direction (1) or pseudocode (2). | 3 / 3 |
Workflow Clarity | Five clearly sequenced steps (identify → start broad → narrow by symptom with branches → aggregate via SQL → summarize/handoff) where the broad-to-narrow narrowing acts as the feedback loop; the destructive/batch validation cap does not apply because this is read-only log diagnosis, so it clears the 3 bar despite lacking hard validate-gate checkpoints. | 3 / 3 |
Progressive Disclosure | No bundle files exist, and the single self-contained file is well-sectioned (When to use, entry anatomy, tools, filtering, workflow, example, notes) with no nested references; the inline tables and SQL are core reference material that belongs in SKILL.md, not a monolithic wall (1) or misplaced-inline bulk (2). | 3 / 3 |
Total | 12 / 12 Passed |