CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

auto-perf-optimize

Run agent-driven VS Code performance or memory investigations. Use when asked to launch Code OSS, automate a VS Code scenario, run the Chat memory smoke runner, capture renderer heap snapshots, take workflow screenshots, compare run summaries, or drive a repeatable scenario before heap-snapshot analysis.

72

Quality

90%

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

The canonical home for this skill is auto-perf-optimize in microsoft/vscode

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.

A high-quality, deeply operational skill body: executable commands at every step, an explicit stepwise workflow with validation and feedback loops, and appropriate delegation to the analysis skill. The two deductions are for repeated guidance (scratchpad/throwaway-workspace conventions stated twice) and one bundled script (workbench-css-performance.mts) missing from the body's runner listing.

Suggestions

Add a one-line entry for scripts/workbench-css-performance.mts to the 'Checked-in Runners' list so every bundled script is discoverable from SKILL.md.

State the dated-subfolder and throwaway-workspace conventions once (in 'Develop and Watch a Runner') and reference them from 'Non-Chat VS Code Scenarios' and the safety block instead of restating them.

Trim the generic engineering advice in 'Root-Cause, Don't Treat Symptoms' (e.g., 'use git blame', 'look for prior art') to the VS Code-specific examples, which already carry the value.

DimensionReasoningScore

Conciseness

Nearly every section carries repo-specific operational knowledge Claude would not know (import path depth with exact '..' counts, seed-copy rules, playwright checkpoints, summary.json field contract) with no generic concept explanations. However, there is redundancy — the dated-subfolder and throwaway-workspace conventions are each stated twice ("Develop and Watch a Runner" vs "Non-Chat VS Code Scenarios"; safety block vs pattern list), and "Root-Cause, Don't Treat Symptoms" partly explains general engineering judgment Claude already has. This fits the 4 anchor (efficient, minor trimming possible), not the 5 anchor.

4 / 5

Actionability

Fully executable throughout: copy-paste bash invocations with exact flags, a complete comparison script, a concrete playwright command sequence, a field-by-field summary.json verification checklist, and a worked scratchpad workflow. The 'Important runner behavior' and seed-copy rules give precise flag-level guidance for the common cases.

5 / 5

Workflow Clarity

"The Story" gives a clear 8-step sequence with explicit validation checkpoints: smoke-run-first validation ("Validate with --no-heap-snapshots first"), the "Verify Before Analyzing" field checklist, error-recovery loops ("If the script is stuck, capture a screenshot and read the incremental summary.json"), fix-then-rerun verification with like-for-like labels, and a run-all-tests gate. Matches the 5 anchor's feedback loops and checklists.

5 / 5

Progressive Disclosure

Good structure: markdown-linked one-level-deep references to the bundled scripts, delegation of analysis detail to the heap-snapshot-analysis skill, and well-organized sections. Minor gap: scripts/ contains workbench-css-performance.mts, which is never referenced from the body, leaving a bundle file undiscoverable — fits the 4 anchor rather than the fully navigable 5 anchor.

4 / 5

Total

18

/

20

Passed

Description

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

A strong description: concrete third-person actions, an explicit 'Use when' clause with multiple natural triggers, and a clear boundary against the companion analysis skill. The only gap is a handful of missing colloquial synonyms like 'memory leak'.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — "launch Code OSS", "run the Chat memory smoke runner", "capture renderer heap snapshots", "take workflow screenshots", "compare run summaries" — comprehensively covering the skill's capabilities in third-person imperative voice. No vague or padded language.

5 / 5

Completeness

Explicitly answers both "what" ("Run agent-driven VS Code performance or memory investigations") and "when" ("Use when asked to launch Code OSS, automate a VS Code scenario, run the Chat memory smoke runner, capture renderer heap snapshots...") with seven concrete trigger phrases. Matches the 5 anchor exactly.

5 / 5

Trigger Term Quality

Strong natural trigger phrases ("VS Code performance", "memory investigations", "heap snapshots", "workflow screenshots") that users would actually say, but a few common synonyms are missing (e.g., "memory leak", "slow VS Code", ".heapsnapshot"). Between the 4 anchor (good coverage, few natural terms missing) and the 5 anchor (comprehensive including synonyms/extensions); missing the most colloquial phrasings keeps it at 4.

4 / 5

Distinctiveness Conflict Risk

Clear niche (VS Code-specific perf/memory capture workflows) with distinct triggers, and the trailing "before heap-snapshot analysis" clause explicitly delineates the boundary from the related heap-snapshot-analysis skill. Minimal conflict risk.

5 / 5

Total

19

/

20

Passed

Validation

81%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

relative_links

Relative link issues: 2 missing

Warning

referenced_paths_exist

Referenced path issues: 2 missing

Warning

Total

13

/

16

Passed

Repository

posit-dev/positron

Path

.github/skills/auto-perf-optimize/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.