CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

symbolicate-crash-dump

Symbolicate a native VS Code crash dump (.dmp) using electron-minidump. Use when given a crash dump file, asked to symbolicate a crash, resolve missing method names in a native crash backtrace, or attach Electron/Insiders/Stable symbol files. VS Code team members only; requires macOS or Linux.

Quality

95%

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

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

The content is a strong, highly actionable runbook: concrete executable commands throughout, a well-sequenced procedure with real validation checkpoints and feedback loops, and deep non-obvious domain knowledge (debug-id matching, private symbol repo access, Electron version discovery). The only notable weakness is mild redundancy and a few over-explanations that could be trimmed for token efficiency, and supporting sections could be split into references.

Suggestions

Consolidate the exact-debug-id-matching guidance, which currently appears in step 3's body, its warning callout, and the Tips section, into a single authoritative location.

Trim explanations of concepts Claude already knows, such as "Keep the tilde outside quotes so it expands to your home directory", keeping only the command itself.

Consider moving the supporting sections "Reading the result" and "Remote Extension Host crashes (Linux, gdb)" into one-level-deep reference files to shorten the always-loaded SKILL.md body.

DimensionReasoningScore

Conciseness

The body is dense with genuinely non-obvious domain knowledge (breakpad debug-id cache layout, private-repo auth, Electron-version tagging, hash-exact symbol matching) that Claude would not know, so it mostly respects the token budget. It sits at 4 rather than 5 due to minor over-explanation — e.g. "Keep the tilde outside quotes so it expands to your home directory" (basic shell knowledge), and the exact-debug-id-matching point stated three times (step 3 body, the step 3 callout, and Tips).

4 / 5

Actionability

Every step is backed by copy-paste-ready commands with real-world specifics: the retry loop for transient download errors, `gh release download v42.5.0-14525058 --repo microsoft/vscode-electron-prebuilt --Pattern "stable-symbols-v42.5.0-win32-x64.zip"`, the `cp` with a concrete debug-id example, `strings -a crash-file.dmp | grep ...`, and the full gdb command set. Concrete examples cover the common cases (Windows/macOS, Insiders/Stable/OSS), matching the 5 anchor.

5 / 5

Workflow Clarity

The procedure is a clear four-step sequence with explicit validation checkpoints ("Inspect symbolicated-output.log... if a frame names a module... but has no method name after it, symbols for that module are required"; "confirm the same module/hash exists in the zip before copying it in") and a feedback loop ("If some frames are still bare, return to step 2"), plus transient-error retry and a no-matching-symbols fallback. This matches the 5 anchor; the operations are read-only so the destructive/batch cap does not apply.

5 / 5

Progressive Disclosure

The skill is self-contained (no bundle files exist) with well-organized headers, a decision table for symbol sources, and internal anchor links making navigation easy. It scores 4 rather than 5 because at ~180 lines the under-50-line simple-skill exception doesn't apply and supporting topics ("Reading the result", "Remote Extension Host crashes (Linux, gdb)") could plausibly live in one-level-deep reference files; it stays above 3 because structure is clear and nothing is buried.

4 / 5

Total

18

/

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 tool and domain, lists concrete capabilities, and provides an explicit multi-phrase "Use when..." trigger clause including the .dmp file extension. The scope constraints (team-only, macOS/Linux) further sharpen when it applies. No weaknesses identified.

DimensionReasoningScore

Specificity

The description lists multiple specific concrete actions — "Symbolicate a native VS Code crash dump (.dmp) using electron-minidump", "resolve missing method names in a native crash backtrace", and "attach Electron/Insiders/Stable symbol files" — with the tool named. This matches the 5 anchor (multiple specific concrete actions, comprehensive coverage) rather than 4, because all primary capabilities of the skill are enumerated and the only unlisted work (result interpretation) is supporting rather than a coverage gap.

5 / 5

Completeness

It explicitly answers both questions: the "what" in "Symbolicate a native VS Code crash dump (.dmp) using electron-minidump" and the "when" via an explicit "Use when given a crash dump file, asked to symbolicate a crash, resolve missing method names..., or attach... symbol files" clause with concrete trigger phrases. It also adds scope constraints ("VS Code team members only; requires macOS or Linux"), matching the 5 anchor exactly rather than 4 where the "when" is less explicit.

5 / 5

Trigger Term Quality

Natural trigger phrases a VS Code team member would actually say are covered: "crash dump file", "symbolicate a crash", "native crash backtrace", "missing method names", "symbol files", plus the ".dmp" file extension and Insiders/Stable/Electron synonyms. This matches the 5 anchor (comprehensive natural terms including synonyms and file extensions); nothing common is missing.

5 / 5

Distinctiveness Conflict Risk

The skill occupies a clear niche — native VS Code crash dump symbolication via electron-minidump — with distinct triggers (.dmp files, symbolication requests, symbol attachment) that no generic skill would claim. This matches the 5 anchor (clear niche, distinct triggers, minimal conflict risk); it is far more specific than the 4 anchor's "minor overlap risk with closely related skills".

5 / 5

Total

20

/

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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

microsoft/vscode

Path

.github/skills/symbolicate-crash-dump/SKILL.md

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.