deploy-skill-to-cursor
When to use this skill
- You added or changed a skill under
agilebydesign-skills/skills/<name>/and want Cursor to load it from%USERPROFILE%\.cursor\skillswithout maintaining a second copy. - You previously copied a skill into
.cursor\skillsand want to replace that tree with a junction to the repo.
What it does
Creates a directory junction:
- Link:
%USERPROFILE%\.cursor\skills\<SkillName> - Target:
<repo>\skills\<SkillName>
Edits in the repo are visible immediately through the junction path.
Script
scripts/Deploy-SkillToCursor.ps1
# From repo: default infers skills/ from script location
.\skills\deploy-skill-to-cursor\scripts\Deploy-SkillToCursor.ps1 -SkillName story-graph-ops
# Replace an existing folder or junction at the Cursor path
.\skills\deploy-skill-to-cursor\scripts\Deploy-SkillToCursor.ps1 -SkillName story-graph-ops -Force
# Custom repo root (folder that contains skills/)
.\skills\deploy-skill-to-cursor\scripts\Deploy-SkillToCursor.ps1 -SkillName execute_using_rules -SkillsRepoRoot C:\dev\agilebydesign-skills
Parameters
| Parameter | Default | Meaning |
|---|---|---|
SkillName | (required) | Folder name under skills/. |
SkillsRepoRoot | inferred | Path to agilebydesign-skills repo root (contains skills/). Omit when you run the script from this repo layout. |
CursorSkillsRoot | %USERPROFILE%\.cursor\skills | Cursor global skills directory. |
Force | off | Remove existing destination path, then create the junction. |
Notes
- Junctions are Windows directory links; if you move or delete the repo folder, the link breaks until you recreate it or fix the target.
- Do not commit anything under
%USERPROFILE%\.cursor\skills; the canonical skill lives in agilebydesign-skills.