Dev & Engineering ✓ Microsoft · Official error-telemetrystack-trace-analysisdata-validationipcunit-testingbuild-validation

VS Code Telemetry Error Fix Guide

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

FollowSkills review · FSRS-2.0
Not recommended
52/ 100 5-point scale 2.6 / 5
Trust16 / 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.

Reliability9 / 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.

Adaptability10 / 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.

Convention8 / 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.

Effectiveness6 / 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.

Verifiability3 / 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.

Evidence confidence:Low Reviewed Jul 20, 2026 Reviewed revision 5b3e1be7be9e
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.
See the full review method →

What it does & when to 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.

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

Pros & cons

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 to install

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.

How to use

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.

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

Tool Rename Compatibility Check

Protect existing prompts and tool configurations when built-in tools are renamed.

Dev & Engineering ✓ Microsoft · Official

Copilot Chat OpenTelemetry Instrumentation

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

Dev & Engineering ✓ Microsoft · Official

VS Code Configuration Policy Maintainer

Standardize VS Code policy registration, export, and validation.

Design & Frontend ✓ Microsoft · Official

VS Code Design Philosophy

Turn vague UI discomfort into concrete fixes using shared values, principles, and design moves.

Dev & Engineering ✓ Microsoft · Official

Agent Host E2E Test Assistant

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

Dev & Engineering ✓ Microsoft · Official

VS Code Integrated Browser Architecture

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

Dev & Engineering ✓ Microsoft · Official

VS Code Agents Window Sessions

Safely implement and repair VS Code Agents window features.

Dev & Engineering ✓ Microsoft · Official

Commit Assistant

Creates repository-style commit messages and safely commits code changes.

Dev & Engineering ✓ Microsoft · Official

Agent Host Log Investigator

Trace session, transport, and host failures in Agent Host debug exports.

Dev & Engineering ✓ Microsoft · Official

VS Code Unit Test Runner

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

Dev & Engineering ✓ Microsoft · Official

VS Code Agent Customization Assistant

Create, repair, and troubleshoot VS Code Agent customization files and their loading behavior.

Dev & Engineering ✓ Microsoft · Official

Code OSS Launch & Debug

Launch a built-from-source VS Code with isolated profiles, Playwright control, and multi-process debugging ports.

Dev & Engineering ✓ Microsoft · Official

VS Code Accessibility Development Guide

A practical specification for accessible interactive features in VS Code.

Design & Frontend ✓ Microsoft · Official

VS Code CSS Layout Standards

Build reliable VS Code-style CSS layouts and text truncation behavior

Dev & Engineering ✓ Microsoft · Official

VS Code Chat Performance Lab

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

Dev & Engineering ✓ Microsoft · Official

Component Fixtures for Screenshot Testing

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

Dev & Engineering ✓ Microsoft · Official

VS Code Smoke Test Assistant

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

Dev & Engineering ✓ Microsoft · Official

VS Code Crash Dump Symbolicator

Turn native VS Code crash dumps into readable backtraces with method names.

Dev & Engineering ✓ Microsoft · Official

Local VS Code Web Workbench

Validate VS Code workbench and Agents window changes in a local vscode.dev instance.

Dev & Engineering ✓ Microsoft · Official

Feedback Action

Reads current-session feedback and applies the requested code changes.

Related skills