Content
76%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 highly actionable, well-structured reference for the PostHog skills API with comprehensive executable examples. Its main gaps are the missing validation/confirmation checkpoints around destructive operations and an inlined bridge-skill template that would be better as a bundled reference file.
Suggestions
Add an explicit validation/confirmation checkpoint to the skill-archive and full-bundle-replace workflows (e.g., 'Confirm the skill name with the user before archiving, since it cannot be undone') so destructive operations are not executed without verification.
Move the embedded local-bridge SKILL.md template into a bundled reference file (e.g. references/bridge-skill-template.md) and link to it, reducing body length and improving progressive disclosure.
Trim mildly chatty prose such as 'The whole point of descriptions is that you can pick the right skill without loading any bodies' to keep the body lean and token-efficient.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and mostly actionable with little concept over-explanation, but the fully embedded local-bridge SKILL.md template (~45 lines) and a few chatty lines ('The whole point of descriptions is...') could be trimmed or moved to a reference, fitting 'efficient; minor instances of over-explanation'. | 4 / 5 |
Actionability | It provides copy-paste-ready JSON tool-call examples covering every operation (list, get, file-get, create, update via body/edits/file_edits, file CRUD, rename, archive) plus concrete parameter-naming gotchas, fully covering the common cases. | 5 / 5 |
Workflow Clarity | Workflows are well sequenced with base_version concurrency checks, but destructive operations (skill-archive 'cannot be undone' and the `files` full-bundle replace that drops unlisted files) lack explicit validation/confirm checkpoints, so the rubric's destructive-operation cap applies. | 3 / 5 |
Progressive Disclosure | The body is well organized into clearly headed sections with no nested references and a helpful tool table, but at ~270 lines with no bundle files the inlined bridge-skill template is content that could be split into a reference, leaving minor organization gaps rather than ideal content separation. | 4 / 5 |
Total | 16 / 20 Passed |