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
Use with care
52/ 100 5-point scale 2.6 / 5
1 2 3 4 5 6
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.

Evidence confidence:Low Reviewed Jul 20, 2026 Reviewed revision 5b3e1be7be9e
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.
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 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.

  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.

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 do you install this skill?

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

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.

Dev & Engineering ✓ Microsoft · Official

Create Draft Pull Request

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

Dev & Engineering ✓ Microsoft · Official

GitHub Copilot SDK Upgrade Assistant

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

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

Copilot Chat OpenTelemetry Instrumentation

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

Dev & Engineering ✓ Microsoft · Official

CPU Profile Analyzer

Find performance bottlenecks in V8 and DevTools performance files.

Automation & Ops ✓ Microsoft · Official

Azure Pipelines Validation Assistant

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

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 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 Chat Customizations Editor Skill

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

Dev & Engineering ✓ Microsoft · Official

VS Code Integration Test Runner

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

Dev & Engineering ✓ Microsoft · Official

Memory Leak Audit

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

Dev & Engineering ✓ Microsoft · Official

Code OSS Development Log Viewer

Locate and inspect the latest Code OSS development logs.

Dev & Engineering ✓ Microsoft · Official

Project Instruction Builder

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

Dev & Engineering ✓ Microsoft · Official

Copilot Session Troubleshooter

Explain unexpected Copilot CLI behavior from session-log evidence.

Dev & Engineering ✓ Microsoft · Official

Workflow Skill Builder

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

Dev & Engineering ✓ Microsoft · Official

Copilot Chat Troubleshooter

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

Automation & Ops ✓ Microsoft · Official

CI Failure Fixer

Diagnose pull request CI failures and iterate toward a fix.

Related skills