Content
27%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The skill covers a broad range of product analytics topics with some useful executable code examples, but suffers from significant bloat with generic boilerplate sections that Claude doesn't need. The content would benefit greatly from splitting into focused sub-files, removing template filler, and adding proper workflow sequencing with validation steps. The mix of specific Auri product context with general analytics guidance creates confusion about whether this is a reusable skill or a project-specific reference.
Suggestions
Remove all generic boilerplate sections (When to Use, Do Not Use, Best Practices, Common Pitfalls, Limitations) — these waste tokens and Claude already knows this guidance.
Split the monolithic content into separate files (e.g., EVENTS.md, FUNNELS.md, AB-TESTING.md, COHORT.md) and use SKILL.md as a concise overview with clear references.
Add explicit validation/verification steps to workflows — e.g., after setting up event tracking, verify events appear in PostHog; after running A/B test calculations, validate sample size adequacy.
Fix the SQL bug in calculate_north_star (GROUP BY user_id should be in a subquery before the HAVING clause) and ensure all code examples are truly executable.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is bloated with generic boilerplate sections (When to Use, Do Not Use, Best Practices, Common Pitfalls, Limitations) that add no value and are things Claude already knows. The quote, the verbose overview that repeats the description, and the generic 'Related Skills' section all waste tokens. The domain-specific content (events, funnels, cohort analysis) is reasonable but is buried in filler. | 1 / 3 |
Actionability | The skill provides executable Python code for PostHog tracking, cohort retention calculation, A/B test significance, and feature flags, which is good. However, several sections are pseudocode-like or conceptual (funnel optimization steps, North Star framework), the commands table lists commands with no implementation details, and the SQL query in calculate_north_star has a bug (GROUP BY should be in a subquery). The code is partially actionable but incomplete in places. | 2 / 3 |
Workflow Clarity | The funnel optimization section provides a clear 6-step process, but lacks explicit validation checkpoints or feedback loops. The overall skill doesn't clearly sequence how to go from zero to a working analytics setup — it presents disconnected code snippets and concepts rather than a coherent workflow. No verification steps for event tracking setup or dashboard creation. | 2 / 3 |
Progressive Disclosure | The skill is a monolithic wall of text with no references to external files despite covering many complex topics (PostHog setup, cohort analysis, A/B testing, OKRs, feature flags) that would benefit from separation. No bundle files are provided. The commands table references actions like `/okr-template` with no supporting content. Everything is crammed into one long file with poor organization. | 1 / 3 |
Total | 6 / 12 Passed |