# Powershell Skill

> Execute PowerShell commands on Windows systems with security constraints

- Skill: `majiayu000/powershell-skill` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add majiayu000/powershell-skill`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/powershell-skill/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Security
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/powershell-skill

---


## Purpose
This skill allows the agent to execute safe PowerShell commands for:
- System information gathering (Get-ComputerInfo, Get-Process)
- File system queries (Get-ChildItem, Test-Path)
- Date/time operations (Get-Date)
- Service status checks (Get-Service)

## When to Use
- User requests system information
- Need to check file existence or directory contents
- Querying running processes or services
- Getting current date, time, or location

## Instructions
1. **Validate Intent**: Ensure the user's request is safe and appropriate
2. **Review Security**: Check security.md for constraints before execution
3. **Use Allowed Cmdlets**: Only use cmdlets from the whitelist
4. **Explain Actions**: Tell the user what command you're running and why
5. **Handle Errors**: If execution fails, explain the error clearly

## Parameters
- `command` (string, required): The PowerShell command to execute
- `timeout` (int, optional): Maximum execution time in seconds (default: 10)

## Example Usage
```python
from skills.powershell import execute

# Get current date
result = execute('Get-Date')
if result['success']:
    print(result['output'])

# List directory contents
result = execute('Get-ChildItem -Path C:\\Users')
```

## Additional Context
- See reference.md for PowerShell cmdlet documentation
- See security.md for security boundaries and constraints