stefano
251148c3ff
## Summary - add repository-wide quality tooling and verification scaffolding, including CI workflows, pnpm workspace setup, ESLint/Prettier/markdown checks, and generated-output verification helpers - reorganize skill sources and generation flow by introducing canonical `_source` variants, generator/manifests, reusable helper abstractions, and shared web-automation/browser utilities - clean up and expand documentation so the root README flows into docs and skill docs, with clearer development, reviewer, installer, and workflow guidance ## Notable changes - docs flow and consistency cleanup across `README.md`, `docs/README.md`, and related docs - new scripts for `check`, docs verification, generated-file verification, shell portability, and safe directory replacement - refactors in Atlassian and web-automation skill runtimes to reduce duplication and centralize reusable code - changelog, development documentation, and CI surface updates ## Test Plan - [ ] `pnpm run check` - [ ] review generated/manifests and skill sync outputs - [ ] smoke-check docs flow from `README.md` to `docs/README.md` to skill docs ## Notes - this branch currently includes tracked `skills/web-automation/shared/node_modules` content that should be reviewed carefully as potentially noisy/accidental committed artifacts Co-authored-by: Stefano Fiorini <stefano.fiorini@firsthorizon.com> Reviewed-on: #1
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 .
|
|
```
|