CtrlK
BlogDocsLog inGet started
Tessl Logo

diagnosing-endpoint-performance

Diagnose why a PostHog endpoint is slow or expensive and propose a concrete fix — bump the cache TTL, enable materialisation, restructure variables, or rewrite the query. Use when the user says "this endpoint is slow", "my endpoint times out", "we're hitting the cost cap on this one", or asks "should I materialise this?". Focuses on a single named endpoint, not a project-wide audit.

77

Quality

96%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

92%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A highly actionable, well-sequenced deep-dive with executable guidance and proper validation loops; its only weakness is progressive disclosure, since all detail lives inline in one long file rather than being split into signaled reference files.

Suggestions

Move the detailed materialisation rewrite patterns (cohort/compare, JOIN+variables, missing variables, HogQL pitfalls) and the query_log SQL snippet into a referenced file such as references/materialization-patterns.md, keeping SKILL.md as a tighter overview that links one level deep.

Extract the Available tools table into a references/tools.md (or keep a one-line summary inline) so the core decision tree and workflow stay foregrounded in the main file.

Tighten the Example interaction's internal monologue to the key diagnosis and recommendation, trimming the explanatory prose that re-states points already covered in the decision tree.

DimensionReasoningScore

Conciseness

Dense PostHog-specific operational detail (TTL enum values, JOIN+variable materialisation trap, eligibility contract) with no generic concept padding Claude already knows; every section earns its place despite minor repetition in the closing notes.

3 / 3

Actionability

Names exact tools, gives a copy-paste query_log SQL block, concrete decision-tree branches, and the literal API path to parse the endpoint name from — fully executable, not pseudocode.

3 / 3

Workflow Clarity

A numbered workflow and ordered decision tree carry explicit validation checkpoints ("compare the results; only then apply", "confirm before applying it", "confirm first"), providing the validate→fix→retry loops the destructive query-rewrite step needs.

3 / 3

Progressive Disclosure

Sections are well organized with easy navigation, but the skill is a ~190-line monolith with all detail inline and no reference files; the under-50-line simple-skill exemption does not apply, so the split-into-references pattern of the top anchor is only partially met.

2 / 3

Total

11

/

12

Passed

Description

100%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: concrete actions, natural quoted triggers, and an explicit when-to-use clause, all in third person and tightly scoped to a single PostHog endpoint.

DimensionReasoningScore

Specificity

Lists four concrete named fixes — "bump the cache TTL, enable materialisation, restructure variables, or rewrite the query" — matching the anchor for multiple specific concrete actions rather than the partial-action level below.

3 / 3

Completeness

Explicitly answers both what (diagnose and propose a concrete fix) and when ("Use when the user says…"), with an explicit trigger clause rather than leaving timing implied.

3 / 3

Trigger Term Quality

Quoted natural user phrases ("this endpoint is slow", "my endpoint times out", "we're hitting the cost cap on this one", "should I materialise this?") give good coverage of what a user would actually say, not just jargon.

3 / 3

Distinctiveness Conflict Risk

Scoped to "a single named endpoint, not a project-wide audit" with PostHog-specific triggers, carving a clear niche unlikely to fire for unrelated skills.

3 / 3

Total

12

/

12

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
PostHog/posthog
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.