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

81%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

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

An actionable, well-structured skill body anchored in executable C# examples and a clean reference table, covering the core task end-to-end. The main improvements are tightening redundant examples and adding a runtime verification step.

Suggestions

Add an explicit verification checkpoint (e.g., 'Build the extension and confirm the settings page appears under the extension in Command Palette') to close the workflow loop.

Collapse the 'Grouping Settings' and 'Reacting to Changes' sections into shorter inline notes or move them to a referenced file to reduce repetition with the Quick Start example.

Trim redundant prose around code blocks (e.g., 'Settings are automatically persisted and restored by the extension host' overlaps the Key Points) to improve token efficiency.

Dimension	Reasoning	Score
Conciseness	Mostly efficient with executable code and a compact reference table, though the three full C# examples plus a redundant 'Grouping Settings'/'Reacting to Changes' expansion restate material that a tighter single walkthrough could carry.	4 / 5
Actionability	Provides copy-paste ready, executable C# for the manager, provider wiring, and page consumption, plus a parameter table covering the common setting types and concrete value-access patterns.	5 / 5
Workflow Clarity	A clear three-step sequence (create manager -> wire provider -> use in pages) with inline commentary, but it lacks an explicit build/verify checkpoint to confirm the settings page actually appears at runtime.	4 / 5
Progressive Disclosure	Well-organized sections (Quick Start, Setting Types, Key Points, Grouping, Reacting to Changes, Documentation) with one external reference; the only bundle file is the documentation link, and a few inline sections (Grouping, Reacting to Changes) could live in references, hence not a 5.	4 / 5
	Total	17 / 20 Passed

Description

82%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, well-structured description that clearly states both what the skill does and when to use it, with concrete setting-type names as triggers. Minor gains are available from adding synonym/extension triggers and tightening distinctiveness.

Dimension	Reasoning	Score
Specificity	Lists several concrete actions (add settings, toggles, text inputs, dropdowns, persistence) and specific types (ToggleSetting, TextSetting, ChoiceSetSetting), with minor gaps such as no mention of grouping or change events.	4 / 5
Completeness	Explicitly answers both 'what' ('Add a settings page to your Command Palette extension... Covers ToggleSetting, TextSetting, ChoiceSetSetting, and persistence') and 'when' ('Use when asked to add settings, preferences...').	5 / 5
Trigger Term Quality	Good natural-term coverage ('settings, preferences, configuration options, toggles, text inputs, dropdowns, user-customizable behavior') that users would actually say, though it omits file-extension or synonym variants like 'CmdPal settings' or 'configure extension'.	4 / 5
Distinctiveness Conflict Risk	Scoped to a clear niche (Command Palette extension settings) with distinct API type names, but 'settings/preferences/configuration' terminology is broad enough to risk minor overlap with generic configuration skills.	4 / 5
	Total	17 / 20 Passed

Validation

100%

Warnings & errors only

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
Commit: b9c82a4

Reviewed: ~15 hours ago

Table of Contents

Discovery Implementation Validation

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.