{"_id":"@agent-shells/powershell-skills","_rev":"2-bdd4014914cb406a1a4c8cc8d83f22f0","name":"@agent-shells/powershell-skills","dist-tags":{"latest":"0.5.1"},"versions":{"0.5.0":{"name":"@agent-shells/powershell-skills","version":"0.5.0","license":"MIT","_id":"@agent-shells/powershell-skills@0.5.0","maintainers":[{"name":"chengxu199501","email":"chengxu199501@gmail.com"}],"homepage":"https://github.com/agent-shells/powershell-skills#readme","bugs":{"url":"https://github.com/agent-shells/powershell-skills/issues"},"bin":{"powershell-skills":"bin/powershell-skills.js"},"dist":{"shasum":"ae6abcca2a1d036fcac6df3fb419d4c1244d8acc","tarball":"https://registry.npmjs.org/@agent-shells/powershell-skills/-/powershell-skills-0.5.0.tgz","fileCount":41,"integrity":"sha512-+C6EHkmJq+wrjDPFlOXhgBUX43LecuaedyD0tozpD5zow5iM0HqNoy/4M/9CDs6L3fq8J9szEIHTJl4n8VUHDw==","signatures":[{"sig":"MEUCIQCfX6ZiJUCpKmB9a20/1fjwk5XefRK75+8WFRYtTV62BgIgOVhL/DuitscvIouwDiC9cJf+llGgHnYKoVxesuMaawg=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":184290},"engines":{"node":">=18"},"scripts":{"test":"npm run test:npm","test:npm":"node tests/npm-cli-smoke.js"},"_npmUser":{"name":"chengxu199501","email":"chengxu199501@gmail.com"},"repository":{"url":"git+https://github.com/agent-shells/powershell-skills.git","type":"git"},"_npmVersion":"11.6.2","description":"PowerShell skills and guardrails for reliable Windows command execution by AI agents.","directories":{},"_nodeVersion":"24.11.1","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/powershell-skills_0.5.0_1783010376927_0.21187165678134146","host":"s3://npm-registry-packages-npm-production"}},"0.5.1":{"name":"@agent-shells/powershell-skills","version":"0.5.1","description":"PowerShell skills and guardrails for reliable Windows command execution by AI agents.","license":"MIT","bin":{"powershell-skills":"bin/powershell-skills.js"},"scripts":{"test":"npm run test:npm","test:npm":"node tests/npm-cli-smoke.js"},"repository":{"type":"git","url":"git+https://github.com/agent-shells/powershell-skills.git"},"homepage":"https://github.com/agent-shells/powershell-skills#readme","bugs":{"url":"https://github.com/agent-shells/powershell-skills/issues"},"engines":{"node":">=18"},"publishConfig":{"access":"public"},"_id":"@agent-shells/powershell-skills@0.5.1","_nodeVersion":"24.11.1","_npmVersion":"11.6.2","dist":{"integrity":"sha512-8uWimuQoS402EiighZUPRvJWKq47yPdVKorqQdgUhrus+J3kTh/mTFLd+WjBJJcidI2KhuprcQlL86+qlbA+dA==","shasum":"f75d40203f64f4d0c726de6f570cfc4d23d736c4","tarball":"https://registry.npmjs.org/@agent-shells/powershell-skills/-/powershell-skills-0.5.1.tgz","fileCount":51,"unpackedSize":191327,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQC5kIM4t4B+Rr5yhK0Co9052iP5Gy9D2Tak0wrkJK/r1gIgEU4v6F0xIY/86fC7SVv3O/OEQNzVOFvZOadL56Cpjsc="}]},"_npmUser":{"name":"chengxu199501","email":"chengxu199501@gmail.com"},"directories":{},"maintainers":[{"name":"chengxu199501","email":"chengxu199501@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/powershell-skills_0.5.1_1783011859477_0.7857894649090202"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-02T16:39:36.762Z","modified":"2026-07-02T17:04:19.801Z","0.5.0":"2026-07-02T16:39:37.122Z","0.5.1":"2026-07-02T17:04:19.672Z"},"bugs":{"url":"https://github.com/agent-shells/powershell-skills/issues"},"license":"MIT","homepage":"https://github.com/agent-shells/powershell-skills#readme","repository":{"type":"git","url":"git+https://github.com/agent-shells/powershell-skills.git"},"description":"PowerShell skills and guardrails for reliable Windows command execution by AI agents.","maintainers":[{"name":"chengxu199501","email":"chengxu199501@gmail.com"}],"readme":"# powershell-skills\n\nPowerShell skills and guardrails for reliable Windows command execution by AI agents.\n\n[![npm version](https://img.shields.io/npm/v/@agent-shells/powershell-skills.svg)](https://www.npmjs.com/package/@agent-shells/powershell-skills)\n[![CI](https://github.com/agent-shells/powershell-skills/actions/workflows/ci.yml/badge.svg)](https://github.com/agent-shells/powershell-skills/actions/workflows/ci.yml)\n\nGeneral-purpose coding agents often run Windows and PowerShell less smoothly than Linux or macOS shells. This project gives agents a small, tested runtime aid: agent-facing skills, safe command shapes, compatibility checks, and helper scripts that reduce common Windows command failures.\n\n## Installation\n\nInstall from npm:\n\n```powershell\nnpm install -g @agent-shells/powershell-skills\npowershell-skills install all\npowershell-skills doctor\n```\n\nUpdate explicitly:\n\n```powershell\npowershell-skills update\n```\n\nInstall only one adapter:\n\n```powershell\npowershell-skills install codex\npowershell-skills install claude-code\n```\n\nGitHub install is still supported for unreleased branches or tags:\n\n```powershell\nnpm install -g github:agent-shells/powershell-skills#v0.5.1\n```\n\n## Features\n\n- Codex adapter for user-level skill discovery under `~/.codex/skills`.\n- Claude Code adapter for personal skill discovery under `~/.claude/skills`.\n- `powershell-skills` CLI for install, update, and doctor workflows.\n- Shared execution contract, pattern catalog, and sanitized failure corpus.\n- PowerShell helper scripts for path resolution, command discovery, failure classification, external application execution, and read-only cmdlet execution.\n- `Invoke-AgentPowerShell.ps1` for structured, allowlisted, read-only cmdlets.\n- Windows PowerShell 5.1 and PowerShell 7 verification through GitHub Actions CI.\n\n## Triggering\n\nThe adapters are written for agents, not for humans to prefix every command manually.\n\n- Codex discovers `powershell-command-runner` from `~/.codex/skills`.\n- Claude Code discovers `powershell-command-runner` from `~/.claude/skills`.\n- Both adapters describe Windows, PowerShell, path handling, encoding, filesystem, timeout, and command-failure tasks as trigger cases.\n\nIf a current agent session has not refreshed its skill index, restart the agent or start a new session. Details are in [adapter behavior](docs/adapters.md).\n\n## Compatibility\n\nThe project is tested on:\n\n- Windows PowerShell 5.1 through `powershell.exe`.\n- PowerShell 7 through `pwsh`.\n- Node.js 18+ for the npm CLI wrapper.\n\nThe npm layer is distribution and install UX. PowerShell scripts remain the compatibility source of truth. See [compatibility and verification](docs/compatibility.md).\n\n## Commands\n\n```powershell\npowershell-skills install codex\npowershell-skills install claude-code\npowershell-skills install all\npowershell-skills doctor\npowershell-skills update\n```\n\nUse `powershell-skills doctor` after install or update to check package files, PowerShell hosts, npm, and installed skill locations.\n\n## Verification\n\nRun local checks:\n\n```powershell\nnpm test\nnpm pack --dry-run\npowershell -NoProfile -ExecutionPolicy Bypass -File .\\scripts\\verify-v0.1.ps1\npwsh -NoProfile -ExecutionPolicy Bypass -File .\\scripts\\verify-v0.1.ps1 -PowerShellExe pwsh\n```\n\nExpected result:\n\n```text\n[OK] npm CLI smoke tests passed\n[OK] release verification passed\n```\n\n## Docs\n\n| Topic | Document |\n| --- | --- |\n| Agent adapters and auto-trigger behavior | [docs/adapters.md](docs/adapters.md) |\n| Helper scripts and runners | [docs/helpers.md](docs/helpers.md) |\n| PowerShell 5.1 / 7 compatibility | [docs/compatibility.md](docs/compatibility.md) |\n| Architecture and repository layout | [docs/architecture.md](docs/architecture.md) |\n| Security model and contribution boundaries | [docs/security-model.md](docs/security-model.md) |\n| Field-test notes | [docs/field-tests/README.md](docs/field-tests/README.md) |\n\n## Release Notes\n\n- [v0.1](docs/releases/v0.1.md): Codex skill foundation.\n- [v0.2](docs/releases/v0.2.md): PowerShell 5.1 / 7 compatibility matrix and CI.\n- [v0.3](docs/releases/v0.3.md): Claude Code adapter.\n- [v0.4](docs/releases/v0.4.md): npm distribution, update, doctor, and install UX.\n- [v0.5](docs/releases/v0.5.md): read-only PowerShell cmdlet helper.\n- [v0.5.1](docs/releases/v0.5.1.md): README and documentation polish.\n\n## Contributing and Security\n\n- [Contributing guide](CONTRIBUTING.md)\n- [Security policy](SECURITY.md)\n- [Changelog](CHANGELOG.md)\n\nThis project accepts normal reviewed issues and pull requests. It does not include automatic telemetry, automatic failure upload, periodic collection, or upload of user command context.\n\n## Current Limits\n\n- Supported adapters are Codex and Claude Code.\n- Updates are explicit; there is no background auto-update service.\n- `Invoke-AgentCommand.ps1` runs external applications only.\n- `Invoke-AgentPowerShell.ps1` is read-only and allowlist-based; it is not a general PowerShell script runner.\n- Destructive command execution is not automated and requires validation outside the runner.\n- The failure corpus accepts only maintainer-reviewed, sanitized, minimized cases.\n","readmeFilename":"README.md"}