Dev & Engineering ✓ Microsoft · Official

VS Code Telemetry Error Fix Guide

Trace unhandled telemetry errors to invalid-data producers instead of masking the crash site.

52/ 100
Use with care

Useful, but reliability, evidence or controls still have material gaps.

See how it was scored ↓
Works as-is in
Codex · Claude Code
Stars
★ 194k
Last updated
11d ago
License
MIT
error-telemetrystack-trace-analysisdata-validationipc
+2unit-testingbuild-validation

What does this skill do, and when should you use it?

This skill guides investigations of unhandled errors reported by the Visual Studio Code error telemetry dashboard. It uses the error message, stack trace, hit count, and affected-user count to trace invalid data through the call stack. It directs engineers to read the error-construction code before choosing between fixing the producer, enriching telemetry context, and recognizing threshold-based conditions that may be intentional. It also requires preserving error visibility and running relevant tests and build checks after changes.

Reads the error message, stack trace, hit count, and affected-user count from a telemetry issue; examines stack frames from the bottom upward to identify data origins, expected types, and possible corruption points; searches the codebase for the error class or a unique message substring and reads the construction logic and parameter meanings; when the producer is unknown, guides enrichment at the consuming site and low-level validation function with truncated type and value diagnostics while allowing the error to remain thrown; when the producer is known, guides validation or sanitization before sending, storing, or passing data to an API; and requires relevant unit tests plus a build-task compilation check.

Good fit
  • A VS Code maintainer needs to locate malformed data crossing a process boundary from an error-telemetry stack trace.
  • A developer is debugging type corruption originating in IPC, an extension API, storage, or user input.
  • An investigator cannot identify the producer from the receiving-side stack and needs diagnostic context for the next telemetry cycle.
  • A developer is fixing serialization of URI-like objects and must ensure objects are not sent as strings instead of the expected components.
  • A maintainer is investigating listener-leak errors whose categories and thresholds must be understood from the construction code.

How do you install this skill?

Before you use it
  • Even truncated error values sent to telemetry may expose personal data, tokens, or workspace content; sensitive-data redaction should occur before truncation with an explicit field policy.
  • The skill requests tests and build checks but does not define test selection, failure handling, or rollback steps for each error type; the operator must supply that verification plan.
  • Telemetry dashboards, repositories, and development services may depend on overseas connectivity; the document gives no offline or mainland-China-network fallback.
Before you start
Your agent needs
  • Shell / CLI
  • Local filesystem

The repository bundles 61 skills, but this profile covers only .github/skills/fix-errors/SKILL.md. The source does not document a standalone installation command for this skill; keep its skill directory in a location readable by an Agent Skills-compatible client. The repository as a whole is licensed under MIT.

Generic route: install into Claude Code manually (macOS / Linux)
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/microsoft/vscode.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/.github/skills/fix-errors" ~/.claude/skills/
rm -rf "$tmp"

Generated from the source repository and skill path; it copies only this skill's folder. If the author's install steps above differ, follow those first. To scope it to one project, replace ~/.claude/skills with that project's .claude/skills.

How do you use this skill?

Invoke the skill from an Agent Skills client that can access the VS Code source tree, issue details, and telemetry information. For example: Investigate this telemetry issue: error message ..., stack trace ..., hit count ..., affected users .... First find the error-construction code, then trace the invalid-data producer through the call stack. Follow the guidance to add truncated diagnostic context when needed, fix the producer, and run relevant unit tests and build checks. The source does not specify a client-specific command or trigger syntax.

What are this skill's strengths and limitations?

Pros
  • Clearly prioritizes finding the invalid-data producer over masking the failure with a guard at the crash site.
  • Requires reading error-construction code, helping distinguish categories, thresholds, and actionable conditions.
  • Provides a telemetry-enrichment strategy when the producer is not visible and preserves the thrown error.
  • Covers validation, serialization, testing, and compilation checks as part of the repair workflow.
