Agent Skills › OpenBMB/PilotDeck › powershell

powershell

GitHub

指导在 Windows 环境下使用 PowerShell 执行安全命令、翻译 Bash 片段及排查原生 Windows 设置问题，涵盖环境检查、路径管理及依赖安装规范。

skills/powershell/SKILL.md OpenBMB/PilotDeck

Trigger Scenarios

用户在 Windows 系统上请求 PowerShell 命令需要将 Bash 脚本转换为 PowerShell 需要排查或配置原生 Windows 开发环境

Install

npx skills add OpenBMB/PilotDeck --skill powershell -g -y

More Options

Use without installing

npx skills use OpenBMB/PilotDeck@powershell

指定 Agent (Claude Code)

npx skills add OpenBMB/PilotDeck --skill powershell -a claude-code -g -y

安装 repo 全部 skill

npx skills add OpenBMB/PilotDeck --all -g -y

预览 repo 内 skill

npx skills add OpenBMB/PilotDeck --list

SKILL.md

Frontmatter

{
    "name": "powershell",
    "description": "Run safe PowerShell commands on Windows, translate Bash snippets, and troubleshoot native Windows setup."
}

PowerShell

Use this skill when the user is on Windows, asks for PowerShell commands, or needs native Windows setup/troubleshooting instead of Bash or WSL.

Shell Choice

Prefer pwsh when PowerShell 7 is installed.
Use powershell.exe for built-in Windows PowerShell compatibility.
In documentation, use fenced code blocks with powershell and avoid Bash-only operators such as && unless explicitly running inside WSL/Git Bash.

Safe Command Patterns

Read-only checks:

$PSVersionTable.PSVersion
Get-Command node, npm, git, python, rg -ErrorAction SilentlyContinue
node --version
npm --version
git --version
python --version
rg --version

Path inspection:

Get-Location
Get-ChildItem
Resolve-Path .
$env:PATH -split ';'

Run commands in sequence with explicit lines:

Set-Location C:\path\to\PilotDeck
node --version
corepack enable
corepack pnpm install --frozen-lockfile

Use npm.cmd or pnpm.cmd when PowerShell execution policy blocks .ps1 shims:

npm.cmd --version
pnpm.cmd --version

PilotDeck Native Windows Notes

Native Windows source installs need Node.js 22, Git/Git LFS, Python, Visual Studio C++ Build Tools, and ripgrep. WSL2 is usually simpler for development, but native PowerShell is supported for users who want a Windows-only workflow.

Install common prerequisites with winget:

winget install OpenJS.NodeJS.LTS
winget install Git.Git
winget install GitHub.GitLFS
winget install Python.Python.3.12
winget install BurntSushi.ripgrep.MSVC
winget install Microsoft.VisualStudio.2022.BuildTools --override "--wait --add Microsoft.VisualStudio.Workload.VCTools --includeRecommended"

After installing tools, close and reopen PowerShell so PATH changes take effect.

Safety

Be careful with destructive commands such as Remove-Item -Recurse -Force; confirm the target path first.
Avoid changing execution policy globally unless the user explicitly asks and understands the risk.
Prefer project-local or session-local changes over machine-wide changes.