CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

add-extension-settings

Add a settings page to your Command Palette extension. Use when asked to add settings, preferences, configuration options, toggles, text inputs, dropdowns, or user-customizable behavior. Covers ToggleSetting, TextSetting, ChoiceSetSetting, and persistence.

Quality

89%

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

82%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, code-first skill body: complete executable examples covering all three setting types, provider wiring, grouping, and change handling, organized into clear sections. The main improvement opportunities are removing the duplicated SettingsChanged/trigger-list content and adding a brief verification step (build and confirm the settings page renders).

Suggestions

Merge the "Reacting to Changes" section into Step 1 (the SettingsChanged event is already wired there) and drop or shorten "When to Use This Skill" since it duplicates the frontmatter description.

Add a final verification step to Quick Start, e.g. 'Build and deploy the extension, open its settings page, and confirm toggles/choices persist across a restart.'

Consider moving the "Grouping Settings" example and the Setting Types table into a reference file if the skill grows, keeping SKILL.md focused on the core three-step flow.

DimensionReasoningScore

Conciseness

The body is efficient and code-dominant with almost no re-teaching of concepts Claude already knows, but there is duplication that could be trimmed: the "Reacting to Changes" section re-shows SettingsChanged wiring already demonstrated in Step 1, the "Grouping Settings" snippet repeats constructor patterns, and "When to Use This Skill" restates the frontmatter description. This sits between anchor 3 (some unnecessary explanation) and anchor 5 (every token earns its place), matching anchor 4's "minor instances of over-explanation that could be trimmed".

4 / 5

Actionability

Three sequenced, fully executable C# code blocks (SettingsManager, CommandProvider wiring, page consumption) plus a constructor-parameter table make the guidance copy-paste ready and cover the common cases (toggle, text, choice set, grouping, change reaction). This directly matches the anchor-5 example pattern of complete code plus a concise API detail.

5 / 5

Workflow Clarity

The three-step Quick Start (create manager, wire into provider, use in pages) is a clear, correctly ordered sequence, and this additive, non-destructive task warrants no validation cap. It falls short of anchor 5 only because there is no checkpoint for verifying the result (e.g., build/deploy and confirm the settings page appears), matching anchor 4's "clear sequence with most checkpoints present; minor validation gaps".

4 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, or assets/ directories), so all guidance lives in a single SKILL.md. The body is well-organized into clearly headed sections with a clearly labeled external Documentation link, and at ~200 lines of mostly working code the inlining is defensible — only the "Grouping Settings" and "Reacting to Changes" sections are candidates for a separate reference file. This fits anchor 4's "good structure; most content appropriately placed; minor organization gaps" rather than anchor 5's well-signaled one-level-deep references.

4 / 5

Total

17

/

20

Passed

Description

91%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 that clearly states what the skill does and when to use it, with excellent natural trigger-term coverage. The only deductions are minor: slight second-person phrasing ("your Command Palette extension"), a mostly-but-not-fully comprehensive capability list, and small overlap risk on generic words like "settings".

DimensionReasoningScore

Specificity

"Add a settings page to your Command Palette extension" plus "Covers ToggleSetting, TextSetting, ChoiceSetSetting, and persistence" lists several concrete capabilities with only minor coverage gaps (e.g., no mention of settings groups or the SettingsChanged event). It matches anchor 4 rather than 5 because it names one primary action plus covered types rather than a fully comprehensive set of actions; it is well above anchor 3's "1-2 concrete actions."

4 / 5

Completeness

It explicitly answers "what" ("Add a settings page to your Command Palette extension") and "when" ("Use when asked to add settings, preferences, configuration options, toggles...") with concrete trigger phrases, matching the anchor-5 example structure exactly. Anchor 4 would require a vaguer or less explicit 'when' clause, which this does not have.

5 / 5

Trigger Term Quality

"Use when asked to add settings, preferences, configuration options, toggles, text inputs, dropdowns, or user-customizable behavior" comprehensively covers natural synonyms (settings, preferences, toggles, dropdowns) that a user would naturally say. No relevant file extensions exist for this C#/extension domain, so nothing is missing.

5 / 5

Distinctiveness Conflict Risk

Scoping to "your Command Palette extension" gives it a clear niche with minimal conflict risk, but generic terms like "settings", "preferences", and "user-customizable behavior" could overlap with other settings-related or general CmdPal extension skills. Mostly distinct with minor overlap risk with closely related skills fits anchor 4 better than anchor 5.

4 / 5

Total

18

/

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

microsoft/PowerToys

Path

src/modules/cmdpal/ExtensionTemplate/TemplateCmdPalExtension/.github/skills/add-extension-settings/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.