FM-432: pstack sync from upstream skills

.gitignore

@@ -3,3 +3,4 @@ node_modules/
 __pycache__/
 *.pyc
 e2e/.run/
+.tmp-*/

AGENTS.md

@@ -53,6 +53,7 @@ Closeout: re-check paths, update owning docs, refresh indexes, run verification,
 - Static gate (CI and local): `python3 e2e/run.py --skip-rpc` and `npm test` (Vitest).
 - No `omp`, no `omp --mode rpc`, no TUI, no `claude` on GitHub runners. Live RPC is local only: `python3 e2e/run.py` without `--skip-rpc`. Host-only prove (`omp plugin doctor`, `claude plugin validate`) is documented in e2e/AGENTS.md.
 - One factory. Poteto-mode is per-session, never a process-wide boolean.
+- Official skills SoT is `cursor/plugins` `pstack/skills`. Update with `npm run sync` (`node scripts/pstack.mjs sync`). Writes into existing `skills/do-*` only. Not `backnotprop/pstack`, not skills.sh, not `npx skills add`.
 
 ## Native omp
 
@@ -91,5 +92,6 @@ npm test
 | [skills/AGENTS.md](skills/AGENTS.md) | Skill tree; SKILL.md frontmatter `name` + `description` |
 | [docs/AGENTS.md](docs/AGENTS.md) | original numbered `guide/`; first-run lives on README (omp plugin link + Claude plugin install) |
 | [automations/AGENTS.md](automations/AGENTS.md) | Dormant Benny pack; not slash skills |
+| [scripts/AGENTS.md](scripts/AGENTS.md) | `pstack sync`: vendor official skills from cursor/plugins into `skills/do-*` |
 
 `agents/` and `commands/` have no child AGENTS.md; they follow this rail. Commands need frontmatter `description`.

README.md

@@ -38,7 +38,7 @@ cd pstack-for-omp
 omp plugin link ./
 ```
 
-Later sessions (any cwd): start `omp`, type `/` (`/skill:do-…`, sticky `/poteto-mode`). Sibling `skills/` at the package root is what omp auto-discovers after link. Confirm with `omp plugin list`. Prove the link with `omp plugin doctor`.
+Later sessions (any cwd): start `omp`, type `/` (`/skill:do-…`, sticky `/poteto-mode`). Sibling `skills/` at the package root is what omp auto-discovers after link. Confirm with `omp plugin list`. Prove the link with `omp plugin doctor`. Update official skills with `pstack sync` (below).
 
 Do not copy only `pstack.ts` into `~/.omp/agent/extensions/`. Do not marketplace-install this package on omp; local-link is the install path.
 
@@ -98,6 +98,18 @@ That is the live omp extension command. It stays unprefixed. There is no worktre
 - Off aliases: `off`, `disable`, `stop`.
 - No Cursor marketplace APIs. No `models.json` writer. No `hooks/` or `src/` tree.
 
+## Update official skills
+
+Official skills come from the Cursor pstack folder in [cursor/plugins](https://github.com/cursor/plugins/tree/main/pstack), not from `backnotprop/pstack` and not from skills.sh. From this package root:
+
+```
+npm run sync
+```
+
+Same command: `node scripts/pstack.mjs sync`. Dry-run: `npm run sync -- --dry-run`.
+
+That pulls `pstack/skills/<name>` from `cursor/plugins` into the existing `skills/do-*` tree (YAML `name` gets the `do-` prefix). It does not create a second skill tree or install into agent skill directories. Diverged local omp forks stay unless you pass `--force`. This fork keeps `playbooks/shipping.md` deleted.
+
 ## Skills
 
 Files under `skills/` are markdown prompts. They are not live omp functions or CLIs.

e2e/AGENTS.md

@@ -20,6 +20,7 @@ Prove the plugin without chat-only guesses. Static doctor/lint + Vitest on every
 - Do not keep a TypeScript copy of `ci_static.py` (no `unit/static-checks.ts`, no homemade brace parser).
 - Do not keep a repo `.omp/skills` symlink. `static_install_docs` and `unit/product-capabilities.test.ts` assert filesystem absence, not only README text.
 - Claude components stay at plugin root. `.claude-plugin/` may hold `plugin.json` and `marketplace.json` only — not `skills/`.
+- Official skill vendor-sync tests (`unit/sync-skills.test.ts`) stay offline (`--from` fixture). Do not clone `cursor/plugins` on CI.
 
 ## Work Guidance
 

e2e/README.md

@@ -32,6 +32,7 @@ claude plugin validate .
 | Case | What it proves |
 | --- | --- |
 | `install_plugin_link` | README/AGENTS teach `omp plugin link ./` and Claude plugin install; competing stories gone |
+| `pstack sync` | `e2e/unit/sync-skills.test.ts` — official skills SoT is `cursor/plugins`; writes into `skills/do-*` only |
 | `poteto_on` | `/poteto-mode` injects the needle and writes `pstack-mode` on this session |
 | `second_turn_sticky` | Next turn still has the needle |
 | `poteto_off` | `/poteto-mode off` then next turn has no needle |