CtrlK
BlogDocsLog inGet started
Tessl Logo

install-vscode-extension

How to install a VS Code extension from an extension ID. Useful when the user wants to add new capabilities to their VS Code environment by installing extensions.

65

Quality

77%

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

Fix and improve this skill with Tessl

tessl review fix ./extensions/copilot/assets/prompts/skills/install-vscode-extension/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

The body is an efficient, actionable three-step instruction with the exact command, args shape, and execution tool named, plus an explicit rule for the pre-release decision. Its only real defect is a placeholder boolean in the args example and one sentence of known-concept explanation; nothing needs restructuring given the skill's size and self-contained nature.

Suggestions

Replace the 'installPreReleaseVersion: boolean' placeholder with concrete values, e.g. show 'installPreReleaseVersion: true' for the Insiders/pre-release case and 'false' otherwise, or two complete arg arrays.

Trim or fold the extension-ID format explanation in step 1 into the instruction itself (e.g., 'Install the extension by its ID (publisher.extensionName)') to remove the tutorial-style explanation.

Optionally add a one-line verification step (e.g., confirm the install succeeded via the command result) to strengthen the feedback loop even for this non-destructive operation.

DimensionReasoningScore

Conciseness

The body is lean and every operational token (command name, args shape, tool name, skipCheck) earns its place. It is not a 5 because step 1 explains the publisher.extensionName ID format with an example — a concept Claude already knows — which is a minor instance of over-explanation, matching 'Efficient; minor instances of over-explanation that could be trimmed'.

4 / 5

Actionability

Guidance is highly concrete: the exact VS Code command 'workbench.extensions.installExtension', the args array format, and the exact tool 'copilot_runVscodeCommand' with 'skipCheck' set to true. It falls short of fully executable (5) only because the args include the placeholder 'installPreReleaseVersion: boolean' rather than a concrete value, leaving a small gap the reader must resolve — matching 'Mostly executable guidance; concrete code or commands with minor gaps'.

4 / 5

Workflow Clarity

This is a simple, single-purpose skill and the sequence is unambiguous: identify the extension ID, construct the command args, execute via the named tool. The one decision point (pre-release vs. stable) is explicitly resolved by the NOTE with clear conditions, and the operation is non-destructive, so the simple-skill exception applies and no validation checkpoint is required.

5 / 5

Progressive Disclosure

The skill is under 50 lines, self-contained, and needs no external references — no bundle files exist to split content into. Per the rubric's guideline for such skills, a short, well-organized body (numbered steps plus a clearly signaled NOTE) earns full marks with nothing inlined that belongs in a separate file.

5 / 5

Total

18

/

20

Passed

Description

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

The description is concise and delivers a clear 'what' plus an explicit 'when' clause with natural trigger language, avoiding fluff and over-claims. Its main weaknesses are limited action coverage (a single capability) and a 'when' clause that restates the 'what' rather than enumerating concrete trigger scenarios or synonyms (add, marketplace, .vsix).

Suggestions

Sharpen the 'when' clause with concrete triggers, e.g. 'Use when the user asks to install, add, or enable a VS Code extension (e.g., from the marketplace or an extension ID like ms-python.python)'.

Broaden specificity slightly by mentioning the decisions the skill handles, such as choosing the stable vs. pre-release version, so the capability coverage is not a single bare action.

Add natural synonyms users say — 'add an extension', 'enable an extension', 'marketplace' — to improve trigger term coverage.

DimensionReasoningScore

Specificity

The description names the domain and one concrete action — "install a VS Code extension from an extension ID" — but stops there, offering no coverage of related capabilities (e.g., pre-release vs. stable selection, verifying installation, marketplace lookup). This matches 'Names domain and 1-2 concrete actions, but not comprehensive'; it is not a 4 because the surrounding phrase 'add new capabilities to their VS Code environment' is generic padding rather than additional specific actions.

3 / 5

Completeness

Both parts are explicitly present: the 'what' is clear ('install a VS Code extension from an extension ID') and the 'when' is stated ('Useful when the user wants to add new capabilities to their VS Code environment by installing extensions'). It falls short of a 5 because the 'when' clause largely restates the 'what' instead of giving concrete trigger situations, fitting 'Has both what and when; when could be more explicit or specific'.

4 / 5

Trigger Term Quality

Natural user phrases are present — 'install a VS Code extension', 'installing extensions', 'extension ID' — which a user would plausibly say verbatim. It is not a 5 because common variations like 'add an extension', 'marketplace', or '.vsix' are missing, and not a 3 because the core vocabulary users actually use ('VS Code', 'install', 'extension') is well covered.

4 / 5

Distinctiveness Conflict Risk

The niche is fairly distinct — installing VS Code extensions specifically from an extension ID — with minimal overlap risk against unrelated skills. It is not a 5 because the trigger phrase 'add new capabilities to their VS Code environment' is broad enough to potentially overlap with other VS Code configuration or setup skills, matching 'Mostly distinct; minor overlap risk'.

4 / 5

Total

15

/

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.