CtrlK
BlogDocsLog inGet started
Tessl Logo

auditing-endpoints

Audit every endpoint in a PostHog project for staleness, failed materialisations, and unused materialised versions. Use when the user asks "what endpoints can I clean up?", "are any of my endpoints broken?", "which materialised versions are still being called?", or wants a one-shot cleanup pass over the Endpoints product. Produces a prioritised report grouped by issue type, with recommended actions but does not modify anything without explicit confirmation.

75

Quality

92%

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

85%

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 skill body with concrete SQL, tool guidance, and guarded feedback loops. Its only weakness is repetition: the API-key-only caveat and the example section restate earlier content.

Suggestions

State the 'usage counts only personal-API-key calls' caveat once (e.g. in 'What counts as an issue') and reference it from the workflow and example instead of repeating it three times.

Trim the Example Interaction section or recast it as a compact 'sample report' that does not re-walk the full workflow, since the Workflow section already covers the steps.

Fold the 'Important notes' bullets that merely restate earlier guidance (read-only, SQL read path, API-key-only) into their original sections, keeping only net-new cautions there.

DimensionReasoningScore

Conciseness

Mostly efficient and focused on PostHog-specific details Claude would not know, but repeats itself: the 'personal-API-key only' caveat appears three times (workflow, example, and Important notes), and the Example Interaction section largely restates the Workflow's report format and findings.

2 / 3

Actionability

Provides fully executable SQL queries against named tables/columns, concrete tool calls, a copy-paste-ready report template, and specific next-step questions tied to exact endpoint-update parameters — copy-paste ready.

3 / 3

Workflow Clarity

A clear 5-step sequence with explicit checkpoints ('No rows → say so and stop'), cross-referencing between steps, and confirm-before-act feedback loops guarding the destructive write path, matching the top anchor.

3 / 3

Progressive Disclosure

No bundle files exist, so all content lives in SKILL.md, but it is organized into clear, navigable sections (When to use, Available tools, What counts as an issue, Workflow, Important notes) with no nested reference chains — well-organized for discovery.

3 / 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 capabilities, verbatim natural-language triggers, and explicit what/when guidance with a clear, distinct niche. It scores at the top of every dimension.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — 'Audit every endpoint ... for staleness, failed materialisations, and unused materialised versions' and 'Produces a prioritised report grouped by issue type, with recommended actions' — matching the top anchor for multiple specific concrete actions.

3 / 3

Completeness

Explicitly answers both what (audit endpoints / produce a prioritised report) and when ('Use when the user asks ...'), with an explicit 'Use when' trigger clause, hitting the top anchor.

3 / 3

Trigger Term Quality

Quotes natural user phrasings verbatim — 'what endpoints can I clean up?', 'are any of my endpoints broken?', 'which materialised versions are still being called?' — giving good coverage of terms a user would actually say.

3 / 3

Distinctiveness Conflict Risk

Scoped to a clear niche (PostHog Endpoints product auditing) with distinct triggers and an explicit hand-off boundary ('does not modify anything without explicit confirmation'), making overlap with other skills unlikely.

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.