Limitations
  • It is an investigation and repair guide, not an automatic fixer or standalone command-line tool.
  • The source does not provide a standalone installation process, a client-specific trigger command, or complete test commands.
  • Its scope is primarily VS Code error telemetry and related code paths, not general-purpose application error handling.
  • It requires access to the codebase and the ability to run relevant tests and build tasks; the source does not specify a complete runtime or platform matrix.

How does this skill compare with similar options?

Side by side with related skills; every score comes from the same FSRS standard.

Skill FS score Stars Last updated License
VS Code Telemetry Error Fix Guide this page ✓ Microsoft · Official 52 · Use with care ★ 194k 11d ago MIT
Verification Before Completion 48 · Use with care ★ 299k 15d ago MIT
RenderCV Testing Context 61 · Recommended ★ 18k 7mo ago MIT
NeMo AutoModel Model Onboarding ✓ NVIDIA · Official 60 · Recommended ★ 3.6k 11d ago Apache-2.0
Loki Prompt Optimization Skill 60 · Recommended ★ 1.1k 16d ago NOASSERTION

How did FollowSkills review this skill?

FollowSkills review · FSRS-2.0
Use with care
52/ 100 5-point scale 2.6 / 5
The upstream repository has new commits since this review. The score still applies to the reviewed revision shown and may not cover the latest changes.
1Trust16 / 25 · 3.2/5

The skill requires data-flow tracing, rejects silently swallowing errors, and instructs truncation of user-controlled values, reducing covert-exfiltration risk. It does not specify user confirmation, rollback, least-privilege boundaries, sensitive-data redaction, or telemetry-flow limits, so points are deducted.

2Reliability9 / 20 · 2.3/5

The guidance is internally coherent, distinguishes unknown from identifiable producers, and requests tests and compilation checks. However, there are no executable tests for this skill, abnormal-input coverage, or reproducible failure evidence. Static calibration limits this dimension to 10 or below.

3Adaptability10 / 15 · 3.3/5

The trigger, target problem type, and boundary against patching only the crash site are reasonably clear, with IPC, storage, and extension API examples. Non-fit ranges, an input/output contract, Chinese-language support, and mainland-China environment fit are not defined, so points are deducted.

4Convention8 / 15 · 2.7/5

The document has a clear name, description, staged workflow, positive and negative examples, and limitation-oriented guidance; repository evidence supplies MIT licensing and Microsoft attribution. The skill itself lacks versioning, changelog, maintenance ownership, update path, installation notes, and FAQs, so points are deducted.

5Effectiveness6 / 15 · 2.0/5

It offers actionable investigation and repair guidance for telemetry-reported unhandled errors, with useful examples. However, it provides no standard output format, representative verified results, or static evidence of completed fixes. Static calibration therefore limits this dimension to 7 or below.

6Verifiability3 / 10 · 1.5/5

The rules, code examples, and repository tests/CI are auditable, but the supplied CI is not focused on this skill's key paths and there is no independent reproduction or third-party execution evidence. Only limited points are justified.

1 2 3 4 5 6

Open a dimension to read why it scored that way

Reviewed Jul 20, 2026 Reviewed revision 5b3e1be7be9e Review evidence[1][2][3][4][5][6][7][8][9][10][11]

Evidence confidence:Low — Mostly static review, author material or a limited demo; useful for discovery, not high-risk decisions.

See the full review method →

FAQ

Does this skill automatically add a try/catch at the crash site?
No. It explicitly rejects silently swallowing errors, returning fallback values, or masking the root cause with a guard only in a shared utility function.
What should I do when the stack trace does not reveal the producer?
Add diagnostic context at the consuming site and, when appropriate, in the low-level validation function, including the type, a truncated value, and the relevant operation or command. Keep throwing so the error remains visible in telemetry.
Does it require network access or MCP?
The source shows no network calls or MCP requirement. It does require access to the codebase and asks the user to run relevant tests and build checks.
Does using this skill cost money?
The source identifies Code - OSS as MIT-licensed, but it does not provide separate pricing or standalone installation information for this skill.

More skills from this repository

All from microsoft/vscode

Dev & Engineering ✓ Microsoft · Official

VS Code Unit Test Runner

Run VS Code repository unit tests by file, test name, or compiled-output glob.

