CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

add-fallback-commands

Add fallback commands to your Command Palette extension for catch-all search behavior. Use when asked to add search functionality, query matching, direct input handling, calculator-style evaluation, URL opening, command execution, or results that appear when no other extension matches. Used by 14 of 20 built-in extensions.

Quality

84%

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 well-constructed how-to skill: fully executable code examples covering the main patterns, minimal filler, and good section structure. The only gaps are minor — a touch of duplication with the description's trigger list and no step for verifying the extension builds and the fallback actually appears.

DimensionReasoningScore

Conciseness

Prose is minimal and the three code examples earn their tokens. Minor duplication exists: the "When to Use This Skill" bullet list restates the frontmatter description's triggers, and the intro paragraph overlaps the "Key Points" section.

4 / 5

Actionability

Three complete, copy-paste-ready C# examples cover the common cases: static FallbackCommands(), a dynamic DynamicListPage with query filtering, and cancellation/debounce for expensive searches. The stubbed SearchAsync is an explicitly signposted template ("Your search logic here"), not pseudocode.

5 / 5

Workflow Clarity

"How Fallback Commands Work" gives a clear 4-step mechanism sequence and the examples escalate logically from static to dynamic to responsive. No validation step is provided for verifying the fallback registers and appears (e.g., building/testing), which keeps it just below the explicit-checkpoint anchor — though nothing here is destructive or batch, so no cap applies.

4 / 5

Progressive Disclosure

No bundle files exist, and the body is well-organized with clear section headers, a compact built-in-examples table, and two clearly signaled external documentation links. The examples-table and full code listings are borderline candidates for reference files, keeping it short of the ideally-split anchor.

4 / 5

Total

17

/

20

Passed

Description

78%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 with explicit what/when structure and good natural trigger coverage. Its main weakness is voice — the second-person imperative "Add ... to your Command Palette extension" instead of third person — and a what-clause that names only one action, relying on the when-clause to carry specificity.

Suggestions

Rewrite the opening in third person (e.g., "Adds fallback commands to a Command Palette extension for catch-all search behavior") to match the expected voice and recover the specificity penalty.

Consolidate the enumerated behaviors into the what-clause so the skill's own capabilities (provide static or query-filtered fallback items, debounce and cancel in-flight searches) are stated as actions rather than only as trigger contexts.

DimensionReasoningScore

Specificity

The what is a single concrete action ("Add fallback commands to your Command Palette extension for catch-all search behavior") with the enumerated behaviors (calculator-style evaluation, URL opening, command execution) placed in the when-clause rather than describing the skill's actions. The description also uses second-person imperative voice ("Add ... to your Command Palette extension"), which the judging guidelines penalize by reducing specificity by 1 from a base of 4.

3 / 5

Completeness

Explicitly answers both questions: what ("Add fallback commands to your Command Palette extension for catch-all search behavior") and when ("Use when asked to add search functionality, query matching, ... or results that appear when no other extension matches") with concrete trigger phrases.

5 / 5

Trigger Term Quality

Strong natural terms: "search functionality, query matching, direct input handling, calculator-style evaluation, URL opening, command execution", plus "fallback" and "catch-all". A few common user phrasings are missing (e.g., "web search", "file path", "shell commands"), so it falls just short of the comprehensive-synonyms anchor.

4 / 5

Distinctiveness Conflict Risk

"Command Palette extension" establishes a clear niche with distinct triggers, but the broad trigger list (search functionality, calculator, URL opening) creates minor overlap risk with general search or calculator skills.

4 / 5

Total

16

/

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-fallback-commands/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.