Skip to content

alexandair/powershell-skills

v0.1.0MIT

PowerShell 7 development skills with a bundled PowerShell MCP server for parsing, command discovery, metadata, and help.

GitHubOpen Website

PowerShell Skills

PowerShell Skills is an Agent Plugins 1.0 package for PowerShell 7 development. It includes reusable skills and the optional psmcp-builtin MCP server for parsing supplied script text and discovering PowerShell commands, metadata, and help.

Support

Version 0.1.0 is tested and supported on Windows x64. It requires PowerShell 7.4 or later. Building from source also requires the .NET 8 SDK.

Install Skills Only

Each directory under skills/ is portable on its own. Copy one or more skill directories into the target harness's skill location. No plugin manifest or MCP server is required for this installation path.

Included skills:

  • powershell-module-authoring
  • powershell-error-handling
  • powershell-pester-testing
  • powershell-code-review

Install the Plugin from Source

Build the bundled MCP server first:

./psmcp/build.ps1

Then install this repository with a compatible Agent Plugin client. In VS Code with GitHub Copilot, use Chat: Install Plugin From Source, or register the directory in chat.pluginLocations:

{
  "chat.pluginLocations": {
    "C:/path/to/powershell-skills": true
  }
}

The root mcp.json starts only psmcp-builtin. It does not execute workspace scripts or import workspace modules.

Install PSMCP Only

psmcp/ can be used without the skills or plugin manifest. Build it with ./psmcp/build.ps1, then use the direct VS Code and Agent Plugin configuration examples in psmcp/README.md.

MCP Tools

The bundled server exposes read-only built-ins including parse_script, search_commands, get_command_metadata, get_help_for_cmdlet, get_help_examples, get_parameter_help, resolve_command, get_completion, and get_about_help.

parse_script never executes supplied PowerShell. get_online_help and explicit onlineFallback: true requests make outbound HTTPS requests; other built-in tools do not.

Releases

Tagged releases publish powershell-skills-<version>-win-x64.zip and a matching .sha256 file. The ZIP contains the plugin files, source, tests, examples, and prebuilt psmcp/out module. Verify a download with:

Get-FileHash .\powershell-skills-<version>-win-x64.zip -Algorithm SHA256

Version 0.1.0 is unsigned. The checksum verifies artifact integrity, not publisher identity.

Security

Installed plugins are trusted local code. MCP tool annotations are descriptive, not a sandbox. The bundled server is read-only, while standalone psmcp script and module modes execute explicitly selected code with the permissions of the pwsh process. Report vulnerabilities through GitHub private vulnerability reporting as described in SECURITY.md.

Package Layout

plugin.json             Agent Plugins 1.0 manifest
mcp.json                Portable stdio MCP configuration
skills/                 Portable Agent Skills
psmcp/                  PowerShell MCP Server source, tests, and examples
scripts/                Package validation and release packaging

Specifications