powershell-safe-invocation

Use when writing or running PowerShell on Windows, especially native programs, quoted paths, escaping, pwsh, Start-Process, file operations, or shell troubleshooting.

Quality

95%

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

Quality

Content

100%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, example-driven skill body that delivers executable patterns, an explicit decision order, and validation/safety checkpoints for destructive file operations without a wasted token. It is self-contained with no bundle files, and its section structure is appropriate for the scope.

Dimension	Reasoning	Score
Conciseness	Lean, prescriptive body with no padding or explanation of basics Claude already knows; every section is rules plus executable code, and every token earns its place.	5 / 5
Actionability	Fully executable, copy-paste-ready PowerShell snippets for the common cases (array splatting, hashtable splatting, ProcessStartInfo, pwsh -File invocation) with specific commands and concrete examples.	5 / 5
Workflow Clarity	A numbered Decision Order sequences the safe options from simplest to last-resort, exit-code checks provide validation checkpoints, and the File Operations section adds explicit pre-mutation safety checks (resolve paths, verify inside root, reject empty/root paths).	5 / 5
Progressive Disclosure	No bundle files exist and none are needed; the body is well-organized into clearly headed sections covering the skill at the right depth, satisfying the simple-skill exception for a self-contained skill.	5 / 5
	Total	20 / 20 Passed

Description

90%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, trigger-rich description that clearly states both capability and invocation conditions with concrete Windows/PowerShell-specific terms. Strong on completeness and distinctiveness; only marginally below top on specificity because actions are listed as a phrase rather than enumerated verbs.

Dimension	Reasoning	Score
Specificity	Names concrete actions (writing/running PowerShell, native programs, quoted paths, escaping, pwsh, Start-Process, file operations) but stays at a domain-enumeration level rather than distinct verbs per capability.	4 / 5
Completeness	Explicitly answers 'what' (writing/running PowerShell safely across native programs, paths, escaping, pwsh, Start-Process, file ops) and 'when' via an explicit 'Use when...' clause listing concrete triggers.	5 / 5
Trigger Term Quality	Comprehensive natural terms users would say — 'PowerShell', 'native programs', 'quoted paths', 'escaping', 'pwsh', 'Start-Process', 'file operations', 'shell troubleshooting' — including the key binary name.	5 / 5
Distinctiveness Conflict Risk	A clear niche (safe PowerShell invocation on Windows) with distinct, specific triggers unlikely to overlap with other skills.	5 / 5
	Total	19 / 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: src/extension/plugins/builtin/windows-skills/skills/powershell-safe-invocation/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.