Content
71%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.
The content is well-structured and actionable with concrete SQL and a clear diagnostic workflow, but it is undermined by three references to a non-existent ./references/ directory, leaving the core diagnosis logic and examples unreachable.
Suggestions
Create ./references/diagnostic-signals.md, ./references/diagnosis-logic.md, and ./references/examples.md so the inline links resolve — currently the references/ directory does not exist.
Inline the essential diagnosis-logic content (the verdict interpretation rules) into SKILL.md so Step 3 does not depend entirely on a missing file, keeping only the exhaustive signal catalog and examples external.
Verify each markdown link target exists before relying on it; the examples.md link is referenced from both Step 3 and the Examples section but is absent.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is largely lean, using tables, SQL, and a tight verdict list without explaining what PostHog or session replay is, with only minor over-explanation (e.g., 'The PostHog SDK emits diagnostic properties on every event...') that could be trimmed, fitting 'efficient; minor instances of over-explanation'. | 4 / 5 |
Actionability | It provides copy-paste-ready SQL and tool-call JSON plus a verdict and recommendations table, but Step 3 defers the core signal interpretation to a missing ./references/diagnosis-logic.md file, leaving a notable gap, matching 'mostly executable guidance; concrete code with minor gaps'. | 4 / 5 |
Workflow Clarity | The five-step workflow is clearly sequenced with a decision branch in Step 1 ('If this returns data... If it returns 404, proceed') and a prioritized verdict fallback, fitting 'clear sequence with most checkpoints present'; no destructive/batch cap applies since this is read-only diagnosis. | 4 / 5 |
Progressive Disclosure | The SKILL.md is well-organized and signals one-level-deep references to diagnostic-signals.md, diagnosis-logic.md, and examples.md, but none of those files (or the references/ directory) exist, so the navigation is broken and the deferred detail is inaccessible, matching 'references present but not clearly signaled / could be better organized'. | 3 / 5 |
Total | 15 / 20 Passed |