Dev & Engineering ✓ Microsoft · Official

VS Code Performance Investigation Workflow

Automate repeatable VS Code scenarios and collect performance and memory evidence.

47/ 100
Use with care

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

See how it was scored ↓
Works as-is in
Claude Code
Stars
★ 194k
Last updated
11d ago
License
MIT
vscodeperformance-profilingmemory-investigationheap-snapshot
+2playwrightchat-smoke-testing

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

This skill drives Code OSS through repeatable VS Code scenarios and collects performance, memory, and UI-verification evidence. It can run the bundled Chat memory smoke test, sample renderer heap usage, and produce screenshots, summary.json, and selected heap snapshots. When object-level investigation is needed, it hands the captured data to the generic heap-snapshot-analysis skill. It is intended for engineering investigations where the scenario must be proven to have completed before memory growth or leaks are analyzed.

Defines a warmup action, repeatable iteration, and quiescent sampling point; runs chat-memory-smoke.mts with Node.js or uses it as a pattern for a scratchpad runner; launches Code OSS and connects to it over CDP with Playwright; sends Chat prompts, waits for responses, samples renderer heap usage, and saves screenshots; writes summary.json, heap samples, and optional .heapsnapshot files; checks errors, response counts, response text, snapshot labels, and screenshots; and hands snapshots to heap-snapshot-analysis for comparisons and retainer-path analysis when required.

Good fit
  • A VS Code engineer suspects that repeated Chat conversations increase memory and needs a multi-turn run with warmed-up baseline and later heap snapshots.
  • A developer needs to investigate a leak in a non-Chat VS Code workflow and wants to create a one-off runner, validate it without snapshots, and then capture targeted snapshots.
  • An automation run may be stuck on authentication, workspace trust, progress UI, or the wrong workbench target, and the investigator needs Playwright snapshots and workspace-local screenshots to diagnose it.
  • A suspected product-code leak has been fixed and the engineer needs to rerun the same scenario with the same snapshot labels for a like-for-like comparison.

How do you install this skill?

Before you use it
  • Runs use a real VS Code instance and may send prompts to a real Copilot/LLM or execute tools; require an isolated disposable workspace and explicit user confirmation.
  • Persistent user-data may contain authentication secrets; never upload or share it, and do not copy it while Code is running.
  • The default workspace and instructions to modify product code and run all tests may expand scope; confirm target paths, change boundaries, and rollback before execution.
  • Core operation depends on npm, Playwright, Electron downloads, and Copilot authentication; mainland-China network reliability is not established by the supplied material.
Before you start
Your agent needs
  • Shell / CLI
  • Network access
  • Local filesystem
Install first
  • Node.js
  • @playwright/cli
  • Code OSS

The source does not provide a standalone installer or client registration procedure. First obtain the repository:

git clone https://github.com/microsoft/vscode.git
cd vscode

The skill is located at .github/skills/auto-perf-optimize/SKILL.md. Make that skill directory available according to the skill-directory rules of the Agent Skills client you use; the client-specific registration steps are not documented in the source.

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/auto-perf-optimize" ~/.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?

Try saying

Once installed, send your agent any of these to trigger it:

  • launch VS Code, repeat this scenario, and investigate whether memory grows

From the repository root, run the Chat smoke test, for example:

node .github/skills/auto-perf-optimize/scripts/chat-memory-smoke.mts --iterations 3 --no-heap-snapshots

To capture selected post-warmup snapshots, run:

node .github/skills/auto-perf-optimize/scripts/chat-memory-smoke.mts --iterations 8 --heap-snapshot-label 03-iteration-01 --heap-snapshot-label 03-iteration-08

A request such as “launch VS Code, repeat this scenario, and investigate whether memory grows” can invoke the workflow. For a non-Chat scenario, specify the starting action, what counts as one iteration, how settled UI state is recognized, and whether the profile should be persistent or temporary. If snapshots already exist and only heap-object analysis is needed, use heap-snapshot-analysis directly.

What are this skill's strengths and limitations?

Pros
  • Includes a runnable Chat memory smoke runner with a fast no-snapshot health check and targeted snapshot labels.
  • Requires summary.json and screenshots to verify the scenario before heap analysis, reducing the risk of analyzing an incorrect UI state.
  • Supports persistent profiles, temporary profiles, and seeded copies of logged-in profiles.
  • Covers scenario design, runner development, artifact capture, verification, analysis handoff, and post-fix reruns.
  • The repository source is licensed under MIT.
Limitations
  • Runs on the real machine: the Chat runner launches full Code OSS, sends prompts to a real LLM, and may execute real terminal commands or file edits through agent tool calls.
  • Chat investigations may require Copilot authentication, and user-data directories can contain authentication secrets.
  • Only the Chat runner is explicitly provided; non-Chat scenarios require a custom scratchpad runner.
  • The source does not document a standalone installation flow, client registration procedure, or dedicated skill test suite.
  • The frontmatter includes the Bash(npx @playwright/cli:*) tool-allowance syntax, so other clients may require adaptation.

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 Performance Investigation Workflow this page ✓ Microsoft · Official 47 · Use with care ★ 194k 11d ago MIT
VS Code Chat Customizations Editor Skill ✓ Microsoft · Official 52 · Use with care ★ 194k 11d ago MIT
VS Code Integrated Browser Architecture ✓ Microsoft · Official 56 · Use with care ★ 194k 11d ago MIT
Code OSS Launch & Debug ✓ Microsoft · Official 54 · Use with care ★ 194k 11d ago MIT
VS Code Chat Performance Lab ✓ Microsoft · Official 53 · Use with care ★ 194k 11d ago MIT

