@rch4com/agent-setup 1.11.1 → 1.14.0

package/install.mjs

@@ -70,7 +70,20 @@ async function runClassic(root, { dryRun, listOnly, setArg, t }) {
   for (const id of selectedIds) if (!known.has(id)) throw new LocalizedError('error.unknownItem', { id })
   assertExclusive(items, selectedIds)
 
-  const changes = planChanges(states, selectedIds)
+  // 전역(scope: 'user') 항목은 --set 생략만으로 지우지 않는다. --set은 "저장소가
+  // 가질 상태"의 선언이라 목록 밖 항목을 제거하는데, 전역 항목까지 그 규칙에
+  // 태우면 무관한 --set 실행 하나가 머신 전체 설치를 걷어 간다 — 스크래치
+  // 저장소에서 스킬 둘을 --set 하다가 copilot의 전역 superpowers가 함께
+  // 제거되는 것을 실측했다(2026-08-15). 전역 항목의 제거는 TUI에서 명시적으로
+  // 해제해 검토 화면을 거친다.
+  const changes = []
+  for (const c of planChanges(states, selectedIds)) {
+    if (c.action === 'uninstall' && c.item.scope === 'user') {
+      console.log(t('run.keepUserScope', { id: c.item.id }))
+      continue
+    }
+    changes.push(c)
+  }
   if (changes.length === 0) { console.log(t('apply.noChanges')); return }
 
   // 비대화형 경로다 — 바를 그리지 않고 평문 한 줄씩 흘린다.

package/lib/bootstrap/manifest.mjs

@@ -52,8 +52,20 @@ export const MANIFEST = {
     { path: '.vscode/settings.json', key: 'chat.useAgentsMdFile', value: true },
   ],
 
-  // .agents/skills 를 가리키는 도구별 어댑터
-  // 두 Copilot은 .agents/skills를 네이티브로 탐색하므로 여기에 없다.
+  // .agents/skills 를 가리키는 도구별 어댑터.
+  //
+  // 여기에 없는 도구는 그 경로를 네이티브로 읽는다 — 2026-08-15에 도구별로
+  // 실측했다. Codex는 `codex debug prompt-input`이 프로젝트 SKILL.md 경로를
+  // 그대로 찍고, OpenCode·Kilo Code는 `debug skill`이, Copilot CLI는
+  // `skill list`가 같은 것을 보여 준다. Kimi Code는 배포본에
+  // `PROJECT_GENERIC_DIRS = [".agents/skills"]`가 있고, VS Code Copilot 확장은
+  // 프로젝트 경로 표에 `.agents/skills/<name>/`를 싣는다. Antigravity 바이너리도
+  // `{workspace}/.agents/skills/{skill_name}/SKILL.md`를 갖고 있다.
+  //
+  // 네이티브로 읽는 도구에 어댑터를 더하면 같은 스킬이 두 경로에서 잡혀 중복
+  // 등록된다 — 목록을 늘리기 전에 반드시 그 도구가 못 읽는 것을 먼저 확인한다.
+  // Kiro가 그 증거다: 확장이 `~/.kiro/skills/`와 `<workspace>/.kiro/skills/`만
+  // 훑고 `.agents/skills`는 한 번도 참조하지 않아, 이 어댑터가 있어야만 닿는다.
   adapters: [
     { tool: 'Claude Code', path: '.claude/skills' },
     { tool: 'Kiro', path: '.kiro/skills' },

package/lib/catalog.mjs

@@ -1,4 +1,4 @@
-import { existsSync, readdirSync, readFileSync, rmSync, statSync } from 'node:fs'
+import { existsSync, readdirSync, readFileSync, rmSync, statSync, writeFileSync } from 'node:fs'
 import { join, dirname } from 'node:path'
 import { fileURLToPath, pathToFileURL } from 'node:url'
 import { execFile } from 'node:child_process'
@@ -140,12 +140,12 @@ export function defineMcp({ id, label, server, supports = [...CLI_IDS], unsuppor
 // 배선은 Claude 한 곳이라도 미배선 "사유"는 CLI마다 다를 수 있다 — 상류가
 // 자체 경로로 지원하는 CLI에 일괄 "Claude 전용" 사유를 붙이면 거짓 정보가 된다.
 // 항목이 사유를 넘기면 그 CLI만 덮고, 나머지는 기본 사유로 채운다.
-export function definePlugin({ id, label, installId, detectIds, marketplace, note, group = null, unsupported: reasons = {} }) {
+export function definePlugin({ id, label, installId, detectIds, marketplace, note, group = null, exclusive = null, unsupported: reasons = {} }) {
   const unsupported = Object.fromEntries(
     CLI_IDS.filter((c) => c !== 'claude').map((c) => [c, reasons[c] ?? msg('item.unsupported.claudePlugin')]),
   )
   return {
-    id, category: 'plugin', label, scope: 'project', supports: ['claude'], unsupported, note, group,
+    id, category: 'plugin', label, scope: 'project', supports: ['claude'], unsupported, note, group, exclusive,
     async detect({ root }) {
       return { status: isPluginEnabled(root, detectIds) ? 'installed' : 'absent' }
     },
@@ -207,28 +207,91 @@ function findSkillDir(root, skill) {
   return null
 }
 
+// 레지스트리가 저장소 루트에 남기는 잠금 파일. 스킬 이름마다 어느 출처에서
+// 왔는지를 적어 두므로, 한 상류가 여러 스킬을 깔았을 때 "우리가 넣은 것"만
+// 골라 지울 수 있는 유일한 근거다.
+const SKILLS_LOCK = 'skills-lock.json'
+
+// 잠금 파일의 source는 `owner/repo`로 정규화돼 있고 항목은 URL을 넘긴다.
+function sourceKey(source) {
+  return String(source).replace(/^https?:\/\/github\.com\//, '').replace(/\.git$/, '').replace(/\/+$/, '')
+}
+
+function readLock(root) {
+  const file = repoPath(root, SKILLS_LOCK)
+  if (!existsSync(file)) return null
+  try {
+    return JSON.parse(readFileSync(file, 'utf8'))
+  } catch {
+    // 잠금 파일이 깨졌다고 제거를 막지는 않는다 — 디렉터리 스캔 폴백이 있다.
+    return null
+  }
+}
+
+function lockedSkills(root, source) {
+  const want = sourceKey(source)
+  return Object.entries(readLock(root)?.skills ?? {})
+    .filter(([, v]) => sourceKey(v?.source ?? '') === want)
+    .map(([name]) => name)
+}
+
+// 레지스트리의 remove는 디렉터리도, 잠금 파일의 항목도 남긴다(실측). 디렉터리는
+// 아래에서 우리가 지우는데 잠금 항목을 그대로 두면 파일이 "설치돼 있다"고
+// 거짓말한다 — 커밋해서 팀과 나누는 파일이라, 동료가 experimental_install로
+// 복원하면 지운 스킬이 되살아난다.
+function pruneLock(root, names) {
+  const parsed = readLock(root)
+  const skills = parsed?.skills
+  if (!skills) return
+  const gone = names.filter((n) => Object.hasOwn(skills, n))
+  if (gone.length === 0) return
+  for (const n of gone) delete skills[n]
+  const file = repoPathStrict(root, SKILLS_LOCK)
+  // 남은 스킬이 없으면 파일째 지운다. 이 파일은 레지스트리가 만든 산출물이라
+  // 빈 껍데기를 남기면 우리가 만든 흔적이 저장소에 계속 남는다.
+  if (Object.keys(skills).length === 0) rmSync(file, { force: true })
+  else writeFileSync(file, `${JSON.stringify(parsed, null, 2)}\n`)
+}
+
 // vercel-labs/skills 레지스트리로 설치하는 스킬. `--agent universal`의 프로젝트
 // 경로가 .agents/skills라, 한 번 설치하면 10개 CLI가 함께 본다 — Claude·Kiro·
-// Grok은 부트스트랩이 만든 Junction으로, 나머지는 그 경로를 네이티브로 읽는다.
+// Grok은 부트스트랩이 만든 Junction으로, 나머지는 그 경로를 네이티브로 읽는다
+// (도구별 실측 근거는 bootstrap/manifest.mjs의 adapters 주석에 있다).
 // `--copy`로 실물을 남긴다: 커밋해서 팀과 나누는 자리라 링크는 클론 뒤 깨진다.
-export function defineRegistrySkill({ id, label, source, skill, note, group = null }) {
+//
+// skill에 `*`를 주면 그 상류의 스킬을 전부 넣는다. 그때 detect가 볼 대표
+// 스킬을 anchor로 지정해야 한다 — 디렉터리가 여럿이라 "무엇이 있으면 설치된
+// 것인가"를 이름 하나로 정해 두지 않으면 판정이 흔들린다.
+//
+// exclusive는 같은 상류를 플러그인으로도 넣을 수 있을 때 쓴다. 두 경로가 겹치면
+// 같은 스킬이 두 번 등록되므로 하나만 고르게 막는다.
+export function defineRegistrySkill({ id, label, source, skill, anchor = null, note, group = null, exclusive = null }) {
+  const probe = anchor ?? skill
+  if (skill === '*' && !anchor) throw new LocalizedError('error.registrySkillAnchor', { id })
   return {
-    id, category: 'skill', label, scope: 'project', supports: [...CLI_IDS], unsupported: {}, note, group,
+    id, category: 'skill', label, scope: 'project', supports: [...CLI_IDS], unsupported: {}, note, group, exclusive,
     async detect({ root }) {
-      return { status: findSkillDir(root, skill) ? 'installed' : 'absent' }
+      return { status: findSkillDir(root, probe) ? 'installed' : 'absent' }
     },
     async install({ root, exec }) {
       const r = await exec('npx', ['-y', 'skills@latest', 'add', source, '--skill', skill, '--agent', 'universal', '--yes', '--copy'], { cwd: root })
       if (!r.ok) throw new LocalizedError('error.registrySkillInstall', { skill, output: r.output })
     },
     async uninstall({ root, dryRun, exec }) {
-      // 레지스트리의 remove는 --agent universal에서 "Done!"을 찍고도 디렉터리를
-      // 남긴다(실측). 그래서 성공/실패와 무관하게 남은 디렉터리를 우리가 지운다 —
-      // 남겨 두면 detect가 계속 installed로 읽어 제거가 안 된 채 성공으로 보인다.
-      await exec('npx', ['-y', 'skills@latest', 'remove', skill, '--agent', 'universal', '--yes'], { cwd: root })
-      if (dryRun) return
-      const dir = findSkillDir(root, skill)
-      if (dir) rmSync(repoPathStrict(root, `${SHARED_SKILLS}/${dir}`), { recursive: true, force: true })
+      // 지울 이름을 먼저 정한다. 여러 스킬을 깐 항목은 잠금 파일이 알려 주고,
+      // 잠금 파일이 없거나 깨졌으면 대표 스킬 하나라도 치운다.
+      const names = skill === '*' ? lockedSkills(root, source) : [skill]
+      const targets = names.length > 0 ? names : [probe]
+      for (const name of targets) {
+        // 레지스트리의 remove는 --agent universal에서 "Done!"을 찍고도 디렉터리를
+        // 남긴다(실측). 그래서 성공/실패와 무관하게 남은 디렉터리를 우리가 지운다 —
+        // 남겨 두면 detect가 계속 installed로 읽어 제거가 안 된 채 성공으로 보인다.
+        await exec('npx', ['-y', 'skills@latest', 'remove', name, '--agent', 'universal', '--yes'], { cwd: root })
+        if (dryRun) continue
+        const dir = findSkillDir(root, name)
+        if (dir) rmSync(repoPathStrict(root, `${SHARED_SKILLS}/${dir}`), { recursive: true, force: true })
+      }
+      if (!dryRun) pruneLock(root, targets)
     },
   }
 }

package/lib/global-plugin.mjs

@@ -0,0 +1,207 @@
+// 사용자 전역(scope: 'user') 플러그인 항목의 공통 기구. 상류가 하니스별 전역
+// 설치만 지원하는 도구(superpowers, ponytail)가 공유한다 — 항목 파일
+// (lib/items/global.*.mjs)은 상류별 좌표와 미배선 사유만 든다.
+//
+// 전역 파일을 만지므로 repoPath 계열 가드를 일부러 안 쓴다 — 저장소 이탈이
+// 목적인 기구다. 항목 파일에 두지 않는 이유는 gitmessage.mjs와 같다:
+// loadItems가 items/의 모든 .mjs를 항목으로 읽는다.
+//
+// 하니스별 기록 위치(2026-08-15 실측, 상세는 global.superpowers.mjs):
+//   codex    $CODEX_HOME/config.toml의 [plugins."<이름>@…"] — CODEX_HOME
+//            재지정을 실제로 쓰는 환경(Orca)이 있어 환경변수를 따라간다.
+//   copilot  ~/.copilot/config.json의 installedPlugins[] (주석 있는 JSONC).
+//   gemini   ~/.gemini/extensions/<이름>/ (공식 extensions 문서).
+//   opencode 전역 opencode.json의 plugin 배열 (XDG_CONFIG_HOME 존중).
+import { existsSync, readFileSync } from 'node:fs'
+import { homedir } from 'node:os'
+import { delimiter, join } from 'node:path'
+import { parse as parseToml } from 'smol-toml'
+import { CLIS } from './clis.mjs'
+import { readJson, setKey, removeKey } from './jsonfile.mjs'
+import { msg, LocalizedError } from './i18n/index.mjs'
+
+// 실행은 cmd 셸을 거치므로(catalog.mjs makeExec) win32에서는 PATHEXT 확장자가
+// 있어야 실제로 부를 수 있다 — copilot.ps1만 있는 PATH는 "없음"이 맞다.
+function defaultHasBinary(name, env = process.env) {
+  const dirs = (env.PATH ?? '').split(delimiter).filter(Boolean)
+  const exts = process.platform === 'win32'
+    ? (env.PATHEXT ?? '.COM;.EXE;.BAT;.CMD').split(';').filter(Boolean)
+    : ['']
+  return dirs.some((dir) => exts.some((ext) => existsSync(join(dir, name + ext))))
+}
+
+// superpowers@openai-curated처럼 다른 마켓플레이스로 설치된 판도 잡아야
+// 하므로(실측: 이런 머신이 실제로 있다) 이름이 아니라 접두사로 고른다.
+// 제거도 여기서 찾은 id를 그대로 쓴다 — 감지가 "있다"고 말한 판을 지워야
+// 상태가 맞아떨어진다.
+function codexPluginIds(file, pluginName) {
+  if (!existsSync(file)) return []
+  try {
+    const data = parseToml(readFileSync(file, 'utf8'))
+    return Object.keys(data.plugins ?? {}).filter((id) => id.startsWith(`${pluginName}@`))
+  } catch {
+    // 깨진 config.toml은 미설치로 둔다 — 설치를 시도하면 codex가 스스로
+    // 진단하고, "설치됨"으로 오판해 제거를 그리로 보내는 것보다 낫다.
+    return []
+  }
+}
+
+function copilotInstalled(file, pluginName) {
+  const list = readJson(file)?.installedPlugins
+  return Array.isArray(list) && list.some((p) => p?.name === pluginName)
+}
+
+// ponytail(items/plugin.ponytail.mjs)과 같은 규칙: plugin 키가 배열이 아니면
+// 손대지 않는다.
+function opencodePlugins(file) {
+  const value = readJson(file)?.plugin
+  if (value === undefined) return []
+  if (!Array.isArray(value)) return null
+  return value
+}
+
+// config:
+//   pluginName      감지·제거가 쓰는 상류 이름 (codex 접두사, copilot name,
+//                   gemini 확장 디렉터리 이름)
+//   marketplaceRepo codex·copilot 마켓플레이스 (owner/repo)
+//   installId       마켓플레이스 설치 id (<이름>@<마켓>)
+//   gemini          gemini extensions install에 줄 git URL, 없으면 null
+//   opencode        전역 opencode.json plugin 배열에 넣을 항목, 없으면 null
+// supports는 어댑터 유무로 정해진다 — codex·copilot은 항상, gemini·opencode는
+// 좌표가 있을 때만.
+export function defineGlobalPlugin(
+  { id, label, group, note, exclusive = null, unsupported = {}, pluginName, marketplaceRepo, installId, gemini = null, opencode = null },
+  { home = null, env = process.env, hasBinary = defaultHasBinary } = {},
+) {
+  const supports = ['codex', ...(gemini ? ['gemini'] : []), ...(opencode ? ['opencode'] : []), 'copilot']
+
+  const files = () => {
+    const base = home ?? homedir()
+    return {
+      codex: join(env.CODEX_HOME || join(base, '.codex'), 'config.toml'),
+      copilot: join(base, '.copilot', 'config.json'),
+      gemini: join(base, '.gemini', 'extensions', pluginName),
+      opencode: join(env.XDG_CONFIG_HOME || join(base, '.config'), 'opencode', 'opencode.json'),
+    }
+  }
+
+  const isOurEntry = (p) => String(p).startsWith(`${pluginName}@`)
+  const wired = {
+    codex: (f) => codexPluginIds(f.codex, pluginName).length > 0,
+    copilot: (f) => copilotInstalled(f.copilot, pluginName),
+    gemini: (f) => existsSync(f.gemini),
+    opencode: (f) => (opencodePlugins(f.opencode) ?? []).some(isOurEntry),
+  }
+
+  return {
+    id, category: 'plugin', label, scope: 'user', group, exclusive,
+    supports: [...supports],
+    unsupported,
+    note,
+
+    // 상태는 "이 머신에 있는 하니스" 기준이다. CLI가 없는 하니스까지 누락으로
+    // 세면 gemini 없는 머신은 영원히 partial이라 apply가 매번 헛돈다.
+    async detect() {
+      const f = files()
+      const present = supports.filter((c) => wired[c](f))
+      const machine = supports.filter((c) => hasBinary(c))
+      const noCli = supports.filter((c) => !machine.includes(c))
+      const missing = machine.filter((c) => !present.includes(c))
+      const detail = noCli.length > 0 ? msg('item.global.noCli', { list: noCli.join(', ') }) : undefined
+      if (present.length === 0) return { status: 'absent', detail }
+      if (missing.length === 0) return { status: 'installed', detail }
+      return {
+        status: 'partial',
+        detail: msg('item.plugin.partial', { present: present.join(', '), missing: missing.join(', ') }),
+      }
+    },
+
+    async install({ dryRun, exec, log = () => {}, t }) {
+      const f = files()
+      // opencode 설정이 손댈 수 없는 꼴이면 아무것도 만지기 전에 멈춘다 —
+      // 절반만 설치된 채 실패하는 것보다 통째로 거절이 낫다.
+      const needsOpencode = opencode && !wired.opencode(f) && hasBinary('opencode')
+      if (needsOpencode && !dryRun && opencodePlugins(f.opencode) === null) {
+        throw new LocalizedError('error.globalOpencodePlugin', { file: f.opencode, entry: opencode })
+      }
+      const skipped = []
+      const failures = []
+      const fail = (cli, output) => failures.push(`${cli}: ${String(output).trim().split('\n')[0]}`)
+      for (const cli of supports) {
+        if (wired[cli](f)) continue
+        if (!hasBinary(cli)) {
+          skipped.push(cli)
+          continue
+        }
+        if (cli === 'codex') {
+          // 마켓 등록은 이미 있어도 해가 없다 — 성패는 add가 판정한다.
+          await exec('codex', ['plugin', 'marketplace', 'add', marketplaceRepo])
+          const r = await exec('codex', ['plugin', 'add', installId])
+          if (!r.ok) fail(cli, r.output)
+        } else if (cli === 'copilot') {
+          await exec('copilot', ['plugin', 'marketplace', 'add', marketplaceRepo])
+          // 실측(2026-08-15): 다른 copilot 세션이 떠 있으면 os error 5로 한 번
+          // 실패하고 재시도에 성공한다. 한 번만 다시 시도한다.
+          let r = await exec('copilot', ['plugin', 'install', installId])
+          if (!r.ok) r = await exec('copilot', ['plugin', 'install', installId])
+          if (!r.ok) fail(cli, r.output)
+        } else if (cli === 'gemini') {
+          const r = await exec('gemini', ['extensions', 'install', gemini])
+          if (!r.ok) fail(cli, r.output)
+        } else {
+          if (dryRun) {
+            log(t('log.plugin.add', { cli: CLIS.opencode.label, name: opencode }))
+            continue
+          }
+          const list = opencodePlugins(f.opencode) ?? []
+          if (list.length === 0) setKey(f.opencode, ['plugin'], [opencode])
+          else setKey(f.opencode, ['plugin', list.length], opencode)
+        }
+      }
+      if (failures.length > 0) throw new LocalizedError('error.globalExec', { detail: failures.join(' / ') })
+      if (skipped.length > 0) return { message: msg('item.global.skipped', { list: skipped.join(', ') }) }
+    },
+
+    async uninstall({ dryRun, exec, log = () => {}, t }) {
+      const f = files()
+      const skipped = []
+      const failures = []
+      const fail = (cli, output) => failures.push(`${cli}: ${String(output).trim().split('\n')[0]}`)
+      for (const cli of supports) {
+        if (!wired[cli](f)) continue
+        if (cli === 'opencode') {
+          if (dryRun) {
+            log(t('log.plugin.remove', { cli: CLIS.opencode.label, name: opencode }))
+            continue
+          }
+          const kept = (opencodePlugins(f.opencode) ?? []).filter((p) => !isOurEntry(p))
+          // 우리 항목만 빼고 비면 키째 지운다 — 빈 배열은 우리가 남긴 흔적이다.
+          if (kept.length === 0) removeKey(f.opencode, ['plugin'])
+          else setKey(f.opencode, ['plugin'], kept)
+          continue
+        }
+        if (!hasBinary(cli)) {
+          skipped.push(cli)
+          continue
+        }
+        if (cli === 'codex') {
+          for (const pid of codexPluginIds(f.codex, pluginName)) {
+            const r = await exec('codex', ['plugin', 'remove', pid])
+            if (!r.ok) fail(cli, r.output)
+          }
+          // 마켓플레이스 등록은 남긴다 — 우리가 등록했다는 보장이 없고,
+          // 같은 마켓의 다른 플러그인이 쓰고 있을 수 있다.
+        } else if (cli === 'copilot') {
+          let r = await exec('copilot', ['plugin', 'uninstall', pluginName])
+          if (!r.ok) r = await exec('copilot', ['plugin', 'uninstall', pluginName])
+          if (!r.ok) fail(cli, r.output)
+        } else {
+          const r = await exec('gemini', ['extensions', 'uninstall', pluginName])
+          if (!r.ok) fail(cli, r.output)
+        }
+      }
+      if (failures.length > 0) throw new LocalizedError('error.globalExec', { detail: failures.join(' / ') })
+      if (skipped.length > 0) return { message: msg('item.global.skipped', { list: skipped.join(', ') }) }
+    },
+  }
+}

package/lib/i18n/catalog/en.mjs

@@ -234,6 +234,11 @@ export default {
   'item.unsupported.mattpocockRegistry': 'upstream also documents npx skills add (the shared .agents/skills), but this item wires the Claude Code plugin only',
   'item.unsupported.upstreamNone': 'no official install path upstream',
   'item.unsupported.superpowersSeparate': 'upstream supports it via a separate per-harness install — this item wires the Claude Code plugin only',
+  'item.unsupported.superpowersGlobalClaude': 'covered by the project-scope item superpowers (plugin)',
+  'item.unsupported.superpowersGlobalGrok': 'upstream 6.3.0 ships grok plugin install superpowers@xai-official, but the detect/remove paths are unverified — not wired yet',
+  'item.unsupported.superpowersGlobalKimi': 'upstream installs only via the interactive /plugins command — no headless path',
+  'item.unsupported.globalProjectItem': 'covered by the project-scope item {item}',
+  'item.unsupported.ponytailGlobalGrok': 'upstream ships grok plugin install DietrichGebert/ponytail --trust, but the detect/remove paths are unverified — not wired yet',
   'item.unsupported.bkitPort': 'upstream ships separate ports (bkit-codex / bkit-gemini) installed apart from this plugin; the Gemini port is still a Gemini CLI extension and has had no update since the 2026-06-18 sunset',
   'item.unsupported.impeccableJunction': 'upstream supports it, but npx impeccable install breaks the shared .agents/skills link, so only the plugin route is wired',
   'item.unsupported.gstackHost': 'upstream supports it via ./setup --host — this item installs for Claude Code only',
@@ -241,6 +246,9 @@ export default {
   'item.unsupported.gsdGemini': 'upstream dropped Gemini CLI (sunset 2026-06) — Antigravity succeeds it via --antigravity',
   'item.mcp.partial': 'registered: {present} / missing: {missing}',
   'item.plugin.partial': 'wired: {present} / missing: {missing}',
+  'item.global.noCli': 'CLI not on this machine: {list} — excluded from the target set',
+  'run.keepUserScope': '· {id} is a user-global item and is not removed by omission from --set — uncheck it in the TUI to remove it',
+  'item.global.skipped': 'skipped (no CLI): {list}',
   'item.plugin.deferred': 'recorded in config — it downloads on the next Claude Code run',
   'item.scanFailed': 'detection failed: {message}',
   'log.mcp.add': '  [dry-run] register {name} in the {cli} config',
@@ -254,7 +262,9 @@ export default {
   'item.mcp.codebase-memory.note': 'needs the codebase-memory-mcp binary on PATH. Install: https://github.com/DeusData/codebase-memory-mcp (install.sh / install.ps1)',
   'item.mcp.graphify.note': 'needs the graphify-mcp binary on PATH. Install: uv tool install "graphifyy[mcp]". Reads graphify-out/graph.json — build it first with /graphify .',
   'item.mcp.headroom.note': 'needs the headroom binary on PATH. Install: uv tool install --python 3.13 "headroom-ai[proxy,mcp]". The proxy (headroom wrap) is a way of launching, not repo config',
-  'item.plugin.superpowers.note': 'official marketplace plugin. Upstream supports 11 harnesses (Codex, Antigravity, …) via per-harness installs',
+  'item.plugin.superpowers.note': 'official marketplace plugin. Upstream supports 14 harnesses (Codex, Grok Build, …) via per-harness installs',
+  'item.global.superpowers.note': 'installs superpowers user-globally with each harness\'s official command — marketplace for codex/copilot, extensions for gemini, the global opencode.json for OpenCode. CLIs missing from this machine are skipped. With skill.superpowers also on, overlapping CLIs see the same skills twice',
+  'item.global.ponytail.note': 'installs Ponytail user-globally with each harness\'s official command — the DietrichGebert/ponytail marketplace for codex/copilot, extensions for gemini. After the codex install, check hook registration once via /hooks. Upstream recommends scripts/uninstall.js to clean ~/.config/ponytail before removal — this item removes the plugin only',
   'item.plugin.mattpocock-skills.note': '35 engineering and productivity skills (code-review, diagnosing-bugs, domain-modeling, …)',
   'item.plugin.ponytail.note': 'lean-code ruleset. Wires the Claude Code plugin and the OpenCode plugin entry, both repo-scoped',
   'item.plugin.ecc.note': 'skills, instincts, memory and security for agent harnesses. Installed as a plugin — its skills/ holds 284 entries, too many to copy into the shared skills directory',
@@ -264,6 +274,8 @@ export default {
   'item.skill.taste.note': 'anti-slop frontend skill for landing pages, portfolios and redesigns (skill name: design-taste-frontend)',
   'item.skill.hallmark.note': 'anti-AI-slop design skill with four verbs (build, audit, redesign, study). 21 themes and 57 slop-test gates. Upstream also documents Cursor and Codex paths; the shared skills directory covers all 10 CLIs at once',
   'item.skill.diagram-design.note': 'draws 27 diagram types in HTML/SVG using your brand colors and fonts; also redraws Mermaid and draw.io sources. The default fonts (Instrument Serif, Geist) carry no CJK glyphs — swap them in style-guide.md — and PNG export needs Playwright and Chromium separately. The three upstream slash commands are left out, but the references/ they delegate to come along',
+  'item.skill.superpowers.note': 'copies 14 skills into the shared .agents/skills so all 10 CLIs see them. Only one of this and the plugin edition can be chosen — this route has no session-start hook, so nothing is injected at the start of a conversation and skills are invoked on demand',
+  'item.skill.mattpocock-skills.note': 'copies 35 skills into the shared .agents/skills so all 10 CLIs see them. Upstream documents this route itself, and with no hooks involved nothing is lost against the plugin edition. Only one of the two can be chosen',
   'item.skill.karpathy.note': 'behavioral guidelines that curb overbuilding and vague success criteria',
   'item.skill.gstack.note': 'repo-local clone + setup (needs bash; Git Bash on Windows). Runtime state (~/.gstack) may be created globally.',
   'item.skill.gsd.note': 'npx @opengsd/gsd-core, installed per project. Upstream supports 18 runtimes (Codex, Antigravity, …); this item wires --claude only',
@@ -276,13 +288,16 @@ export default {
   'log.gitmessage.remove': '  [dry-run] remove {path}',
   'error.gitmessageForeign': '{path} already exists and was not written by this tool. A hand-written template is never overwritten — move or delete it first.',
   'error.gitmessageConfig': 'git config commit.template failed: {output}',
-  'error.exclusiveItems': 'These items write the same file, so only one can be chosen: {ids}',
+  'error.exclusiveItems': 'These items compete for the same slot, so only one can be chosen: {ids}',
   'error.gstackClone': 'gstack clone failed: {output}',
   'error.gstackSetup': 'gstack setup failed: {output}',
   'error.gsdInstall': 'GSD install failed: {output}',
   'error.gsdUninstall': 'GSD uninstall failed: {output}',
   'error.ponytailOpencodePlugin': '{file}: the plugin key is not an array. Leaving it alone — add "@dietrichgebert/ponytail" by hand.',
+  'error.globalExec': 'a harness command failed — {detail}',
+  'error.globalOpencodePlugin': '{file}: the plugin key is not an array. Leaving it alone — add "{entry}" by hand.',
   'error.registrySkillInstall': 'skill registry install failed ({skill}): {output}',
+  'error.registrySkillAnchor': "{id}: when skill is '*', an anchor skill must be named for detect to look at",
   'error.itemFieldMissing': '{file}: {field} missing',
   'error.itemReasonMissing': '{id}: needs a reason for unsupported CLI \'{cli}\' (unsupported.{cli})',
   'error.shellQuote': 'The argument contains a double quote that cannot be passed to the shell: {value}',
@@ -319,7 +334,7 @@ export default {
   'tui.toggledAll': 'Selected every visible item in the {tab} tab.',
   'tui.toggledNone': 'Cleared every visible item in the {tab} tab.',
   // 배타 묶음에서 형제가 함께 꺼졌을 때. 조용히 뒤집히면 오조작으로 읽힌다.
-  'tui.exclusiveSwitched': 'Switched to {kept} — they share one file, so {dropped} was cleared.',
+  'tui.exclusiveSwitched': 'Switched to {kept} — they compete for the same slot, so {dropped} was cleared.',
   'tui.nonInteractive': 'The interactive screen only opens in a terminal. --list and --set work too.',
   'tui.pressAnyKey': 'Press any key to continue…',
   'tui.confirmSuffix': ' [y/N] ',

package/lib/i18n/catalog/ko.mjs

@@ -227,6 +227,11 @@ export default {
   'item.unsupported.mattpocockRegistry': '상류가 npx skills add(공유 .agents/skills)도 안내하지만 이 항목은 Claude Code 플러그인만 배선합니다',
   'item.unsupported.upstreamNone': '상류에 공식 설치 경로가 없습니다',
   'item.unsupported.superpowersSeparate': '상류가 하니스별 별도 설치로 지원합니다 — 이 항목은 Claude Code 플러그인만 배선합니다',
+  'item.unsupported.superpowersGlobalClaude': '프로젝트 스코프 항목 superpowers (plugin)이 담당합니다',
+  'item.unsupported.superpowersGlobalGrok': '상류 6.3.0에 grok plugin install superpowers@xai-official 명령이 있지만 감지·제거 경로를 실측하지 못해 아직 배선하지 않습니다',
+  'item.unsupported.superpowersGlobalKimi': '상류 설치가 대화형 /plugins 명령뿐이라 헤드리스 경로가 없습니다',
+  'item.unsupported.globalProjectItem': '프로젝트 스코프 항목 {item}이 담당합니다',
+  'item.unsupported.ponytailGlobalGrok': '상류 명령(grok plugin install DietrichGebert/ponytail --trust)이 있지만 감지·제거 경로 미실측이라 배선하지 않습니다',
   'item.unsupported.bkitPort': '상류가 별도 배포판(bkit-codex·bkit-gemini)으로 지원합니다 — 이 플러그인과 별개 설치입니다. Gemini판은 Gemini CLI 확장 그대로이고 2026-06-18 종료 이후 갱신이 없습니다',
   'item.unsupported.impeccableJunction': '상류는 지원하지만 npx impeccable install이 공유 .agents/skills 연결을 끊어 플러그인 경로만 배선합니다',
   'item.unsupported.gstackHost': '상류는 ./setup --host로 지원합니다 — 이 항목은 Claude Code에만 설치합니다',
@@ -234,6 +239,9 @@ export default {
   'item.unsupported.gsdGemini': '상류가 Gemini CLI 지원을 제거했습니다(2026-06 종료) — Antigravity가 --antigravity로 승계합니다',
   'item.mcp.partial': '등록됨: {present} / 누락: {missing}',
   'item.plugin.partial': '배선됨: {present} / 누락: {missing}',
+  'item.global.noCli': 'CLI 없음: {list} — 이 머신 대상에서 제외',
+  'run.keepUserScope': '· {id}는 사용자 전역 항목이라 --set 생략으로는 제거하지 않습니다 — 제거하려면 TUI에서 해제하세요',
+  'item.global.skipped': 'CLI가 없어 건너뜀: {list}',
   'item.plugin.deferred': '설정 기록됨 — 다음 Claude Code 실행 시 다운로드됩니다',
   'item.scanFailed': '감지 실패: {message}',
   'log.mcp.add': '  [dry-run] {cli} 설정에 {name} 등록',
@@ -247,7 +255,9 @@ export default {
   'item.mcp.codebase-memory.note': 'PATH에 codebase-memory-mcp 바이너리 필요. 설치: https://github.com/DeusData/codebase-memory-mcp (install.sh / install.ps1)',
   'item.mcp.graphify.note': 'PATH에 graphify-mcp 바이너리 필요. 설치: uv tool install "graphifyy[mcp]". graphify-out/graph.json을 읽으므로 /graphify .로 그래프를 먼저 만드세요',
   'item.mcp.headroom.note': 'PATH에 headroom 바이너리 필요. 설치: uv tool install --python 3.13 "headroom-ai[proxy,mcp]". 프록시(headroom wrap)는 실행 방식이라 저장소 설정 대상이 아닙니다',
-  'item.plugin.superpowers.note': '공식 마켓플레이스 플러그인. 상류는 Codex·Antigravity 등 11개 하니스를 하니스별 설치로 지원합니다',
+  'item.plugin.superpowers.note': '공식 마켓플레이스 플러그인. 상류는 Codex·Grok Build 등 14개 하니스를 하니스별 설치로 지원합니다',
+  'item.global.superpowers.note': 'superpowers를 하니스별 공식 명령으로 사용자 전역에 설치합니다 — codex·copilot은 마켓플레이스, gemini는 extensions, opencode는 전역 opencode.json. 이 머신에 없는 CLI는 건너뜁니다. skill.superpowers와 함께 켜면 겹치는 CLI는 같은 스킬을 두 곳에서 봅니다',
+  'item.global.ponytail.note': 'Ponytail을 하니스별 공식 명령으로 사용자 전역에 설치합니다 — codex·copilot은 마켓플레이스(DietrichGebert/ponytail), gemini는 extensions. codex는 설치 후 /hooks에서 훅 등록을 한 번 확인해야 합니다. 상류는 제거 전 scripts/uninstall.js로 ~/.config/ponytail 정리를 안내합니다 — 이 항목은 플러그인만 제거합니다',
   'item.plugin.mattpocock-skills.note': '엔지니어링·생산성 스킬 35종 (code-review, diagnosing-bugs, domain-modeling 등)',
   'item.plugin.ponytail.note': '군더더기 없는 코드 규칙 묶음. Claude Code 플러그인과 OpenCode plugin 항목을 저장소 범위로 배선합니다',
   'item.plugin.ecc.note': '에이전트 하네스용 스킬·본능·메모리·보안 묶음. skills/에 284개가 들어 있어 공유 스킬 디렉터리에 복사하지 않고 플러그인으로 설치합니다',
@@ -257,6 +267,8 @@ export default {
   'item.skill.taste.note': '랜딩 페이지·포트폴리오·리디자인용 안티슬롭 프런트엔드 스킬 (스킬 이름: design-taste-frontend)',
   'item.skill.hallmark.note': '네 가지 동사(신규 제작·audit·redesign·study)를 갖춘 안티 AI슬롭 디자인 스킬. 테마 21종과 슬롭 테스트 57종. 상류는 Cursor·Codex 경로도 안내하지만 공유 스킬 디렉터리 하나로 10개 CLI가 함께 봅니다',
   'item.skill.diagram-design.note': '브랜드 색·폰트로 다이어그램 27종을 그리는 HTML/SVG 스킬. Mermaid·draw.io 원본도 다시 그립니다. 기본 폰트(Instrument Serif·Geist)에 한글 글리프가 없어 style-guide.md에서 바꿔야 하고, PNG 내보내기는 Playwright·Chromium이 따로 필요합니다. 상류 플러그인의 명령 3개는 빠지지만 그 본문인 references/는 그대로 옵니다',
+  'item.skill.superpowers.note': '공유 .agents/skills에 스킬 14종을 복사해 10개 CLI가 함께 봅니다. 플러그인 판과 하나만 고를 수 있습니다 — 이쪽은 session-start 훅이 없어 대화 시작 시 자동 주입이 되지 않고, 스킬을 불러서 씁니다',
+  'item.skill.mattpocock-skills.note': '공유 .agents/skills에 스킬 35종을 복사해 10개 CLI가 함께 봅니다. 상류가 직접 안내하는 경로이며 훅이 없어 플러그인 판에 견줘 잃는 것이 없습니다. 둘 중 하나만 고를 수 있습니다',
   'item.skill.karpathy.note': '과설계와 모호한 완료 기준을 줄이는 행동 지침',
   'item.skill.gstack.note': '저장소 로컬 clone + setup (bash 필요, Windows는 Git Bash). 런타임 상태(~/.gstack)는 전역에 생길 수 있음.',
   'item.skill.gsd.note': 'npx @opengsd/gsd-core 프로젝트 로컬 설치. 상류는 Codex·Antigravity 등 18개 런타임을 지원합니다(이 항목은 --claude)',
@@ -268,13 +280,16 @@ export default {
   'log.gitmessage.remove': '  [dry-run] {path} 제거',
   'error.gitmessageForeign': '{path}가 이미 있고 이 도구가 쓴 내용이 아닙니다. 손으로 쓴 템플릿은 덮어쓰지 않습니다 — 먼저 옮기거나 지우세요.',
   'error.gitmessageConfig': 'git config commit.template 실패: {output}',
-  'error.exclusiveItems': '같은 파일을 쓰는 항목이라 하나만 고를 수 있습니다: {ids}',
+  'error.exclusiveItems': '한 자리를 두고 다투는 항목이라 하나만 고를 수 있습니다: {ids}',
   'error.gstackClone': 'gstack clone 실패: {output}',
   'error.gstackSetup': 'gstack setup 실패: {output}',
   'error.gsdInstall': 'GSD 설치 실패: {output}',
   'error.gsdUninstall': 'GSD 제거 실패: {output}',
   'error.ponytailOpencodePlugin': '{file}: plugin 키가 배열이 아닙니다. 덮어쓰지 않고 그대로 둡니다 — "@dietrichgebert/ponytail"을 직접 추가하세요.',
+  'error.globalExec': '하니스 명령이 실패했습니다 — {detail}',
+  'error.globalOpencodePlugin': '{file}: plugin 키가 배열이 아닙니다. 덮어쓰지 않고 그대로 둡니다 — "{entry}"을 직접 추가하세요.',
   'error.registrySkillInstall': '스킬 레지스트리 설치 실패 ({skill}): {output}',
+  'error.registrySkillAnchor': "{id}: skill이 '*'이면 detect가 볼 대표 스킬을 anchor로 지정해야 합니다",
   'error.itemFieldMissing': '{file}: {field} 누락',
   'error.itemReasonMissing': '{id}: 미지원 CLI \'{cli}\'의 사유(unsupported.{cli})가 필요합니다',
   'error.shellQuote': '셸에 넘길 수 없는 큰따옴표가 인자에 있습니다: {value}',
@@ -309,7 +324,7 @@ export default {
   'tui.toggledAll': '{tab} 탭의 보이는 항목을 모두 선택했습니다.',
   'tui.toggledNone': '{tab} 탭의 보이는 항목을 모두 해제했습니다.',
   // 배타 묶음에서 형제가 함께 꺼졌을 때. en.mjs 쪽 주석 참고.
-  'tui.exclusiveSwitched': '{kept}(으)로 바꿨습니다 — 같은 파일이라 {dropped}은(는) 해제했습니다.',
+  'tui.exclusiveSwitched': '{kept}(으)로 바꿨습니다 — 한 자리를 두고 다투므로 {dropped}은(는) 해제했습니다.',
   'tui.nonInteractive': '대화형 화면은 터미널에서만 열립니다. --list · --set 으로도 다룰 수 있습니다.',
   'tui.pressAnyKey': '계속하려면 아무 키나 누르세요…',
   'tui.confirmSuffix': ' [y/N] ',

package/lib/items/global.ponytail.mjs

@@ -0,0 +1,52 @@
+import { defineGlobalPlugin } from '../global-plugin.mjs'
+import { CLI_IDS } from '../clis.mjs'
+import { msg } from '../i18n/index.mjs'
+
+// Ponytail의 하니스별 전역 설치 판. 공통 기구는 global-plugin.mjs에 있다.
+//
+// 하니스별 근거(2026-08-15 상류 README 재검증):
+//   codex   — `codex plugin marketplace add DietrichGebert/ponytail` +
+//             `codex plugin add ponytail@ponytail`. 상류는 설치 후 codex에서
+//             /hooks로 라이프사이클 훅 등록을 확인하고 새 스레드를 시작하라는
+//             대화형 후속 단계를 안내한다 — 명령으로 대신할 수 없어 note에
+//             적는다. 제거는 `codex plugin remove <id>`.
+//   copilot — `copilot plugin marketplace add` + `copilot plugin install
+//             ponytail@ponytail`. 상류 README에 제거 명령은 없지만
+//             `copilot plugin uninstall <이름>`은 copilot CLI 자체의 범용
+//             명령이다(--help 실측).
+//   gemini  — `gemini extensions install https://github.com/DietrichGebert/ponytail`.
+//
+// opencode는 프로젝트 항목(plugin.ponytail)이 opencode.jsonc의 plugin 배열로
+// 이미 배선한다 — 전역 판에서 겹치면 같은 플러그인이 두 번 등록된다. claude도
+// 같은 이유로 프로젝트 항목의 자리다. grok은 상류 명령이 있으나 감지·제거
+// 경로를 실측할 CLI가 없어 superpowers 전역 판과 같은 기준으로 제외한다.
+// kiro·vscode는 상류가 룰 파일 수동 배치만 안내하고, kilo·kimi는 경로가 없다.
+//
+// 상류는 플러그인 제거 전에 node scripts/uninstall.js로 ~/.config/ponytail
+// 설정과 statusLine 항목을 정리하라고 안내한다 — 하니스마다 스크립트 위치가
+// 달라 자동화하지 않고 note로 알린다. 이 항목은 플러그인만 제거한다.
+const SUPPORTS = ['codex', 'gemini', 'copilot']
+
+const CONFIG = {
+  id: 'global.ponytail', label: 'Ponytail (global)', group: '__token',
+  note: 'item.global.ponytail.note',
+  pluginName: 'ponytail',
+  marketplaceRepo: 'DietrichGebert/ponytail',
+  installId: 'ponytail@ponytail',
+  gemini: 'https://github.com/DietrichGebert/ponytail',
+  unsupported: Object.fromEntries(
+    CLI_IDS.filter((c) => !SUPPORTS.includes(c)).map((c) => [
+      c,
+      ['claude', 'opencode'].includes(c) ? msg('item.unsupported.globalProjectItem', { item: 'Ponytail' })
+      : c === 'grok' ? msg('item.unsupported.ponytailGlobalGrok')
+      : ['kiro', 'vscode'].includes(c) ? msg('item.unsupported.ponytailRules')
+      : msg('item.unsupported.upstreamNone'),
+    ]),
+  ),
+}
+
+export function createItem(deps = {}) {
+  return defineGlobalPlugin(CONFIG, deps)
+}
+
+export default createItem()

package/lib/items/global.superpowers.mjs

@@ -0,0 +1,52 @@
+import { defineGlobalPlugin } from '../global-plugin.mjs'
+import { CLI_IDS } from '../clis.mjs'
+import { msg } from '../i18n/index.mjs'
+
+// superpowers를 프로젝트 스코프로 배선할 길이 없는 하니스에 상류의 하니스별
+// 전역 설치("install separately for each one")를 대신 해 주는 항목. 공통
+// 기구는 global-plugin.mjs에 있고, 여기는 상류 좌표와 사유만 든다.
+//
+// 하니스별 근거(2026-08-15, v6.3.0):
+//   codex   — 이 머신에서 marketplace add + plugin add를 실측. 기록은
+//             $CODEX_HOME/config.toml의 [plugins."superpowers@…"].
+//   copilot — 이 머신에서 설치·목록·제거를 실측(~/.copilot/config.json).
+//   gemini  — 공식 extensions 기구. 로컬 CLI가 없어 문서 근거다.
+//   opencode— 상류 .opencode/INSTALL.md가 전역 opencode.json의 plugin 배열에
+//             아래 항목 한 줄을 더하라고 안내한다.
+//
+// grok은 상류 명령(grok plugin install superpowers@xai-official --trust)이
+// 있지만 감지·제거 경로를 실측할 CLI가 없어 아직 배선하지 않고, kimi는 설치가
+// 대화형 /plugins뿐이라 헤드리스 경로가 없다. claude는 프로젝트 스코프 항목
+// (plugin.superpowers)의 자리다.
+//
+// skill.superpowers(공유 .agents/skills)와 배타로 묶지 않는다 — 저쪽은 이
+// 저장소에만, 이쪽은 머신 전체에 작용해 평면이 다르고, "claude는 프로젝트
+// 플러그인 + 나머지는 전역" 같은 조합이 정당하다. 겹치는 하니스가 같은 스킬을
+// 두 곳에서 본다는 것은 note에 적어 둔다.
+const SUPPORTS = ['codex', 'gemini', 'opencode', 'copilot']
+
+const CONFIG = {
+  id: 'global.superpowers', label: 'superpowers (global)', group: '__flow',
+  note: 'item.global.superpowers.note',
+  pluginName: 'superpowers',
+  marketplaceRepo: 'obra/superpowers-marketplace',
+  installId: 'superpowers@superpowers-marketplace',
+  gemini: 'https://github.com/obra/superpowers',
+  opencode: 'superpowers@git+https://github.com/obra/superpowers.git',
+  unsupported: Object.fromEntries(
+    CLI_IDS.filter((c) => !SUPPORTS.includes(c)).map((c) => [
+      c,
+      c === 'claude' ? msg('item.unsupported.superpowersGlobalClaude')
+      : c === 'grok' ? msg('item.unsupported.superpowersGlobalGrok')
+      : c === 'kimi' ? msg('item.unsupported.superpowersGlobalKimi')
+      : msg('item.unsupported.upstreamNone'),
+    ]),
+  ),
+}
+
+// 테스트가 홈·환경·PATH 탐지를 갈아끼울 수 있게 공장으로 노출한다.
+export function createItem(deps = {}) {
+  return defineGlobalPlugin(CONFIG, deps)
+}
+
+export default createItem()

package/lib/items/plugin.impeccable.mjs

@@ -6,12 +6,15 @@ import { msg } from '../i18n/index.mjs'
 // 부트스트랩이 만든 `.agents/skills` Junction을 끊는다 — 공유 스킬이 전부
 // Claude Code 화면에서 사라진다. 버그가 아니라 설계다: 상류
 // `cli/bin/commands/skills.mjs`의 isInProjectProviderLink가 "프로젝트 안 다른
-// 프로바이더를 가리키는 링크"를 의도적으로 unlink한다(3.5.0 재확인, 2026-08-02).
+// 프로바이더의 skills를 가리키는 링크"를 의도적으로 unlink한다(3.6.0 재확인,
+// 2026-08-15 — 저장소 밖을 가리키는 링크는 보존하지만, 부트스트랩 Junction은
+// 프로젝트 안 `.agents/skills`를 가리켜 여전히 파괴 대상이다).
 // 플러그인 경로는 `.claude/skills`를 건드리지 않는다.
 // 또 그 명령은 `--providers`와 `--scope`를 함께 주지 않으면 대화형으로 물으며,
 // 비TTY에서는 조용히 global을 골라 홈에 설치한다.
-// 상류 공식 프로바이더 14개 중 이 저장소의 CLI와 겹치는 것(아래 UPSTREAM).
-// Antigravity는 README에만 있고 설치 CLI는 거부한다(수동 복사 전용).
+// 상류 공식 프로바이더는 3.6.0 기준 16개(.agent=antigravity·.hermes가 새로
+// 들어옴 — README는 아직 수동 복사만 안내해 코드가 앞선다). 이 저장소의 CLI와
+// 겹치는 것은 아래 UPSTREAM 그대로다.
 const UPSTREAM = ['codex', 'gemini', 'opencode', 'kiro', 'grok', 'copilot']
 export default definePlugin({
   id: 'plugin.impeccable', label: 'impeccable', group: '__style',

package/lib/items/plugin.mattpocock-skills.mjs

@@ -7,7 +7,8 @@ import { msg } from '../i18n/index.mjs'
 // 아니라 "우리가 플러그인 쪽을 골랐다"이고, 사유가 그렇게 말해야 레지스트리
 // 항목으로 옮길 수 있다는 것도 화면에서 읽힌다.
 export default definePlugin({
-  id: 'plugin.mattpocock-skills', label: 'Matt Pocock skills', group: '__flow',
+  id: 'plugin.mattpocock-skills', label: 'Matt Pocock (plugin)', group: '__flow',
+  exclusive: 'mattpocock',
   installId: 'mattpocock-skills@mattpocock',
   detectIds: ['mattpocock-skills@mattpocock'],
   marketplace: { name: 'mattpocock', repo: 'mattpocock/skills' },

package/lib/items/plugin.superpowers.mjs

@@ -13,7 +13,8 @@ import { msg } from '../i18n/index.mjs'
 const SEPARATE = ['codex', 'gemini', 'opencode', 'kimi', 'copilot', 'grok']
 
 export default definePlugin({
-  id: 'plugin.superpowers', label: 'superpowers', group: '__flow',
+  id: 'plugin.superpowers', label: 'superpowers (plugin)', group: '__flow',
+  exclusive: 'superpowers',
   installId: 'superpowers@claude-plugins-official',
   detectIds: ['superpowers@claude-plugins-official', 'superpowers@superpowers-marketplace'],
   note: 'item.plugin.superpowers.note',

package/lib/items/skill.mattpocock-skills.mjs

@@ -0,0 +1,16 @@
+import { defineRegistrySkill } from '../catalog.mjs'
+// 상류가 "Codex, and other agents" 절에서 이 경로를 직접 안내한다 —
+// `npx skills add mattpocock/skills`다. 그러니 이쪽이 곁길이 아니라 상류가
+// 의도한 두 경로 중 하나다. 훅이 없는 스킬 묶음이라 플러그인 판에 견줘 잃는
+// 것도 없다(35개 실측, skills/<분류>/<이름>/SKILL.md 배치).
+//
+// anchor는 setup-matt-pocock-skills다. 상류 README가 "이것만은 반드시 고르라"고
+// 적어 둔 스킬이라 설치 판정의 기준으로도 맞는다.
+export default defineRegistrySkill({
+  id: 'skill.mattpocock-skills', label: 'Matt Pocock (skills)', group: '__flow',
+  source: 'https://github.com/mattpocock/skills',
+  skill: '*',
+  anchor: 'setup-matt-pocock-skills',
+  exclusive: 'mattpocock',
+  note: 'item.skill.mattpocock-skills.note',
+})

package/lib/items/skill.superpowers.mjs

@@ -0,0 +1,19 @@
+import { defineRegistrySkill } from '../catalog.mjs'
+// 같은 상류를 플러그인(plugin.superpowers)으로도 넣을 수 있다. 그쪽은 Claude
+// 하나만 닿는 대신 session-start 훅으로 알아서 켜지고, 이쪽은 공유
+// .agents/skills라 10개 CLI가 함께 보는 대신 훅이 빠진다 — 스킬은 부르면 되지만
+// "대화 시작 시 using-superpowers 주입"은 오지 않는다.
+// 둘을 함께 켜면 같은 스킬이 플러그인 캐시와 공유 디렉터리 양쪽에서 잡혀 중복
+// 등록되므로 배타로 묶는다.
+//
+// 상류 배치가 skills/<이름>/SKILL.md라 레지스트리가 그대로 읽는다(14개 실측).
+// anchor는 using-superpowers다 — 상류가 "대화 시작 시 반드시 읽으라"고 못 박은
+// 부트스트랩 스킬이라, 이것이 없으면 나머지가 있어도 설치로 볼 수 없다.
+export default defineRegistrySkill({
+  id: 'skill.superpowers', label: 'superpowers (skills)', group: '__flow',
+  source: 'https://github.com/obra/superpowers',
+  skill: '*',
+  anchor: 'using-superpowers',
+  exclusive: 'superpowers',
+  note: 'item.skill.superpowers.note',
+})

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rch4com/agent-setup",
-  "version": "1.11.1",
+  "version": "1.14.0",
   "description": "Repository-scoped bootstrap and optional-item installer for using multiple coding-agent CLIs in one repository | 여러 코딩 에이전트 CLI를 한 저장소에서 함께 쓰기 위한 저장소 범위 부트스트랩과 선택 항목 설치기",
   "keywords": [
     "agents-md",
@@ -20,10 +20,21 @@
   },
   "license": "MIT",
   "type": "module",
-  "engines": { "node": ">=20" },
-  "bin": { "agent-setup": "install.mjs" },
-  "files": ["install.mjs", "lib/", "README.md", "LICENSE"],
-  "publishConfig": { "access": "public" },
+  "engines": {
+    "node": ">=20"
+  },
+  "bin": {
+    "agent-setup": "install.mjs"
+  },
+  "files": [
+    "install.mjs",
+    "lib/",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
   "scripts": {
     "start": "node install.mjs",
     "test": "node --test",