powershell

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

Quality

76%

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

87%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 clean organization. The one gap is workflow_clarity: destructive operations lack an explicit validation/feedback loop, which the rubric caps at 3.

Suggestions

Add an explicit validation/feedback loop for destructive operations, e.g. 'Before Remove-Item -Recurse -Force, list the target with Get-ChildItem and confirm; if the path is wrong, fix and re-check.'

Cross-reference the description's trigger conditions in the body so the 'when to use' guidance is reinforced rather than only implied.

Dimension	Reasoning	Score
Conciseness	The body is lean and assumes Claude's competence, with no padding or explanations of concepts Claude already knows; every section earns its place.	5 / 5
Actionability	Multiple copy-paste-ready PowerShell blocks cover read-only checks, path inspection, command sequencing, the npm.cmd/pnpm.cmd workaround, and winget installs — fully executable across the common cases.	5 / 5
Workflow Clarity	Sequencing is shown ('Run commands in sequence with explicit lines') and Safety warns about destructive commands, but there is no explicit validate→fix→retry feedback loop for destructive operations, which the rubric caps at 3.	3 / 5
Progressive Disclosure	A well-organized single-purpose skill under ~80 lines with no bundle files; the simple-skill exception applies, and sections (Shell Choice, Safe Command Patterns, PilotDeck Notes, Safety) are clearly delineated.	5 / 5
	Total	18 / 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, third-person description that clearly states three concrete capabilities and carves out a distinct Windows/PowerShell niche. Its main weakness is the absence of an explicit 'Use when...' trigger clause, which caps the completeness dimension.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user is on Windows, asks for PowerShell commands, or needs native Windows setup instead of Bash or WSL.'

Include natural trigger variations such as 'pwsh', 'powershell.exe', or 'Windows terminal' to broaden keyword coverage.

Optionally enumerate a couple more concrete actions (e.g. environment/PATH inspection, execution-policy handling) to push specificity toward comprehensive coverage.

Dimension	Reasoning	Score
Specificity	Names the PowerShell-on-Windows domain plus three concrete actions ('Run safe PowerShell commands', 'translate Bash snippets', 'troubleshoot native Windows setup'); falls just short of comprehensive coverage rather than listing only 1-2 actions.	4 / 5
Completeness	The 'what' is clear, but there is no explicit 'Use when...' trigger clause, which per the judging guidelines caps completeness at 3 even though the Windows context weakly implies when.	3 / 5
Trigger Term Quality	Natural user-facing terms 'PowerShell', 'Windows', 'Bash', and 'native Windows setup' are present, though it omits common variations like pwsh/powershell.exe.	4 / 5
Distinctiveness Conflict Risk	The PowerShell/Windows-native niche is clearly distinct from Bash and WSL skills, with only minor overlap risk against general Windows-setup or Bash-translation helpers.	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: 9a33f4d

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.