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` - `superpowers:writing-plans`
- For Codex, native skill discovery must be configured: - For Codex, native skill discovery must be configured:
- `~/.agents/skills/superpowers -> ~/.codex/superpowers/skills` - `~/.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: If dependencies are missing, stop and return:
@@ -57,18 +57,18 @@ cp -R skills/create-plan/opencode/* ~/.config/opencode/skills/create-plan/
### Cursor ### 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 ```bash
mkdir -p .cursor/rules/create-plan mkdir -p .cursor/skills/create-plan
cp -R skills/create-plan/cursor/* .cursor/rules/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 ```bash
mkdir -p ~/.cursor/rules/create-plan mkdir -p ~/.cursor/skills/create-plan
cp -R skills/create-plan/cursor/* ~/.cursor/rules/create-plan/ cp -R skills/create-plan/cursor/* ~/.cursor/skills/create-plan/
``` ```
## Verify Installation ## 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 ~/.codex/skills/create-plan/SKILL.md || true
test -f ~/.claude/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 ~/.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: 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` - Claude Code: `~/.claude/skills/superpowers/writing-plans/SKILL.md`
- OpenCode: `~/.config/opencode/skills/superpowers/brainstorming/SKILL.md` - OpenCode: `~/.config/opencode/skills/superpowers/brainstorming/SKILL.md`
- OpenCode: `~/.config/opencode/skills/superpowers/writing-plans/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/skills/superpowers/brainstorming/SKILL.md` or `~/.cursor/skills/superpowers/brainstorming/SKILL.md`
- Cursor: `.cursor/rules/superpowers/writing-plans/SKILL.md` or `~/.cursor/rules/superpowers/writing-plans/SKILL.md` - Cursor: `.cursor/skills/superpowers/writing-plans/SKILL.md` or `~/.cursor/skills/superpowers/writing-plans/SKILL.md`
## Key Behavior ## Key Behavior
@@ -177,7 +177,7 @@ All plan templates now include guardrail sections that enforce:
### Cursor ### 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 announce skill usage explicitly before invocation.
- Must use `--mode=ask` (read-only) and `--trust` when running reviewer non-interactively. - 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). - 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` - `superpowers:finishing-a-development-branch`
- For Codex, native skill discovery must be configured: - For Codex, native skill discovery must be configured:
- `~/.agents/skills/superpowers -> ~/.codex/superpowers/skills` - `~/.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: If dependencies are missing, stop and return:
@@ -64,18 +64,18 @@ cp -R skills/implement-plan/opencode/* ~/.config/opencode/skills/implement-plan/
### Cursor ### 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 ```bash
mkdir -p .cursor/rules/implement-plan mkdir -p .cursor/skills/implement-plan
cp -R skills/implement-plan/cursor/* .cursor/rules/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 ```bash
mkdir -p ~/.cursor/rules/implement-plan mkdir -p ~/.cursor/skills/implement-plan
cp -R skills/implement-plan/cursor/* ~/.cursor/rules/implement-plan/ cp -R skills/implement-plan/cursor/* ~/.cursor/skills/implement-plan/
``` ```
## Verify Installation ## 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 ~/.codex/skills/implement-plan/SKILL.md || true
test -f ~/.claude/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 ~/.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: 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/using-git-worktrees/SKILL.md`
- OpenCode: `~/.config/opencode/skills/superpowers/verification-before-completion/SKILL.md` - OpenCode: `~/.config/opencode/skills/superpowers/verification-before-completion/SKILL.md`
- OpenCode: `~/.config/opencode/skills/superpowers/finishing-a-development-branch/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/skills/superpowers/executing-plans/SKILL.md` or `~/.cursor/skills/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/skills/superpowers/using-git-worktrees/SKILL.md` or `~/.cursor/skills/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/skills/superpowers/verification-before-completion/SKILL.md` or `~/.cursor/skills/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/finishing-a-development-branch/SKILL.md` or `~/.cursor/skills/superpowers/finishing-a-development-branch/SKILL.md`
## Key Behavior ## Key Behavior
@@ -163,7 +163,7 @@ After each milestone is implemented and verified, the skill sends it to a second
### Cursor ### 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 announce skill usage explicitly before invocation.
- Must use `--mode=ask` (read-only) and `--trust` when running reviewer non-interactively. - 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). - Must not use `--force` or `--mode=agent` for review (reviewer should never write files).

12
skills/create-plan/cursor/SKILL.md
View File

@@ -15,7 +15,7 @@ This skill wraps the current Superpowers flow for the Cursor Agent CLI (`cursor-
3. Review the plan iteratively with a second model/provider 3. Review the plan iteratively with a second model/provider
4. Persist a local execution package in `ai_plan/YYYY-MM-DD-<short-title>/` 4. Persist a local execution package in `ai_plan/YYYY-MM-DD-<short-title>/`
**Core principle:** Cursor Agent CLI discovers skills from `.cursor/rules/` (repo-local or `~/.cursor/rules/` global). It also reads `AGENTS.md` at the repo root for additional instructions. **Core principle:** Cursor Agent CLI discovers skills from `.cursor/skills/` (repo-local or `~/.cursor/skills/` global). It also reads `AGENTS.md` at the repo root for additional instructions.
## Prerequisite Check (MANDATORY) ## Prerequisite Check (MANDATORY)
@@ -23,7 +23,7 @@ Required:
- Cursor Agent CLI: `cursor-agent --version` (install via `curl https://cursor.com/install -fsS | bash`). The binary is `cursor-agent` (installed to `~/.local/bin/`). Some environments alias it as `cursor agent` (subcommand of the Cursor IDE CLI) — both forms work, but this skill uses `cursor-agent` throughout. - Cursor Agent CLI: `cursor-agent --version` (install via `curl https://cursor.com/install -fsS | bash`). The binary is `cursor-agent` (installed to `~/.local/bin/`). Some environments alias it as `cursor agent` (subcommand of the Cursor IDE CLI) — both forms work, but this skill uses `cursor-agent` throughout.
- `jq` (required only if using `cursor` as the reviewer CLI): `jq --version` (install via `brew install jq` or your package manager) - `jq` (required only if using `cursor` as the reviewer CLI): `jq --version` (install via `brew install jq` or your package manager)
- Superpowers repo: `https://github.com/obra/superpowers` - Superpowers repo: `https://github.com/obra/superpowers`
- Superpowers skills installed under `.cursor/rules/` (repo-local) or `~/.cursor/rules/` (global) - Superpowers skills installed under `.cursor/skills/` (repo-local) or `~/.cursor/skills/` (global)
- `superpowers:brainstorming` - `superpowers:brainstorming`
- `superpowers:writing-plans` - `superpowers:writing-plans`
@@ -31,19 +31,19 @@ Verify before proceeding:
```bash ```bash
cursor-agent --version cursor-agent --version
test -f .cursor/rules/superpowers/brainstorming/SKILL.md || test -f ~/.cursor/rules/superpowers/brainstorming/SKILL.md test -f .cursor/skills/superpowers/brainstorming/SKILL.md || test -f ~/.cursor/skills/superpowers/brainstorming/SKILL.md
test -f .cursor/rules/superpowers/writing-plans/SKILL.md || test -f ~/.cursor/rules/superpowers/writing-plans/SKILL.md test -f .cursor/skills/superpowers/writing-plans/SKILL.md || test -f ~/.cursor/skills/superpowers/writing-plans/SKILL.md
# Only if using cursor as reviewer CLI: # Only if using cursor as reviewer CLI:
# jq --version # jq --version
``` ```
If any dependency is missing, stop and return: If any dependency is missing, stop and return:
`Missing dependency: Superpowers planning skills are required (superpowers:brainstorming, superpowers:writing-plans). Install from https://github.com/obra/superpowers and copy into .cursor/rules/ or ~/.cursor/rules/, then retry.` `Missing dependency: Superpowers planning skills are required (superpowers:brainstorming, superpowers:writing-plans). Install from https://github.com/obra/superpowers and copy into .cursor/skills/ or ~/.cursor/skills/, then retry.`
## Required Skill Invocation Rules ## Required Skill Invocation Rules
- Invoke relevant skills through workspace discovery (`.cursor/rules/`). - Invoke relevant skills through workspace discovery (`.cursor/skills/`).
- Announce skill usage explicitly: - Announce skill usage explicitly:
- `I've read the [Skill Name] skill and I'm using it to [purpose].` - `I've read the [Skill Name] skill and I'm using it to [purpose].`
- For skills with checklists, track checklist items explicitly in conversation. - For skills with checklists, track checklist items explicitly in conversation.

2
skills/create-plan/cursor/templates/continuation-runbook.md
View File

@@ -16,7 +16,7 @@ Do NOT reference planner-private files during implementation.
## Skill Workflow Guardrails ## Skill Workflow Guardrails
- Invoke relevant skills before action using workspace discovery (`.cursor/rules/`). - Invoke relevant skills before action using workspace discovery (`.cursor/skills/`).
- Announce which skill is being used and why. - Announce which skill is being used and why.
- If a checklist-driven skill applies, track checklist execution explicitly. - If a checklist-driven skill applies, track checklist execution explicitly.

2
skills/create-plan/cursor/templates/milestone-plan.md
View File

@@ -7,7 +7,7 @@
## Planning Guardrails ## Planning Guardrails
- This plan assumes design was validated before implementation planning. - This plan assumes design was validated before implementation planning.
- Skills are invoked via workspace discovery (`.cursor/rules/`). - Skills are invoked via workspace discovery (`.cursor/skills/`).
- Milestones require verification + local commits + explicit approval before proceeding. - Milestones require verification + local commits + explicit approval before proceeding.
## Context ## Context

16
skills/implement-plan/cursor/SKILL.md
View File

@@ -16,7 +16,7 @@ This skill wraps the Superpowers execution flow for the Cursor Agent CLI (`curso
4. Review each milestone with a second model/provider 4. Review each milestone with a second model/provider
5. Commit approved milestones, merge to parent branch, and delete worktree 5. Commit approved milestones, merge to parent branch, and delete worktree
**Core principle:** Cursor Agent CLI discovers skills from `.cursor/rules/` (repo-local or `~/.cursor/rules/` global). It also reads `AGENTS.md` at the repo root for additional instructions. **Core principle:** Cursor Agent CLI discovers skills from `.cursor/skills/` (repo-local or `~/.cursor/skills/` global). It also reads `AGENTS.md` at the repo root for additional instructions.
## Prerequisite Check (MANDATORY) ## Prerequisite Check (MANDATORY)
@@ -28,7 +28,7 @@ Required:
- `milestone-plan.md` exists in plan folder - `milestone-plan.md` exists in plan folder
- `story-tracker.md` exists in plan folder - `story-tracker.md` exists in plan folder
- Git repo with worktree support: `git worktree list` - Git repo with worktree support: `git worktree list`
- Superpowers skills installed under `.cursor/rules/` (repo-local) or `~/.cursor/rules/` (global) - Superpowers skills installed under `.cursor/skills/` (repo-local) or `~/.cursor/skills/` (global)
- Superpowers execution skills: - Superpowers execution skills:
- `superpowers:executing-plans` - `superpowers:executing-plans`
- `superpowers:using-git-worktrees` - `superpowers:using-git-worktrees`
@@ -39,17 +39,17 @@ Verify before proceeding:
```bash ```bash
cursor-agent --version cursor-agent --version
test -f .cursor/rules/superpowers/executing-plans/SKILL.md || test -f ~/.cursor/rules/superpowers/executing-plans/SKILL.md test -f .cursor/skills/superpowers/executing-plans/SKILL.md || test -f ~/.cursor/skills/superpowers/executing-plans/SKILL.md
test -f .cursor/rules/superpowers/using-git-worktrees/SKILL.md || test -f ~/.cursor/rules/superpowers/using-git-worktrees/SKILL.md test -f .cursor/skills/superpowers/using-git-worktrees/SKILL.md || test -f ~/.cursor/skills/superpowers/using-git-worktrees/SKILL.md
test -f .cursor/rules/superpowers/verification-before-completion/SKILL.md || test -f ~/.cursor/rules/superpowers/verification-before-completion/SKILL.md test -f .cursor/skills/superpowers/verification-before-completion/SKILL.md || test -f ~/.cursor/skills/superpowers/verification-before-completion/SKILL.md
test -f .cursor/rules/superpowers/finishing-a-development-branch/SKILL.md || test -f ~/.cursor/rules/superpowers/finishing-a-development-branch/SKILL.md test -f .cursor/skills/superpowers/finishing-a-development-branch/SKILL.md || test -f ~/.cursor/skills/superpowers/finishing-a-development-branch/SKILL.md
# Only if using cursor as reviewer CLI: # Only if using cursor as reviewer CLI:
# jq --version # jq --version
``` ```
If any dependency is missing, stop and return: If any dependency is missing, stop and return:
`Missing dependency: [specific missing item]. Install from https://github.com/obra/superpowers and copy into .cursor/rules/ or ~/.cursor/rules/, then retry.` `Missing dependency: [specific missing item]. Install from https://github.com/obra/superpowers and copy into .cursor/skills/ or ~/.cursor/skills/, then retry.`
If no plan folder exists: If no plan folder exists:
@@ -57,7 +57,7 @@ If no plan folder exists:
## Required Skill Invocation Rules ## Required Skill Invocation Rules
- Invoke relevant skills through workspace discovery (`.cursor/rules/`). - Invoke relevant skills through workspace discovery (`.cursor/skills/`).
- Announce skill usage explicitly: - Announce skill usage explicitly:
- `I've read the [Skill Name] skill and I'm using it to [purpose].` - `I've read the [Skill Name] skill and I'm using it to [purpose].`
- For skills with checklists, track checklist items explicitly in conversation. - For skills with checklists, track checklist items explicitly in conversation.