★ 194k FS 55 Use with care 11d ago
Dev & Engineering ✓ Microsoft · Official

Create Draft Pull Request

Validate the current session’s changes and open a draft PR through GitHub MCP.

★ 194k FS 38 Not recommended 11d ago
Dev & Engineering ✓ Microsoft · Official

GitHub Copilot SDK Upgrade Assistant

Upgrade and validate @github/copilot in the VS Code Copilot Chat project.

★ 194k FS 28 Not recommended 11d ago
Dev & Engineering ✓ Microsoft · Official

VS Code Integrated Browser Architecture

A practical architecture guide for safely changing VS Code's cross-process integrated browser.

★ 194k FS 56 Use with care 11d ago
Dev & Engineering ✓ Microsoft · Official

Copilot Chat OpenTelemetry Instrumentation

A repository-specific guide for consistent OpenTelemetry instrumentation in Copilot Chat.

★ 194k FS 60 Recommended 11d ago
Dev & Engineering ✓ Microsoft · Official

CPU Profile Analyzer

Find performance bottlenecks in V8 and DevTools performance files.

★ 194k FS 52 Use with care 11d ago
Automation & Ops ✓ Microsoft · Official

Azure Pipelines Validation Assistant

Validate VS Code Azure DevOps pipeline changes without waiting for full CI feedback.

★ 194k FS 47 Use with care 11d ago
Dev & Engineering ✓ Microsoft · Official

Agent Host E2E Test Assistant

Maintain VS Code Agent Host end-to-end tests with strict replay fixtures.

★ 194k FS 56 Use with care 11d ago
Dev & Engineering ✓ Microsoft · Official

VS Code Chat Performance Lab

Benchmark chat rendering and detect memory growth across VS Code builds.

★ 194k FS 53 Use with care 11d ago
Dev & Engineering ✓ Microsoft · Official

Component Fixtures for Screenshot Testing

Create stable, theme-aware VS Code component fixtures for isolated screenshot testing.

★ 194k FS 53 Use with care 11d ago
Dev & Engineering ✓ Microsoft · Official

VS Code Smoke Test Assistant

Run, filter, and debug VS Code end-to-end smoke tests.

★ 194k FS 53 Use with care 11d ago
Dev & Engineering ✓ Microsoft · Official

VS Code Chat Customizations Editor Skill

Guides developers through safe changes and testing for VS Code’s chat customization management UI.

★ 194k FS 52 Use with care 11d ago
Dev & Engineering ✓ Microsoft · Official

VS Code Integration Test Runner

Run and filter VS Code repository integration tests with the correct platform scripts.

★ 194k FS 52 Use with care 11d ago
Dev & Engineering ✓ Microsoft · Official

Memory Leak Audit

Systematically find and fix listener, lifecycle, and disposable leaks in VS Code code.

★ 194k FS 52 Use with care 11d ago
Dev & Engineering ✓ Microsoft · Official

Code OSS Development Log Viewer

Locate and inspect the latest Code OSS development logs.

★ 194k FS 51 Use with care 11d ago
Dev & Engineering ✓ Microsoft · Official

Project Instruction Builder

Turn conversation patterns and preferences into a durable project instruction file.

★ 194k FS 51 Use with care 11d ago
Dev & Engineering ✓ Microsoft · Official

Copilot Session Troubleshooter

Explain unexpected Copilot CLI behavior from session-log evidence.

★ 194k FS 51 Use with care 11d ago
Dev & Engineering ✓ Microsoft · Official

Workflow Skill Builder

Turns a conversation's working method into a reusable SKILL.md.

★ 194k FS 50 Use with care 11d ago
Dev & Engineering ✓ Microsoft · Official

Copilot Chat Troubleshooter

Explain unexpected agent behavior, latency, and tool failures from Copilot Chat debug logs.

★ 194k FS 49 Use with care 11d ago
Automation & Ops ✓ Microsoft · Official

CI Failure Fixer

Diagnose pull request CI failures and iterate toward a fix.

★ 194k FS 48 Use with care 11d ago

Related skills