CtrlK
BlogDocsLog inGet started
Tessl Logo

vscode-dev-workbench

Use when the user wants to run the vscode.dev server locally and exercise the VS Code workbench or Agents window in the integrated browser against the local `microsoft/vscode` sources. Covers starting the dev server, the `vscode-quality=dev` URL, browser-driven interaction patterns, and optionally wiring up a local mock agent host for the Agents window.

76

Quality

94%

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

SKILL.md
Quality
Evals
Security

Quality

Content

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

Excellent operational content: executable commands, copy-paste snippets, explicit validation checkpoints, a troubleshooting table, and a fully specified mock-agent-host flow with expected log output. The only structural gap is that some long-tail detail (mobile emulation, mock-agent seeding) is inlined in a fairly long single file rather than split into reference files.

Suggestions

Move the mobile emulation section (CDP snippets, UA override, standalone-Playwright note) into a references file (e.g. references/mobile-emulation.md) and keep a one-line pointer plus the key caveat in SKILL.md.

Split the mock agent host deep detail (session seeding env var, scripted prompt list, protocol-version tag requirement) into references/mock-agent-host.md, leaving the start command, URL, and expected log sequence inline.

DimensionReasoningScore

Conciseness

Every section conveys non-obvious operational knowledge (sibling-repo layout, 'npm run dev' must run from vscode-dev, first-start crash behavior, service-worker cache purge snippet, known-noise console list, mock-agent protocol-version requirement) with no conceptual padding Claude would already know. Lean and efficient, matching the 5 anchor rather than 4, since there is no over-explanation left to trim.

5 / 5

Actionability

Fully executable throughout: 'npm run dev' with an absolute-pushd variant, a curl readiness check returning 200, exact URLs, copy-paste Playwright/CDP snippets, a precise mock-agent-host launch command with flags and env-var seeding, and a symptom/cause/fix troubleshooting table. Covers the common cases, matching the 5 anchor.

5 / 5

Workflow Clarity

The process is clearly sequenced — layout assumption → start dev server → curl-based readiness check → URLs → browser interaction patterns → troubleshooting → optional mock agent host with prerequisite check ('If out/... is missing, start that task first') and verification via the expected ordered log sequence. Validation checkpoints and error-recovery loops are explicit, matching the 5 anchor; no destructive/batch cap applies.

5 / 5

Progressive Disclosure

Good structure with clear section headers and easy navigation, but the skill is a single ~135-line file with no bundle files; deeper detail such as the mobile CDP emulation snippet and the mock-agent session/prompt seeding reference would fit better in a separate reference file. Anchor 4 fits ('good structure, minor organization gaps') rather than 5, since the under-50-lines exception does not apply and some content that could be split is inline.

4 / 5

Total

19

/

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: explicit 'Use when...' trigger, concrete 'what' enumeration, natural trigger terms, and a highly distinct niche. Only minor room to improve keyword coverage with a few user-facing synonyms. Third-person voice is used throughout, consistent with the guidelines.

DimensionReasoningScore

Specificity

Multiple specific concrete actions are named — 'run the vscode.dev server locally', 'exercise the VS Code workbench or Agents window in the integrated browser', 'starting the dev server, the vscode-quality=dev URL', 'optionally wiring up a local mock agent host' — giving comprehensive coverage of the skill's capabilities. This fits the 5 anchor (multiple specific concrete actions, comprehensive) rather than 4, since no meaningful capability of the workflow is left unlisted.

5 / 5

Completeness

Explicitly answers both: 'what' via 'Covers starting the dev server, the vscode-quality=dev URL, browser-driven interaction patterns, and optionally wiring up a local mock agent host' and 'when' via the leading 'Use when the user wants to run the vscode.dev server locally and exercise the VS Code workbench or Agents window...'. Both halves are concrete, matching the 5 anchor exactly.

5 / 5

Trigger Term Quality

Good natural keyword coverage — 'vscode.dev server', 'VS Code workbench', 'Agents window', 'dev server', 'integrated browser', 'mock agent host' — phrases a user would plausibly say. A few natural variations are missing (e.g. 'test/validate web-only changes', 'playwright', 'browser automation'), so it sits at anchor 4 rather than 5's 'comprehensive including synonyms'.

4 / 5

Distinctiveness Conflict Risk

A clear niche — running the vscode.dev server against local microsoft/vscode sources — with distinct triggers ('vscode.dev server', 'vscode-quality=dev', 'Agents window', 'mock agent host') that are unlikely to collide with other skills. Minimal conflict risk, matching the 5 anchor.

5 / 5

Total

19

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
posit-dev/positron
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.