Stefano Fiorini
102 lines
2.8 KiB
Markdown
102 lines
2.8 KiB
Markdown
# Cursor Manual Install
|
|
|
|
## Skill Roots
|
|
|
|
Cursor supports repo-local and global skills:
|
|
|
|
```bash
|
|
.cursor/skills/<skill-name>/
|
|
~/.cursor/skills/<skill-name>/
|
|
```
|
|
|
|
Manual repo-local install example:
|
|
|
|
```bash
|
|
mkdir -p .cursor/skills/create-plan
|
|
cp -R skills/create-plan/cursor/* .cursor/skills/create-plan/
|
|
```
|
|
|
|
Global install example:
|
|
|
|
```bash
|
|
mkdir -p ~/.cursor/skills/create-plan
|
|
cp -R skills/create-plan/cursor/* ~/.cursor/skills/create-plan/
|
|
```
|
|
|
|
Cursor variants exist for `atlassian`, `create-plan`, `do-task`, `implement-plan`, and `web-automation`.
|
|
|
|
Web automation repo-local install:
|
|
|
|
```bash
|
|
mkdir -p .cursor/skills/web-automation
|
|
cp -R skills/web-automation/cursor/* .cursor/skills/web-automation/
|
|
cd .cursor/skills/web-automation/scripts
|
|
pnpm install
|
|
npx cloakbrowser install
|
|
pnpm approve-builds
|
|
pnpm rebuild better-sqlite3 esbuild
|
|
```
|
|
|
|
Global web automation installs use `~/.cursor/skills/web-automation/` instead.
|
|
|
|
## Reviewer Runtime
|
|
|
|
Repo-local:
|
|
|
|
```bash
|
|
mkdir -p .cursor/skills/reviewer-runtime
|
|
cp skills/reviewer-runtime/run-review.sh .cursor/skills/reviewer-runtime/
|
|
cp skills/reviewer-runtime/notify-telegram.sh .cursor/skills/reviewer-runtime/
|
|
chmod +x .cursor/skills/reviewer-runtime/*.sh
|
|
```
|
|
|
|
Global uses `~/.cursor/skills/reviewer-runtime/` instead.
|
|
|
|
## Superpowers
|
|
|
|
Cursor can discover Superpowers from the Cursor plugin cache or from manual repo-local/global
|
|
skill roots. Prefer the plugin install when it is present; do not also install a manual Superpowers
|
|
copy, or Cursor may show each Superpowers skill twice.
|
|
|
|
```bash
|
|
~/.cursor/plugins/cache/cursor-public/superpowers/<revision>/skills/<superpower>/SKILL.md
|
|
.cursor/skills/superpowers/skills/<superpower>/SKILL.md
|
|
~/.cursor/skills/superpowers/skills/<superpower>/SKILL.md
|
|
```
|
|
|
|
Manual symlink, only when the Cursor plugin is not installed:
|
|
|
|
```bash
|
|
mkdir -p .cursor/skills/superpowers
|
|
ln -s /absolute/path/to/obra/superpowers/skills .cursor/skills/superpowers/skills
|
|
```
|
|
|
|
## Cursor Reviewer Notes
|
|
|
|
Cursor reviewer calls use JSON output and require `jq` where the skill variant parses reviewer responses:
|
|
|
|
```bash
|
|
cursor-agent --version
|
|
jq --version
|
|
```
|
|
|
|
Reviewer calls must use `--mode=ask --trust --output-format json`, never write-capable modes.
|
|
|
|
## Verify
|
|
|
|
Repo-local scope:
|
|
|
|
```bash
|
|
cursor-agent --version
|
|
test -f .cursor/skills/create-plan/SKILL.md
|
|
test -f .cursor/skills/superpowers/skills/brainstorming/SKILL.md || find ~/.cursor/plugins/cache/cursor-public/superpowers -path '*/skills/brainstorming/SKILL.md' -print -quit 2>/dev/null | grep -q .
|
|
```
|
|
|
|
Global scope:
|
|
|
|
```bash
|
|
cursor-agent --version
|
|
test -f ~/.cursor/skills/create-plan/SKILL.md
|
|
test -f ~/.cursor/skills/superpowers/skills/brainstorming/SKILL.md || find ~/.cursor/plugins/cache/cursor-public/superpowers -path '*/skills/brainstorming/SKILL.md' -print -quit 2>/dev/null | grep -q .
|
|
```
|