docs: add skill manager documentation
This commit is contained in:
@@ -0,0 +1,84 @@
|
||||
# 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`, and `implement-plan`. `web-automation` currently has no Cursor variant.
|
||||
|
||||
## 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 variants expect the nested Superpowers layout:
|
||||
|
||||
```bash
|
||||
.cursor/skills/superpowers/skills/<superpower>/SKILL.md
|
||||
~/.cursor/skills/superpowers/skills/<superpower>/SKILL.md
|
||||
```
|
||||
|
||||
Recommended symlink:
|
||||
|
||||
```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
|
||||
```
|
||||
|
||||
Global scope:
|
||||
|
||||
```bash
|
||||
cursor-agent --version
|
||||
test -f ~/.cursor/skills/create-plan/SKILL.md
|
||||
test -f ~/.cursor/skills/superpowers/skills/brainstorming/SKILL.md
|
||||
```
|
||||
Reference in New Issue
Block a user