Content
88%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 strong, actionable audit workflow rich in non-obvious PostHog domain detail, with clear sequencing and validation checkpoints. The main weakness is redundancy between the workflow body and the closing 'Important notes' recap, plus no use of bundle files to offload detail.
Suggestions
Collapse the 'Important notes' section into the workflow steps where each point first arises, or trim it to only the points not already covered inline, to remove the recap redundancy.
Consider moving the detailed Step 4 webhook diagnostics and the report template into a references/ file (signaled one level deep) to slim the main SKILL.md and improve progressive disclosure.
The out-of-scope routing (materialized views, destinations, transformations) is stated three times (intro, issue table, Important notes) — consolidate to a single authoritative statement.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The bulk is lean, domain-specific knowledge Claude would not already have (endpoint categories, status mappings, webhook edge cases), but the 'Important notes' section largely restates points already made in the body (read-only, empty=healthy, cascade, billing, active-failures-only, out-of-scope routing) and could be trimmed. | 4 / 5 |
Actionability | Highly actionable for an instruction-only skill: names specific tools, filter types ('source', 'external_data_sync'), status values ('failed', 'billing_limit'), concrete prioritization order, a copy-paste report template, and exact webhook-info-retrieve field interpretations. | 5 / 5 |
Workflow Clarity | Five clearly sequenced steps with explicit checkpoints — the empty-state guard in Step 1 ('tell the user their sources are healthy and stop'), ordered prioritization, a report template functioning as a checklist, and a read-only enforcement hand-off in Step 5. | 5 / 5 |
Progressive Disclosure | Well-organized into clear headed sections (When to use, Available tools, What counts as an issue, Workflow, Important notes) making navigation easy, but it is a single ~155-line file with no external references and some inline redundancy between body and notes; above the 50-line simple-skill threshold so it does not qualify for the no-reference 5. | 4 / 5 |
Total | 18 / 20 Passed |