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.
An authoritative, highly actionable guide to a complex production workflow with strong sequencing and validation, undermined only by monolithic inlining and a dangling bundle reference. Conciseness is good but not lean, with some rationale repetition across sections.
Suggestions
Create the missing references/oauth-app-deployment.md (or remove the link) so the one signaled bundle reference resolves.
Split the large self-contained sections (multi-schema SQL parity checklist, warehouse-parent fan-out, vendor API version metadata) into reference files and link to them from SKILL.md to reduce the inline wall of text.
De-duplicate the unreleasedSource guidance — state it once in the workflow step and reference it from the checklist and pitfalls instead of restating the full rationale three times.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with PostHog-specific operational knowledge Claude would not already know, so most tokens earn their place; however the unreleasedSource rationale is repeated across step 13, the checklist, and common pitfalls, and several rationale paragraphs run longer than strictly necessary. | 4 / 5 |
Actionability | Copy-paste-ready commands ('pnpm run generate:source-configs', 'hogli build:openapi', 'DEBUG=1 python manage.py makemigrations'), concrete file paths, and executable code snippets cover the common cases end-to-end. | 5 / 5 |
Workflow Clarity | A 15-step end-to-end workflow with an explicit verification checklist (curl against the live API, run tests, ruff), an implementation checklist, and feedback loops (verify-then-fix) gives clear sequencing with validation checkpoints for this batch/data-sync operation. | 5 / 5 |
Progressive Disclosure | Section headers and a 'Read first' block give structure, but the skill is a monolithic ~890-line file with content that belongs in separate references (multi-schema SQL checklist, warehouse-parent fan-out, OAuth deployment) inlined, and its one signaled bundle reference, references/oauth-app-deployment.md, does not exist in the empty references/ directory. | 3 / 5 |
Total | 17 / 20 Passed |