CtrlK
BlogDocsLog inGet started
Tessl Logo

diagnosing-stacktrace-symbolication

Help users debug PostHog Error Tracking stack-trace symbolication for any supported platform — JavaScript/TypeScript web, React Native (Hermes), Android (Proguard / R8), or iOS / macOS (dSYM). The PostHog symbol-set lookup flow is universal across platforms; build-tool and artifact details live in per-platform references (JavaScript is fleshed out, others come as we encounter them). Use when stack frames stay minified or obfuscated after symbols are uploaded, PostHog symbol sets show last_used but frames are not readable, chunk IDs or dSYM UUIDs do not match, "Token not found" appears, uploaded source maps / dSYMs / Proguard mappings look empty, or bundler / symbol-upload configuration needs troubleshooting.

73

Quality

90%

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%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 well-structured diagnostic skill body with executable commands, a sequenced workflow including validation checkpoints and a failure matrix, and clean one-level-deep references to a real platform file. Only mildly improvable on conciseness of the intro framing.

DimensionReasoningScore

Conciseness

Dense and mostly assumes Claude's competence without explaining basics, though the opening definitional paragraph and a few framing sentences could be trimmed.

4 / 5

Actionability

Copy-paste-ready commands (posthog-cli symbol-sets extract with npx/bunx variants), exact MCP tool calls with arguments, concrete TS config, and specific row-field interpretations cover the common cross-platform cases.

5 / 5

Workflow Clarity

A clearly sequenced 5-step pipeline with explicit checkpoints ('If local artifacts already look wrong, fix the build before debugging the upload'), a decision-matrix feedback loop in Step 4, and a failure matrix checklist for error recovery.

5 / 5

Progressive Disclosure

SKILL.md is a clean cross-platform overview that defers platform specifics to a verified one-level-deep reference (./references/javascript.md) via a clearly signaled table, with bulk detail correctly split out.

5 / 5

Total

19

/

20

Passed

Description

87%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.

A precise, third-person description that clearly scopes a niche diagnostic domain and pairs a concrete 'what' with an explicit, scenario-rich 'when' clause. Slightly heavy on technical jargon over natural synonyms, but highly distinctive and actionable.

DimensionReasoningScore

Specificity

Names the domain and lists several concrete diagnostic scenarios (frames stay minified, 'Token not found', empty uploads, mismatched chunk IDs), though the core action narrows to debug/troubleshoot rather than a broad set of distinct operations.

4 / 5

Completeness

Explicitly states what the skill does (debug cross-platform PostHog symbolication) and gives a concrete 'Use when...' clause enumerating specific triggering conditions.

5 / 5

Trigger Term Quality

Strong domain terms users would actually hit ('Token not found', 'source maps', 'dSYM', 'Proguard', 'chunk IDs'), but coverage leans technical and omits some natural synonyms or file extensions.

4 / 5

Distinctiveness Conflict Risk

A narrow, well-defined niche (PostHog Error Tracking symbolication) with distinctive triggers like 'Token not found' and symbol-set row fields, minimizing overlap with other skills.

5 / 5

Total

18

/

20

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.