CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

add-adaptive-card-form

Create form-based UI for your Command Palette extension using Adaptive Cards. Use when asked to add forms, user input fields, toggle switches, text inputs, dropdown menus, data entry, surveys, configuration dialogs, or interactive content pages. Supports the Adaptive Cards Designer for visual form building.

Quality

92%

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

86%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-built skill body: a complete executable quick start, terse key concepts, and a clean split of the bulky pattern catalog into a single clearly-signaled reference file. The two soft spots are minor redundancy between the 'When to Use' section and the frontmatter description, and a lack of error-recovery guidance in the deploy/test workflow.

Suggestions

Trim or merge the 'When to Use This Skill' section (and the redundant opening sentence) — the frontmatter description already lists these trigger cases, so the body could open directly with the Quick Start.

Add a short error-recovery step to 'Step 3: Deploy and Test' (e.g., what to check if the form doesn't render after Reload — extension output logs, JSON schema validity of TemplateJson) to close the workflow-clarity gap.

Optionally mention in 'Key Concepts' that payload ids must match the TemplateJson input ids, since the submit handler depends on it and a mismatch fails silently.

DimensionReasoningScore

Conciseness

The body is efficient: a complete copy-paste Quick Start, terse Key Concepts entries with minimal prose, and no explanation of what Adaptive Cards or C# are. It misses the 5 anchor because the 'When to Use This Skill' section re-lists the frontmatter's trigger cases ('Adding toggle switches or dropdown menus', etc.) and the opening sentence restates the description — minor redundancy that could be trimmed. It is clearly above the 3 anchor, which requires 'some unnecessary explanation' beyond this light duplication.

4 / 5

Actionability

Fully executable guidance: a complete, copy-paste-ready C# ContentPage/FormContent pair including the TemplateJson, submit handler, and registration snippet, followed by concrete deploy-and-test steps ('run Reload, navigate to your form and submit it') and small executable DataJson/mixed-content examples. The 'for common cases, fully executable' anchor fits; the 4 anchor's 'minor gaps' would require missing key details, and none are evident.

5 / 5

Workflow Clarity

A clear three-step sequence — create the page, register it in CommandsProvider, deploy/test with the explicit 'run Reload' checkpoint — covering the common case end to end. Not the 5 anchor because there is no error-recovery feedback loop (e.g., what to do if the form fails to render or submit) and no explicit validation of the JSON or payload beyond the null check in the code; not a 3 because the test step is a concrete checkpoint, not merely 'implicit'.

4 / 5

Progressive Disclosure

The 145-line SKILL.md is an overview, and the bulk material (536 lines of template JSON and handler code for common form types) is split into references/form-patterns.md, clearly signaled as 'See [form-patterns.md](references/form-patterns.md) for template JSON for common form types'. The reference is one level deep, verified to exist, and the body sections are well organized — matching the clear-overview/one-level-deep anchor rather than the 4 anchor, which expects organization gaps.

5 / 5

Total

18

/

20

Passed

Description

95%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: concrete domain statement, an explicit 'Use when' clause with a comprehensive list of natural trigger terms and synonyms, and a clear niche that is unlikely to mis-trigger. The only weakness is that the capability list enumerates use cases rather than a fuller set of actions (e.g., handling submissions, dynamic data binding), which leaves specificity just short of the top anchor.

DimensionReasoningScore

Specificity

Names the domain ('form-based UI for your Command Palette extension using Adaptive Cards') and enumerates concrete deliverables ('toggle switches, text inputs, dropdown menus, ... configuration dialogs, or interactive content pages'), matching the 'several specific actions; minor gaps' anchor. It falls just below the 5 anchor because the only stated capabilities are creating form UI and 'Supports the Adaptive Cards Designer' — submission handling, data binding, and other capabilities shown in the body are absent, and the enumerated items are use cases rather than distinct actions.

4 / 5

Completeness

Explicitly answers both: what — 'Create form-based UI for your Command Palette extension using Adaptive Cards'; when — 'Use when asked to add forms, user input fields, toggle switches, text inputs, dropdown menus, data entry, surveys, configuration dialogs, or interactive content pages'. This matches the 5 anchor's structure ('what' plus a 'Use when' clause with concrete trigger phrases), not the 4 anchor where 'when could be more explicit or specific'.

5 / 5

Trigger Term Quality

The 'Use when' clause covers natural terms comprehensively with synonyms: 'forms, user input fields, toggle switches, text inputs, dropdown menus, data entry, surveys, configuration dialogs, or interactive content pages' — a user asking for any of these would naturally phrase it this way. It clearly matches the comprehensive-synonyms anchor; the 4 anchor ('a few natural terms missing') understates this coverage.

5 / 5

Distinctiveness Conflict Risk

'Command Palette extension' and 'Adaptive Cards' pin it to a clear niche with distinct triggers, and the enumerated trigger terms are form-specific rather than generic. Minimal conflict risk with other skills; the generic-sounding 'interactive content pages' is the only mild overlap term, keeping it at 5 rather than suggesting any real ambiguity.

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

microsoft/PowerToys

Path

src/modules/cmdpal/ExtensionTemplate/TemplateCmdPalExtension/.github/skills/add-adaptive-card-form/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.