How did FollowSkills review this skill?

FollowSkills review · FSRS-2.0
Use with care
47/ 100 5-point scale 2.4 / 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.
1Trust10 / 25 · 2.0/5

The document explicitly discloses execution on the real machine, full VS Code launch, reuse of user-data that may contain authentication secrets, and real LLM/tool side effects. It recommends throwaway workspaces, safe prompts, scoped cleanup, and avoiding destructive commands. However, the default workspace can still be the repository root, persistent profiles and Copilot/LLM calls remain high-impact, and there is no uniform per-action confirmation, isolation model, or complete rollback plan, so points are deducted.

2Reliability8 / 20 · 2.0/5

The workflow includes no-snapshot smoke runs, screenshots, incremental summary.json, error fields, run verification, explicit cleanup, and diagnostic failure guidance. The main path is coherent, but this is a static review with no execution of scripts, dependencies, selectors, or cross-platform behavior; referenced helper skills and implementations are also not fully supplied. The score therefore remains below the static ceiling.

3Adaptability10 / 15 · 3.3/5

Use cases, non-fit cases, parameters, Chat versus non-Chat branches, and expected artifacts are reasonably clear. However, non-Chat investigations still require missing scenario details, and core operation depends on local Code OSS, Playwright, Electron, npm downloads, and Copilot authentication. Chinese-language interaction and mainland-China network reachability are not addressed, so points are deducted.

4Convention9 / 15 · 3.0/5

The documentation is well organized with progressive workflow sections, examples, profile guidance, safety notes, troubleshooting, directory conventions, and limitations. Repository material supplies MIT licensing, Microsoft attribution, and version information. The skill does not clearly state a maintainer, changelog, versioning policy, or update path, and its persistent-profile guidance conflicts with the supplied scratchpad README, so points are deducted.

5Effectiveness6 / 15 · 2.0/5

The intended outputs—repeatable runs, screenshots, summary.json, heap samples, snapshots, and handoff for analysis—are concrete and useful for performance investigations. Nevertheless, success depends on execution in a suitable environment and on a separate heap-analysis skill; the supplied files contain no representative successful output for this revision. The instruction to fix product code and run all tests can also exceed a narrowly scoped investigation, so the static ceiling applies.

6Verifiability4 / 10 · 2.0/5

The repository includes chat performance and memory-leak CI workflows, providing some auditable execution evidence. Those workflows do not clearly cover every key path of this specific skill, and no revision-pinned run results or independent reproduction record is supplied. The score therefore stays below the static ceiling.

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][12]

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 run VS Code in a sandbox?
No. The source explicitly says that Chat runs launch full Code OSS on the user's actual computer, use real Copilot authentication and a real LLM. Use a throwaway or gitignored workspace to avoid modifying a real repository.
Should I use this skill when .heapsnapshot files already exist?
Not when the task is only to inspect heap objects, direct retainers, or paths to GC roots. Use heap-snapshot-analysis directly; this skill is primarily for reproducing scenarios and collecting evidence.
Will the Chat smoke test require sign-in?
It may. If Chat requests authentication, run with --keep-open so the user can sign in once, close the Code window, and then rerun using the shared persistent profile.
Is this skill free?
The source states that the Code - OSS source is licensed under MIT. It does not state a separate price for the skill, and Chat runs use a real LLM and existing authentication.

More skills from this repository

All from microsoft/vscode

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

Code OSS Launch & Debug

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

★ 194k FS 54 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

VS Code Insiders UI Automation

Automate VS Code Insiders and Copilot Chat through Playwright and CDP.

★ 194k FS 46 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 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

Copilot Chat Troubleshooter

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

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

VS Code Configuration Policy Maintainer

Standardize VS Code policy registration, export, and validation.

★ 194k FS 59 Recommended 11d ago
Design & Frontend ✓ Microsoft · Official

VS Code Design Philosophy

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

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

VS Code Agent Customization Assistant

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

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

VS Code Crash Dump Symbolicator

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

★ 194k FS 53 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

Run Command Builder

Configure and update commands shown in a VS Code Agent Session's Run button.

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

Reusable Prompt Creator

Turn recurring tasks into reusable .prompt.md files.

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

V8 Heap Snapshot Analyzer

Trace V8 heap retention paths to diagnose leaks and GC-surviving objects.

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

VS Code Smoke Test Failure Diagnosis

Diagnose and validate intermittent VS Code Electron smoke-test failures in Azure DevOps.

★ 194k FS 45 Not recommended 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

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

Related skills