What problem does it solve? Skills in a PostHog skills store rot over time: vague descriptions that never get retrieved, bloated bodies, unbounded changelogs, and stale content. This Skill provides a compliance checklist, a 16-pattern house style guide, and a structured refactoring workflow to bring messy skills back into shape or start new ones correctly. ## Core Features & Use Cases - Spec compliance checklist: Statically verifiable rules from the Agent Skills spec and Anthropic best practices covering frontmatter, name format, description limits, body budget, link hygiene, and secrets. - 16 house patterns: Trigger-rich descriptions, thin index bodies, progressive-disclosure file maps, HANDOVER.md clobber files, rolling-window changelogs, issues/ backlogs, and maintenance contracts. - Refactoring workflow: An audit → design → execute → verify → log process with a smell checklist and reliable write mechanics (smallest edit primitive, base_version chaining, sentinel appends for large files). - Use Case: Given a store skill whose changelog grew to 66 KB and whose body mixes session state with reference content, run the audit checklist, split content into bundled files, convert the changelog to a rolling window, and rewrite the description with concrete trigger phrases. ## Quick Start Ask the agent to audit my PostHog store skill against the spec checklist and house patterns, then refactor it into a thin index body with bundled reference files.
