Home/ai-coding-skills
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

fix(cursor): update skill paths from .cursor/rules/ to .cursor/skills/

Browse Source 
The Cursor Agent CLI now discovers skills from .cursor/skills/ instead
of the old .cursor/rules/ directory. Update all references across
create-plan and implement-plan Cursor variants and docs.
This commit is contained in:
Stefano Fiorini
2026-03-05 12:04:09 -06:00
parent 262aed2950
commit 7352e6a9f7
6 changed files with 40 additions and 40 deletions
Download Patch File Download Diff File Expand all files Collapse all files

22
docs/CREATE-PLAN.md
View File

@@ -12,7 +12,7 @@ Create structured implementation plans with milestone and story tracking, and op
- `superpowers:writing-plans`
- For Codex, native skill discovery must be configured:
- `~/.agents/skills/superpowers -> ~/.codex/superpowers/skills`
- For Cursor, skills must be installed under `.cursor/rules/` (repo-local) or `~/.cursor/rules/` (global)
- For Cursor, skills must be installed under `.cursor/skills/` (repo-local) or `~/.cursor/skills/` (global)
If dependencies are missing, stop and return:
@@ -57,18 +57,18 @@ cp -R skills/create-plan/opencode/* ~/.config/opencode/skills/create-plan/
### Cursor
Copy into the repo-local `.cursor/rules/` directory (where the Cursor Agent CLI discovers skills):
Copy into the repo-local `.cursor/skills/` directory (where the Cursor Agent CLI discovers skills):
```bash
mkdir -p .cursor/rules/create-plan
cp -R skills/create-plan/cursor/* .cursor/rules/create-plan/
mkdir -p .cursor/skills/create-plan
cp -R skills/create-plan/cursor/* .cursor/skills/create-plan/
```
Or install globally (loaded via `~/.cursor/rules/`):
Or install globally (loaded via `~/.cursor/skills/`):
```bash
mkdir -p ~/.cursor/rules/create-plan
cp -R skills/create-plan/cursor/* ~/.cursor/rules/create-plan/
mkdir -p ~/.cursor/skills/create-plan
cp -R skills/create-plan/cursor/* ~/.cursor/skills/create-plan/
```
## Verify Installation
@@ -77,7 +77,7 @@ cp -R skills/create-plan/cursor/* ~/.cursor/rules/create-plan/
test -f ~/.codex/skills/create-plan/SKILL.md || true
test -f ~/.claude/skills/create-plan/SKILL.md || true
test -f ~/.config/opencode/skills/create-plan/SKILL.md || true
test -f .cursor/rules/create-plan/SKILL.md || test -f ~/.cursor/rules/create-plan/SKILL.md || true
test -f .cursor/skills/create-plan/SKILL.md || test -f ~/.cursor/skills/create-plan/SKILL.md || true
```
Verify Superpowers dependencies exist in your agent skills root:
@@ -88,8 +88,8 @@ Verify Superpowers dependencies exist in your agent skills root:
- Claude Code: `~/.claude/skills/superpowers/writing-plans/SKILL.md`
- OpenCode: `~/.config/opencode/skills/superpowers/brainstorming/SKILL.md`
- OpenCode: `~/.config/opencode/skills/superpowers/writing-plans/SKILL.md`
- Cursor: `.cursor/rules/superpowers/brainstorming/SKILL.md` or `~/.cursor/rules/superpowers/brainstorming/SKILL.md`
- Cursor: `.cursor/rules/superpowers/writing-plans/SKILL.md` or `~/.cursor/rules/superpowers/writing-plans/SKILL.md`
- Cursor: `.cursor/skills/superpowers/brainstorming/SKILL.md` or `~/.cursor/skills/superpowers/brainstorming/SKILL.md`
- Cursor: `.cursor/skills/superpowers/writing-plans/SKILL.md` or `~/.cursor/skills/superpowers/writing-plans/SKILL.md`
## Key Behavior
@@ -177,7 +177,7 @@ All plan templates now include guardrail sections that enforce:
### Cursor
- Must use workspace discovery from `.cursor/rules/` (repo-local or `~/.cursor/rules/` global).
- Must use workspace discovery from `.cursor/skills/` (repo-local or `~/.cursor/skills/` global).
- Must announce skill usage explicitly before invocation.
- Must use `--mode=ask` (read-only) and `--trust` when running reviewer non-interactively.
- Must not use `--force` or `--mode=agent` for review (reviewer should never write files).

26
docs/IMPLEMENT-PLAN.md
View File

@@ -19,7 +19,7 @@ Execute an existing plan (created by `create-plan`) in an isolated git worktree,
- `superpowers:finishing-a-development-branch`
- For Codex, native skill discovery must be configured:
- `~/.agents/skills/superpowers -> ~/.codex/superpowers/skills`
- For Cursor, skills must be installed under `.cursor/rules/` (repo-local) or `~/.cursor/rules/` (global)
- For Cursor, skills must be installed under `.cursor/skills/` (repo-local) or `~/.cursor/skills/` (global)
If dependencies are missing, stop and return:
@@ -64,18 +64,18 @@ cp -R skills/implement-plan/opencode/* ~/.config/opencode/skills/implement-plan/
### Cursor
Copy into the repo-local `.cursor/rules/` directory (where the Cursor Agent CLI discovers skills):
Copy into the repo-local `.cursor/skills/` directory (where the Cursor Agent CLI discovers skills):
```bash
mkdir -p .cursor/rules/implement-plan
cp -R skills/implement-plan/cursor/* .cursor/rules/implement-plan/
mkdir -p .cursor/skills/implement-plan
cp -R skills/implement-plan/cursor/* .cursor/skills/implement-plan/
```
Or install globally (loaded via `~/.cursor/rules/`):
Or install globally (loaded via `~/.cursor/skills/`):
```bash
mkdir -p ~/.cursor/rules/implement-plan
cp -R skills/implement-plan/cursor/* ~/.cursor/rules/implement-plan/
mkdir -p ~/.cursor/skills/implement-plan
cp -R skills/implement-plan/cursor/* ~/.cursor/skills/implement-plan/
```
## Verify Installation
@@ -84,7 +84,7 @@ cp -R skills/implement-plan/cursor/* ~/.cursor/rules/implement-plan/
test -f ~/.codex/skills/implement-plan/SKILL.md || true
test -f ~/.claude/skills/implement-plan/SKILL.md || true
test -f ~/.config/opencode/skills/implement-plan/SKILL.md || true
test -f .cursor/rules/implement-plan/SKILL.md || test -f ~/.cursor/rules/implement-plan/SKILL.md || true
test -f .cursor/skills/implement-plan/SKILL.md || test -f ~/.cursor/skills/implement-plan/SKILL.md || true
```
Verify Superpowers execution dependencies exist in your agent skills root:
@@ -101,10 +101,10 @@ Verify Superpowers execution dependencies exist in your agent skills root:
- OpenCode: `~/.config/opencode/skills/superpowers/using-git-worktrees/SKILL.md`
- OpenCode: `~/.config/opencode/skills/superpowers/verification-before-completion/SKILL.md`
- OpenCode: `~/.config/opencode/skills/superpowers/finishing-a-development-branch/SKILL.md`
- Cursor: `.cursor/rules/superpowers/executing-plans/SKILL.md` or `~/.cursor/rules/superpowers/executing-plans/SKILL.md`
- Cursor: `.cursor/rules/superpowers/using-git-worktrees/SKILL.md` or `~/.cursor/rules/superpowers/using-git-worktrees/SKILL.md`
- Cursor: `.cursor/rules/superpowers/verification-before-completion/SKILL.md` or `~/.cursor/rules/superpowers/verification-before-completion/SKILL.md`
- Cursor: `.cursor/rules/superpowers/finishing-a-development-branch/SKILL.md` or `~/.cursor/rules/superpowers/finishing-a-development-branch/SKILL.md`
- Cursor: `.cursor/skills/superpowers/executing-plans/SKILL.md` or `~/.cursor/skills/superpowers/executing-plans/SKILL.md`
- Cursor: `.cursor/skills/superpowers/using-git-worktrees/SKILL.md` or `~/.cursor/skills/superpowers/using-git-worktrees/SKILL.md`
- Cursor: `.cursor/skills/superpowers/verification-before-completion/SKILL.md` or `~/.cursor/skills/superpowers/verification-before-completion/SKILL.md`
- Cursor: `.cursor/skills/superpowers/finishing-a-development-branch/SKILL.md` or `~/.cursor/skills/superpowers/finishing-a-development-branch/SKILL.md`
## Key Behavior
@@ -163,7 +163,7 @@ After each milestone is implemented and verified, the skill sends it to a second
### Cursor
- Must use workspace discovery from `.cursor/rules/` (repo-local or `~/.cursor/rules/` global).
- Must use workspace discovery from `.cursor/skills/` (repo-local or `~/.cursor/skills/` global).
- Must announce skill usage explicitly before invocation.
- Must use `--mode=ask` (read-only) and `--trust` when running reviewer non-interactively.
- Must not use `--force` or `--mode=agent` for review (reviewer should never write files).