Skip to content

Commit 1072f82

Browse files
committed
docs(skill): clarify AgentSkills vs. clone-based execution
Add a "Getting the executable scripts" section to the root SKILL.md. `npx skills add aloth/PowerSkills` only publishes the Markdown skill definitions into ~\.agents\skills\powerskills\; the .ps1 scripts that actually do the work are not copied there, which surprised early users. The new section: - Explains what AgentSkills installs vs. what it does not. - Shows the `git clone` command to get a working copy. - Documents the recommended `powershell -NoProfile -ExecutionPolicy Bypass -File ...` invocation. - Recommends storing the path once (either agent-side or as a POWERSKILLS_ROOT environment variable) to avoid hard-coding it in every skill call.
1 parent 8deeb13 commit 1072f82

1 file changed

Lines changed: 24 additions & 0 deletions

File tree

SKILL.md

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,30 @@ Windows capabilities for AI agents via PowerShell. Each skill in `skills/` is in
1717
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
1818
```
1919

20+
## Getting the executable scripts
21+
22+
AgentSkills (`npx skills add aloth/PowerSkills`) only publishes the Markdown skill definitions into `~\.agents\skills\powerskills\` (and the per-skill sub-folders). The `.ps1` files that actually do the work are **not** copied there. To run any action you need a working copy of this repository on disk:
23+
24+
```powershell
25+
# Clone once, anywhere you like
26+
git clone https://github.com/aloth/PowerSkills.git C:\Tools\PowerSkills
27+
```
28+
29+
Invoke the CLI with the full path to `powerskills.ps1`:
30+
31+
```powershell
32+
powershell -NoProfile -ExecutionPolicy Bypass `
33+
-File C:\Tools\PowerSkills\powerskills.ps1 <skill> <action> [--param value ...]
34+
```
35+
36+
To avoid repeating the path, either store it agent-side once or set an env var and reference that from any shell:
37+
38+
```powershell
39+
[Environment]::SetEnvironmentVariable("POWERSKILLS_ROOT", "C:\Tools\PowerSkills", "User")
40+
# New shells then use:
41+
powershell -NoProfile -ExecutionPolicy Bypass -File "$env:POWERSKILLS_ROOT\powerskills.ps1" list
42+
```
43+
2044
## Usage
2145

2246
```powershell

0 commit comments

Comments
 (0)