CtrlK
BlogDocsLog inGet started
Tessl Logo

debugging-surveys

Diagnose PostHog Surveys configuration and responses across all five SDKs (web/posthog-js, iOS, Android, Flutter, React Native). Use whenever a Surveys support ticket is pasted ("survey not showing", "fewer responses than expected", "responses disappeared", "responses are incomplete", "only the first question was answered", "the user says they didn't mean to submit", "survey shows on wrong platform"), or when diagnosing why a survey does or doesn't display. Covers the eligibility pipeline, how a response actually gets stored (partial responses, branching, optional questions, auto-submit), cross-SDK feature parity, the known-cause catalog, read-only diagnostic queries, staff access, and the customer-reply style guide.

71

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

—

The risk profile of this skill

SKILL.md
Quality
Evals
Security

Quality

Content

77%Weight 40%Scale 1-5

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

A richly detailed, highly actionable diagnostic skill with a well-sequenced workflow and explicit validation checkpoints. Its main weakness is progressive disclosure: the body repeatedly links to reference files (reading-responses.md, diagnostic-queries.md) that do not exist in the bundle, leaving navigation broken and forcing the reader to rely on inline prose.

Suggestions

Add the missing references/reading-responses.md and references/diagnostic-queries.md files to the bundle (or remove the links) — the body points to them multiple times but neither exists, so the documented navigation dead-ends.

Move the bulkier inline material (the full known-cause catalog or the cross-SDK parity table) into a reference file to shorten SKILL.md and tighten conciseness from a 4 toward a 5.

Inline one or two representative HogQL query templates (e.g. the survey shown vs sent comparison) so the skill stays actionable even when the diagnostic-queries.md reference is unavailable.

DimensionReasoningScore

Conciseness

Dense with high-signal domain knowledge Claude lacks (SDK source paths, internal pipeline, parity table) and it avoids explaining basics, but several prose passages (e.g. the two-implementation wait-period explanation and the reply style guide) run long and could be trimmed. Anchor 4 ("efficient; minor instances of over-explanation that could be trimmed") fits better than 5 because not quite every token earns its place across ~285 lines.

4 / 5

Actionability

Provides concrete, executable guidance — specific endpoints ("GET /api/projects/<id>/surveys/<sid>/"), the HogQL helper signature "getSurveyResponse(<index>, '<questionId>')", activity-log URLs, and grep targets ("frontend/src/scenes/surveys/"). It stops short of 5 because the actual query templates and response-reading formats are deferred to references rather than given inline, leaving a minor gap.

4 / 5

Workflow Clarity

The "Debugging workflow" is a clearly sequenced 7-step process with explicit validation checkpoints — "Disambiguate none vs fewer" ("This single check redirects most investigations correctly"), step 2b, "Confirm with events," and "confirm with one targeted query" — and the "Before you call it an SDK bug" section is a 4-gate validation checklist for a risky conclusion. This matches anchor 5 (explicit validation steps plus a checklist for a complex process).

5 / 5

Progressive Disclosure

Structure and signaling are good — SKILL.md acts as an overview with clearly marked one-level-deep markdown links to references/reading-responses.md and references/diagnostic-queries.md — but those referenced files are absent from the bundle, so the navigation is broken. Per the guideline to score against the actual bundle structure, dangling references cap this at 3 rather than 4.

3 / 5

Total

16

/

20

Passed

Description

100%Weight 40%Scale 1-5

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

The description is exemplary: it names the domain, enumerates concrete capabilities, provides a rich set of natural trigger phrases, and clearly separates what from when in third-person voice. No fluff or over-claims despite its length; every clause carries signal.

DimensionReasoningScore

Specificity

Lists multiple concrete diagnostic actions and coverage areas — "Diagnose PostHog Surveys configuration and responses across all five SDKs," the eligibility pipeline, response storage ("partial responses, branching, optional questions, auto-submit"), "cross-SDK feature parity, the known-cause catalog, read-only diagnostic queries, staff access, and the customer-reply style guide" — comprehensive and concrete rather than abstract.

5 / 5

Completeness

Explicitly answers both halves: what ("Diagnose PostHog Surveys configuration and responses across all five SDKs…") and when ("Use whenever a Surveys support ticket is pasted (…) or when diagnosing why a survey does or doesn't display") with concrete trigger phrases. Voice is third person ("Diagnose", "Use").

5 / 5

Trigger Term Quality

Surfaces seven verbatim natural ticket phrases a user would actually say ("survey not showing", "fewer responses than expected", "responses disappeared", "responses are incomplete", "only the first question was answered", "the user says they didn't mean to submit", "survey shows on wrong platform") plus "diagnosing why a survey does or doesn't display" — comprehensive coverage of natural trigger terms.

5 / 5

Distinctiveness Conflict Risk

Occupies a narrow, well-defined niche — PostHog Surveys debugging across five named SDKs — with highly specific ticket-trigger phrases, making overlap with unrelated skills minimal.

5 / 5

Total

20

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 5 missing

Warning

referenced_paths_exist

Referenced path issues: 10 missing

Warning

Total

14

/

16

Passed

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.