powershell

Run safe PowerShell commands on Windows, translate Bash snippets, and troubleshoot native Windows setup.

Quality

71%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/powershell/SKILL.md

Quality

Content

76%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 tight, highly actionable PowerShell reference with executable examples and sensible safety guidance. Its weak spot is the batch prerequisite-install workflow, which lacks validation checkpoints.

Suggestions

Add a validation step after the winget installs, e.g. re-run the version checks to confirm each tool is on PATH before proceeding.

Consider moving the PilotDeck-specific prerequisites into a separate reference file to keep the overview lean and generic.

Add an explicit error-recovery loop (install fails → check winget output → retry) for the batch install workflow.

Dimension	Reasoning	Score
Conciseness	The body is lean and assumes Claude knows PowerShell, with no concept padding; every code block earns its place. Not a 5 because the PilotDeck-specific notes and the winget install list are slightly more than the minimal overview needs.	4 / 5
Actionability	Copy-paste ready PowerShell commands cover the common cases — version checks, path inspection, sequential install, and .cmd shim fallbacks. Fully executable with specific examples.	5 / 5
Workflow Clarity	The winget prerequisite install is a batch operation with a 'close and reopen PowerShell' step but no validation that tools actually installed/worked, so the batch-operation cap applies. Not a 2 because a rough sequence and a PATH checkpoint are present.	3 / 5
Progressive Disclosure	Well-organized into Shell Choice, Safe Command Patterns, PilotDeck Notes, and Safety sections with no external references needed. Not a 5 because the body is slightly over 50 lines and the project-specific PilotDeck section could live in a separate reference.	4 / 5
	Total	16 / 20 Passed

Description

66%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 concise, mostly specific description anchored in a clear Windows/PowerShell niche. Its main weakness is the absence of an explicit 'when to use' trigger clause, which limits completeness.

Suggestions

Add a 'Use when…' clause naming explicit triggers, e.g. 'Use when the user is on Windows, asks for PowerShell, or needs native Windows setup instead of Bash/WSL.'

Include a few natural synonyms/extensions (e.g. 'pwsh', 'cmd', 'Windows shell') to broaden trigger coverage.

Sharpen 'safe' into a concrete capability or drop it to avoid the slight vagueness.

Dimension	Reasoning	Score
Specificity	Lists three concrete actions — 'Run safe PowerShell commands', 'translate Bash snippets', 'troubleshoot native Windows setup' — which matches 'several specific actions; minor gaps'. Not a 5 because 'safe' is slightly generic and coverage of setup tasks is not comprehensive.	4 / 5
Completeness	The 'what' is clear but there is no 'Use when…' clause or equivalent explicit trigger guidance, which caps completeness at 3 per the rubric. Not a 2 because the 'what' is concrete rather than vague.	3 / 5
Trigger Term Quality	Natural terms users would say — 'PowerShell commands', 'Windows', 'Bash snippets' — give good keyword coverage. Not a 5 because synonyms/extensions like 'cmd', 'shell', or specific version terms are absent.	4 / 5
Distinctiveness Conflict Risk	The Windows/PowerShell niche is mostly distinct with minimal conflict risk. Not a 5 because 'translate Bash snippets' overlaps with a general Bash skill's territory.	4 / 5
	Total	15 / 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: OpenBMB/PilotDeck
Path: skills/powershell/SKILL.md
Commit: 5b802a8

Reviewed: 2 days 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.