diff --git a/.claude/skills/pr/SKILL.md b/.claude/skills/pr/SKILL.md
index 0058ff9..fc6f518 100644
--- a/.claude/skills/pr/SKILL.md
+++ b/.claude/skills/pr/SKILL.md
@@ -5,6 +5,6 @@ metadata:
   owner: "@makerx/yoke"
 ---
 
-From the repo root, run `npx yoke pr raise --help` and follow it exactly. Do not use `gh pr create`.
+Run `yoke pr raise --help` and follow it exactly. Do not use `gh pr create`.
 
-If `yoke` is not found, run `npm install` at the repo root and retry.
+If `yoke` is not found, run `npm i -g @makerx/yoke` and retry.
diff --git a/README.md b/README.md
index a3d0e37..4b80878 100644
--- a/README.md
+++ b/README.md
@@ -11,8 +11,12 @@ Claude Code skills for MakerX AI-assisted delivery, and the CLI they call.
 ## Usage
 
 ```bash
-npm i -D @makerx/yoke   # at the repo root
-npx yoke sync           # then commit .claude/skills
+npm i -g @makerx/yoke
+
+# then either
+yoke sync          # this repo's .claude/skills
+# or
+yoke sync --user   # ~/.claude/skills
 ```
 
 ## Skills
diff --git a/src/features/pr/skill.ts b/src/features/pr/skill.ts
index 551bcf8..7a99add 100644
--- a/src/features/pr/skill.ts
+++ b/src/features/pr/skill.ts
@@ -5,8 +5,8 @@ export const prSkill: Skill = {
   description:
     'Raise a PR with a concise What/Why/(How) description. Use when asked to raise, open or create a pull request, or to rewrite a PR description.',
   body: `
-From the repo root, run \`npx yoke pr raise --help\` and follow it exactly. Do not use \`gh pr create\`.
+Run \`yoke pr raise --help\` and follow it exactly. Do not use \`gh pr create\`.
 
-If \`yoke\` is not found, run \`npm install\` at the repo root and retry.
+If \`yoke\` is not found, run \`npm i -g @makerx/yoke\` and retry.
 `,
 }