CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

azure-ps-design-review

Conversational agent that guides developers through creating complete Azure PowerShell cmdlet design specifications. Walks through an interactive interview covering service release details, contacts, scenarios, cmdlet syntax, parameter sets, piping, test cases, and spec links. Validates against PowerShell design guidelines, pre-populates fields from TypeSpec, and files the design as a GitHub Issue in Azure/azure-powershell-cmdlet-review-pr. USE FOR: 'create PowerShell design', 'PS design review', 'cmdlet design', 'PowerShell cmdlet review', 'submit PS design'. DO NOT USE FOR: SDK generation, TypeSpec authoring, releasing packages.

Quality

85%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

—

The risk profile of this skill

SKILL.md
Quality
Evals
Security

Quality

Content

73%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 delivers an exceptionally actionable, well-sequenced interview workflow with validation and cleanup steps. It is held back by broken bundle references (two referenced files are missing), a large inlined template that belongs in the missing reference file, and duplicated MCP-config and scratch-file rules.

Suggestions

Create the actual references/issue-template.md and references/design-guidelines-summary.md files referenced in the body (or fix the paths), moving the full Step 3 draft template and the Step 4 validation checklist out of SKILL.md to slim the main file.

State the MCP server setup JSON and the gh-CLI prohibition once (e.g., in Troubleshooting) and reference it from the MCP Tools section instead of repeating both blocks verbatim.

Consolidate the scratch-file-vs-chat-input rules from four locations (Constraints, the Scratch File Pattern section, its IMPORTANT block, and Step 3) into the single Scratch File Pattern section, and fix the malformed nested code fences around the Step 3 template.

DimensionReasoningScore

Conciseness

The bulk is concrete workflow material rather than concept explanation, but there is avoidable duplication: the MCP setup JSON block appears twice (MCP Tools section and Troubleshooting), the no-gh-CLI fallback rule is stated twice, and the scratch-file-vs-chat rule is repeated in roughly four places (Constraints, the dedicated section, the IMPORTANT block, and Step 3 rules). Fits anchor 3 ('mostly efficient but could be tightened') better than 2 because the padding is redundancy, not explanation of concepts Claude already knows.

3 / 5

Actionability

Fully executable guidance: exact MCP tool names and purposes, concrete search queries ('"AzSnapshot" language:cs path:src/Compute'), a copy-paste-ready design draft template with per-section TODO markers, exact scratch file paths, exact issue title format and labels, and the MCP config JSON. Specific examples cover the common cases. Anchor 4 is ruled out because there are no material gaps in executability.

5 / 5

Workflow Clarity

Six clearly sequenced steps, a 'PR Link First' ordering mandate, a copy-and-update progress checklist, and an explicit validation feedback loop in Step 4 (re-check against guidelines, flag issues, update scratch file, only proceed once validations pass). Matches anchor 5's checklist/feedback-loop profile exactly.

5 / 5

Progressive Disclosure

The body links to references/design-guidelines-summary.md and references/issue-template.md, but no references/ directory exists in the bundle — both links are broken. Meanwhile the full multi-section issue template (the content issue-template.md would hold) is inlined in Step 3, so content that clearly belongs in a separate file is inline and the promised external files are absent. Anchor 3's 'references present but not clearly signaled' fits worse than anchor 2's 'content that clearly belongs in separate files is inlined', since the referenced files do not exist at all.

2 / 5

Total

15

/

20

Passed

Description

92%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: comprehensive concrete capabilities, explicit USE FOR/DO NOT USE FOR trigger guidance, and a distinct niche. The only weakness is a handful of missing natural trigger phrasings such as 'design spec' or 'new cmdlet'.

DimensionReasoningScore

Specificity

Lists multiple concrete actions with comprehensive coverage: 'Walks through an interactive interview covering service release details, contacts, scenarios, cmdlet syntax, parameter sets, piping, test cases, and spec links. Validates against PowerShell design guidelines, pre-populates fields from TypeSpec, and files the design as a GitHub Issue in Azure/azure-powershell-cmdlet-review-pr.' Every capability is specific and verifiable. Anchor 4 is ruled out because there are no gaps in coverage of the skill's actions.

5 / 5

Completeness

Explicitly answers both what (interview, validation, TypeSpec pre-population, GitHub Issue filing) and when (USE FOR with five concrete trigger phrases, plus a DO NOT USE FOR exclusion list). Matches the anchor-5 example pattern exactly; anchor 4 is ruled out because the 'when' is fully explicit, not just present.

5 / 5

Trigger Term Quality

USE FOR lists five natural phrases with abbreviation/full-form synonyms ('create PowerShell design', 'PS design review', 'cmdlet design', 'PowerShell cmdlet review', 'submit PS design'), but a few natural terms users would say are missing (e.g., 'design spec', 'new cmdlet', 'Az module'). Fits anchor 4 ('good keyword coverage; a few natural terms missing') better than 5, which requires exhaustive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

A clear niche (Azure PowerShell cmdlet design review filed in a named repo) with distinct triggers, and the DO NOT USE FOR clause ('SDK generation, TypeSpec authoring, releasing packages') explicitly excludes the nearest adjacent skills, minimizing conflict risk.

5 / 5

Total

19

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 3 missing

Warning

referenced_paths_exist

Referenced path issues: 3 missing

Warning

Total

14

/

16

Passed

Repository

Azure/azure-rest-api-specs

Path

.github/skills/azure-ps-design-review/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.