Content
85%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 well-sequenced, highly actionable workflow with explicit validation and feedback loops, written concisely for a Claude that does not know PostHog specifics. Its main defect is a missing critical reference file that the body repeatedly depends on for drafting the manifest.
Suggestions
Ship references/manifest-reference.md in the bundle — the body treats it as 'the full RESTAPIConfig field reference' and instructs Claude to draft from it rather than guess field names, so its absence breaks the core drafting step.
Until the reference exists, inline a compact auth/paginator/cursor quick-reference table in SKILL.md so manifest drafting can proceed without the external file.
State the auth-payload-key rule once (e.g. in the Available tools or grammar section) and back-reference it from Steps 3–5 instead of restating 'the auth_token key varies by auth type' three times.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Dense and PostHog-specific (RESTAPIConfig, auth payload keys, alpha caps) without explaining basics Claude already knows, but the auth-payload-key caveat is restated across Steps 3–5 and secrets handling is repeated — minor trimming possible. | 4 / 5 |
Actionability | Provides a concrete JSON skeleton, exact tool names, exact call payloads with field names (e.g. { source_type: "Custom", manifest_json, auth_token }), and example error messages — copy-paste ready for the common cases. | 5 / 5 |
Workflow Clarity | Steps 0–5 are clearly sequenced with explicit validation (Step 3 db-schema) and feedback loops ("Loop here until it validates", "Iterate Steps 2–4 until the sample looks right") plus a guard check in Step 0. | 5 / 5 |
Progressive Disclosure | The body is structured as an overview pointing one level deep to references/manifest-reference.md, but that file is absent from the bundle, leaving the central drafting reference dangling and navigation broken. | 3 / 5 |
Total | 17 / 20 Passed |