@rch4com/agent-setup 1.28.0 → 2.2.0

package/lib/items/plugin.cli-anything.mjs

@@ -1,23 +1,26 @@
-import { definePlugin } from '../catalog.mjs'
-import { CLI_IDS } from '../clis.mjs'
-import { msg } from '../i18n/index.mjs'
+import { defineRecipe } from '../recipe.mjs'
+import { marketplacePlugin } from '../recipe-helpers.mjs'
+
 // HKUDS/CLI-Anything(Apache-2.0)의 마켓플레이스는 .claude-plugin/marketplace.json
 // 하나에 플러그인 cli-anything(./cli-anything-plugin)만 싣는다. 명령은
 // /cli-anything·list·refine·test·validate 다섯 개다(2026-10-06 확인).
-// 다른 CLI는 상류 README 기준: Codex는 설치기가 $CODEX_HOME/skills(사용자
-// 스코프), OpenCode는 설치기 없이 commands 파일 수동 복사, 나머지는 없다.
-// (Cursor·Pi·Hermes·Qoder 설치기는 이 저장소의 CLI 목록 밖이다.)
+// 다른 CLI는 상류 README 기준: Codex는 설치 스크립트가 $CODEX_HOME/skills에
+// 쓰고(CLI 명령이 아니다), OpenCode는 설치기 없이 commands 파일 수동 복사,
+// Antigravity는 경로가 없다.
 // 같은 리포의 skills/cli-hub-meta-skill은 별개 항목이다 — 이미 만들어진 CLI를
 // 허브에서 찾아 설치하게 하는 스킬이고, 이 항목은 CLI를 새로 만드는 쪽이다.
-const WHY = { codex: 'item.unsupported.cliAnythingCodex', opencode: 'item.unsupported.cliAnythingManual' }
-export default definePlugin({
-  id: 'plugin.cli-anything', label: 'CLI-Anything', group: '__service',
-  installId: 'cli-anything@cli-anything',
-  detectIds: ['cli-anything@cli-anything'],
-  marketplace: { name: 'cli-anything', repo: 'HKUDS/CLI-Anything' },
+export default defineRecipe({
+  id: 'plugin.cli-anything', category: 'plugin', label: 'CLI-Anything', group: '__service',
   note: 'item.plugin.cli-anything.note',
   verified: '2026-10-06',
-  unsupported: Object.fromEntries(
-    CLI_IDS.filter((c) => c !== 'claude').map((c) => [c, msg(WHY[c] ?? 'item.unsupported.upstreamNone')]),
-  ),
+  ...marketplacePlugin({
+    claude: { marketplace: 'HKUDS/CLI-Anything', id: 'cli-anything@cli-anything' },
+  }),
+  reasons: {
+    codex: 'item.unsupported.cliAnythingCodex',
+    opencode: 'item.unsupported.cliAnythingManual',
+    antigravity: 'item.unsupported.upstreamNone',
+    copilot: 'item.unsupported.cliAnythingCopilot',
+    vscode: 'item.unsupported.vscodePlugin',
+  },
 })

package/lib/items/plugin.ecc.mjs

@@ -1,27 +1,29 @@
-import { definePlugin } from '../catalog.mjs'
-import { CLI_IDS } from '../clis.mjs'
-import { msg } from '../i18n/index.mjs'
+import { defineRecipe } from '../recipe.mjs'
+import { marketplacePlugin } from '../recipe-helpers.mjs'
+
 // 레지스트리 경로(`npx skills add`)도 열려 있지만 쓰지 않는다 — ECC의 skills/에는
 // 284개가 들어 있어 `--skill` 없이 넣으면 공유 스킬 디렉터리를 통째로 덮는다
 // (2026-08-15 저장소 트리로 실측). 플러그인은 프로필을 상류가 관리하므로
 // 저장소에 남는 파일이 없다.
 //
-// 미배선 사유는 CLI마다 갈린다. Codex만 상류가 네이티브 플러그인을 주는데,
-// README가 못을 박는다 — "Codex stores one enabled plugin state in the active
-// CODEX_HOME; it does not offer Claude's user, project, and local scopes."
-// 나머지는 ./install.sh --target으로 열려 있고 Gemini(.gemini/)·Kimi(.kimi-code/)는
-// 프로젝트 로컬이기까지 하다. 그쪽을 막는 것은 스코프가 아니라 284개라는 규모다.
-export default definePlugin({
-  id: 'plugin.ecc', label: 'ECC', group: '__flow',
-  installId: 'ecc@ecc',
-  detectIds: ['ecc@ecc'],
-  marketplace: { name: 'ecc', repo: 'affaan-m/ECC' },
+// Codex는 상류가 네이티브 플러그인을 준다(README: `codex plugin marketplace add
+// affaan-m/ECC` + `codex plugin add ecc@ecc`, 두 명령 모두 멱등). 활성 CODEX_HOME
+// 하나에 깔리므로 전역 전용이고, 네이티브 훅은 명시적 신뢰가 필요하다(hooks).
+// OpenCode·Antigravity는 ./install.sh --target 경로뿐이라 284개 규모 문제가 같다.
+export default defineRecipe({
+  id: 'plugin.ecc', category: 'plugin', label: 'ECC', group: '__flow',
   note: 'item.plugin.ecc.note',
-  verified: '2026-08-15',
-  unsupported: Object.fromEntries(
-    CLI_IDS.filter((c) => c !== 'claude').map((c) => [
-      c,
-      c === 'codex' ? msg('item.unsupported.eccCodexHome') : msg('item.unsupported.eccScale'),
-    ]),
-  ),
+  verified: '2026-10-24',
+  hooks: true,
+  ...marketplacePlugin({
+    claude: { marketplace: 'affaan-m/ECC', id: 'ecc@ecc' },
+    codex: { marketplace: 'affaan-m/ECC', id: 'ecc@ecc' },
+  }),
+  // Copilot CLI도 ./install.sh --target copilot 경로뿐이라 규모 문제가 같다.
+  reasons: {
+    opencode: 'item.unsupported.eccScale',
+    antigravity: 'item.unsupported.eccScale',
+    copilot: 'item.unsupported.eccScale',
+    vscode: 'item.unsupported.vscodePlugin',
+  },
 })

package/lib/items/plugin.hyperframes.mjs

@@ -1,23 +1,27 @@
-import { definePlugin } from '../catalog.mjs'
-import { CLI_IDS } from '../clis.mjs'
-import { msg } from '../i18n/index.mjs'
+import { defineRecipe } from '../recipe.mjs'
+import { marketplacePlugin } from '../recipe-helpers.mjs'
+
 // heygen-com/hyperframes(Apache-2.0)의 마켓플레이스는 플러그인 둘을 싣는다:
 // hyperframes(전체 스킬 번들, 상류 권장)와 core-skills(구판 코어만 — 상류가
 // 전자로 옮기라고 안내한다). 여기서는 전자를 쓴다. 번들은 스킬 21종과 CLI
 // 버전을 한 스냅숏으로 묶고, /hyperframes 라우터가 제작 워크플로를 그때그때
 // 불러온다(2026-10-06 확인).
-// 다른 CLI는 모두 상류가 CLI별 별도 설치로 안내한다 — Copilot·Gemini·Codex·
-// VS Code·Cursor는 각자 플러그인/확장, 나머지는 `npx skills add`의 단독 스킬.
+// 다른 CLI는 모두 상류가 CLI별 별도 설치로 안내한다 — Codex는 플러그인,
+// 나머지는 `npx skills add`의 단독 스킬.
 // 같은 상류를 스킬로 넣지 않는 것은 코어만 고르려면 대화형 선택기가 필요해서다
 // (비대화형 실행은 21종 전부를 설치한다).
-export default definePlugin({
-  id: 'plugin.hyperframes', label: 'HyperFrames', group: '__service',
-  installId: 'hyperframes@hyperframes',
-  detectIds: ['hyperframes@hyperframes'],
-  marketplace: { name: 'hyperframes', repo: 'heygen-com/hyperframes' },
+export default defineRecipe({
+  id: 'plugin.hyperframes', category: 'plugin', label: 'HyperFrames', group: '__service',
   note: 'item.plugin.hyperframes.note',
   verified: '2026-10-06',
-  unsupported: Object.fromEntries(
-    CLI_IDS.filter((c) => c !== 'claude').map((c) => [c, msg('item.unsupported.superpowersSeparate')]),
-  ),
+  ...marketplacePlugin({
+    claude: { marketplace: 'heygen-com/hyperframes', id: 'hyperframes@hyperframes' },
+  }),
+  reasons: {
+    codex: 'item.unsupported.superpowersSeparate',
+    opencode: 'item.unsupported.superpowersSeparate',
+    antigravity: 'item.unsupported.superpowersSeparate',
+    copilot: 'item.unsupported.superpowersSeparate',
+    vscode: 'item.unsupported.vscodePlugin',
+  },
 })

package/lib/items/plugin.impeccable.mjs

@@ -1,28 +1,25 @@
-import { definePlugin } from '../catalog.mjs'
-import { CLI_IDS } from '../clis.mjs'
-import { msg } from '../i18n/index.mjs'
+import { defineRecipe } from '../recipe.mjs'
+import { marketplacePlugin } from '../recipe-helpers.mjs'
+
 // 같은 상류를 공유 스킬(skill.impeccable)로도 넣을 수 있다. 플러그인은 Claude
-// 하나에만 닿고 스킬 판은 11개 CLI가 함께 본다. 둘을 함께 켜면 같은 스킬이 두
+// 하나에만 닿고 스킬 판은 네 CLI가 함께 본다. 둘을 함께 켜면 같은 스킬이 두
 // 경로에서 잡혀 중복 등록되므로 배타로 묶는다.
-// 예전에는 `npx impeccable install`이 `.claude/skills` Junction을 실제
-// 디렉터리로 갈아치운다는 이유(3.6.0 측정)로 스킬 경로를 막았지만, 4.1.0을
-// 2026-10-06에 다시 재 보니 claude·kiro(Junction)와 codex·antigravity·gemini
-// ·opencode·grok·copilot(symlink)에서 링크가 그대로 남았다. 그 사유는 폐기한다.
-// 다만 그 명령은 provider마다 엔진 바이너리(약 19MB)를 따로 복사하고 비TTY에서
-// 범위를 묻지 않으므로, 이 저장소는 레지스트리 스킬 경로를 쓴다.
-const UPSTREAM = ['codex', 'gemini', 'opencode', 'kiro', 'grok', 'copilot', 'antigravity']
-export default definePlugin({
-  id: 'plugin.impeccable', label: 'impeccable', group: '__style',
-  installId: 'impeccable@impeccable',
-  detectIds: ['impeccable@impeccable'],
-  marketplace: { name: 'impeccable', repo: 'pbakaus/impeccable' },
+// `npx impeccable install`은 provider마다 엔진 바이너리(약 19MB)를 따로 복사하고
+// 비TTY에서 범위를 묻지 않으므로(4.1.0, 2026-10-06), 이 저장소는 레지스트리
+// 스킬 경로를 쓴다.
+export default defineRecipe({
+  id: 'plugin.impeccable', category: 'plugin', label: 'impeccable', group: '__style',
   exclusive: 'impeccable',
   note: 'item.plugin.impeccable.note',
   verified: '2026-10-06',
-  unsupported: Object.fromEntries(
-    CLI_IDS.filter((c) => c !== 'claude').map((c) => [
-      c,
-      UPSTREAM.includes(c) ? msg('item.unsupported.impeccableSkill') : msg('item.unsupported.upstreamNone'),
-    ]),
-  ),
+  ...marketplacePlugin({
+    claude: { marketplace: 'pbakaus/impeccable', id: 'impeccable@impeccable' },
+  }),
+  reasons: {
+    codex: 'item.unsupported.impeccableSkill',
+    opencode: 'item.unsupported.impeccableSkill',
+    antigravity: 'item.unsupported.impeccableSkill',
+    copilot: 'item.unsupported.impeccableSkill',
+    vscode: 'item.unsupported.impeccableSkill',
+  },
 })

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

@@ -1,20 +1,26 @@
-import { definePlugin } from '../catalog.mjs'
-import { CLI_IDS } from '../clis.mjs'
-import { msg } from '../i18n/index.mjs'
-// 상류가 "Codex, and other agents" 절에서 `npx skills add mattpocock/skills`를
-// 안내한다 — 이 저장소의 레지스트리 스킬 항목이 쓰는 바로 그 경로다(레지스트리로
-// 35개가 보이는 것을 실측, 2026-08-15). 그러니 미배선 사유는 "상류에 없다"가
-// 아니라 "우리가 플러그인 쪽을 골랐다"이고, 사유가 그렇게 말해야 레지스트리
-// 항목으로 옮길 수 있다는 것도 화면에서 읽힌다.
-export default definePlugin({
-  id: 'plugin.mattpocock-skills', label: 'Matt Pocock', group: '__flow',
+import { defineRecipe } from '../recipe.mjs'
+import { marketplacePlugin } from '../recipe-helpers.mjs'
+
+// 상류 README가 Claude 마켓플레이스와 함께 Codex 플러그인(`codex plugin
+// marketplace add mattpocock/skills` + `codex plugin add
+// mattpocock-skills@mattpocock`)을 안내한다(2026-10-24 확인). Copilot CLI도 README가 같은 두 명령을 안내한다
+// (2026-11-06 확인) — `~/.copilot/settings.json`의 extraKnownMarketplaces는 자동
+// 갱신 설정이라 건드리지 않는다. 그 밖의 에이전트는
+// `npx skills add mattpocock/skills` — 이 저장소의 레지스트리 스킬 항목
+// (skill.mattpocock-skills)이 쓰는 바로 그 경로라 배타로 묶는다.
+export default defineRecipe({
+  id: 'plugin.mattpocock-skills', category: 'plugin', label: 'Matt Pocock', group: '__flow',
   exclusive: 'mattpocock',
-  installId: 'mattpocock-skills@mattpocock',
-  detectIds: ['mattpocock-skills@mattpocock'],
-  marketplace: { name: 'mattpocock', repo: 'mattpocock/skills' },
   note: 'item.plugin.mattpocock-skills.note',
-  verified: '2026-08-15',
-  unsupported: Object.fromEntries(
-    CLI_IDS.filter((c) => c !== 'claude').map((c) => [c, msg('item.unsupported.mattpocockRegistry')]),
-  ),
+  verified: '2026-11-06',
+  ...marketplacePlugin({
+    claude: { marketplace: 'mattpocock/skills', id: 'mattpocock-skills@mattpocock' },
+    codex: { marketplace: 'mattpocock/skills', id: 'mattpocock-skills@mattpocock' },
+    copilot: { marketplace: 'mattpocock/skills', id: 'mattpocock-skills@mattpocock' },
+  }),
+  reasons: {
+    opencode: 'item.unsupported.mattpocockRegistry',
+    antigravity: 'item.unsupported.mattpocockRegistry',
+    vscode: 'item.unsupported.vscodePlugin',
+  },
 })

package/lib/items/plugin.ponytail.mjs

@@ -1,107 +1,25 @@
-import { CLI_IDS } from '../clis.mjs'
-import { isPluginEnabled, enablePlugin, disablePlugin } from '../claude-plugins.mjs'
-import { repoPath, repoPathStrict } from '../context.mjs'
-import { readJson, setKey, removeKey } from '../jsonfile.mjs'
-import { msg, LocalizedError } from '../i18n/index.mjs'
-
-// 상류 안내는 `--scope user`지만 이 저장소의 항목은 전부 프로젝트 스코프다.
-// 같은 규칙 묶음이 두 경로로 들어간다 — Claude Code는 플러그인 CLI(실패하면
-// .claude/settings.json 기록), OpenCode는 프로젝트 설정의 plugin 배열.
-// 두 경로 모두 저장소 안에만 쓴다.
-const INSTALL_ID = 'ponytail@ponytail'
-const MARKETPLACE = { name: 'ponytail', repo: 'DietrichGebert/ponytail' }
-const OPENCODE_FILE = 'opencode.jsonc'
-const OPENCODE_ENTRY = '@dietrichgebert/ponytail'
-const SUPPORTS = ['claude', 'opencode']
-
-// plugin 키가 배열이 아니면 손대지 않는다 — 통째로 덮어쓰면 사용자가 적어 둔
-// 설정이 조용히 사라진다. 없는 것(undefined)과 다른 타입을 구분해서 돌려준다.
-function opencodePlugins(root) {
-  const value = readJson(repoPath(root, OPENCODE_FILE))?.plugin
-  if (value === undefined) return []
-  if (!Array.isArray(value)) return null
-  return value
-}
-
-function opencodeListOrThrow(root) {
-  const list = opencodePlugins(root)
-  if (list === null) throw new LocalizedError('error.ponytailOpencodePlugin', { file: OPENCODE_FILE })
-  return list
-}
-
-function hasOpencode(root) {
-  return (opencodePlugins(root) ?? []).includes(OPENCODE_ENTRY)
-}
-
-export default {
-  id: 'plugin.ponytail', category: 'plugin', label: 'Ponytail', scope: 'project',
-  group: '__token',
-  supports: SUPPORTS,
-  unsupported: Object.fromEntries(
-    CLI_IDS.filter((c) => !SUPPORTS.includes(c)).map((c) => [
-      c,
-      // codex·copilot·grok·gemini는 상류에 설치 경로가 있지만 전부 사용자
-      // 스코프다. grok은 `grok plugin install DietrichGebert/ponytail --trust`로
-      // 플러그인 기구가 엄연히 있다 — "기구가 없다" 쪽에 두면 거짓이다
-      // (2026-08-15 재측정). 나머지는 상류의 규칙 파일을 손으로 옮겨야 한다.
-      ['codex', 'copilot', 'gemini', 'grok'].includes(c)
-        ? msg('item.unsupported.ponytailUser')
-        : msg('item.unsupported.ponytailRules'),
-    ]),
-  ),
+import { defineRecipe } from '../recipe.mjs'
+import { marketplacePlugin } from '../recipe-helpers.mjs'
+
+// DietrichGebert/ponytail. 하니스별 공식 경로(상류 README·INSTALL.md, 2026-10-24):
+// Claude·Codex는 마켓플레이스, OpenCode는 opencode plugin, Antigravity는
+// agy plugin install <git URL>, Copilot CLI는 마켓플레이스(이 머신에서 설치·감지
+// 확인, 2026-11-06). VS Code Copilot에는 플러그인 설치 명령이 없다. Codex는 설치 후 /hooks에서 라이프사이클 훅
+// 두 개를 신뢰해야 켜진다 — hooks: true가 활성화 안내에 그 단계를 싣는다.
+// 상류는 플러그인 제거 전에 scripts/uninstall.js로 ~/.config/ponytail 설정을
+// 정리하라고 안내한다 — 하니스마다 스크립트 위치가 달라 note로만 알린다.
+export default defineRecipe({
+  id: 'plugin.ponytail', category: 'plugin', label: 'Ponytail', group: '__token',
   note: 'item.plugin.ponytail.note',
-  verified: '2026-08-15',
-
-  async detect({ root }) {
-    const present = []
-    if (isPluginEnabled(root, [INSTALL_ID])) present.push('claude')
-    if (hasOpencode(root)) present.push('opencode')
-    if (present.length === 0) return { status: 'absent' }
-    if (present.length === SUPPORTS.length) return { status: 'installed' }
-    return {
-      status: 'partial',
-      detail: msg('item.plugin.partial', {
-        present: present.join(', '),
-        missing: SUPPORTS.filter((c) => !present.includes(c)).join(', '),
-      }),
-    }
-  },
-
-  async install({ root, dryRun, exec, log = () => {}, t }) {
-    let deferred = false
-    if (!isPluginEnabled(root, [INSTALL_ID])) {
-      await exec('claude', ['plugin', 'marketplace', 'add', MARKETPLACE.repo], { cwd: root })
-      const r = await exec('claude', ['plugin', 'install', INSTALL_ID, '--scope', 'project'], { cwd: root })
-      if (!r.ok) {
-        if (!dryRun) enablePlugin(root, INSTALL_ID, MARKETPLACE)
-        deferred = true
-      }
-    }
-    if (!hasOpencode(root)) {
-      const list = opencodeListOrThrow(root)
-      if (dryRun) log(t('log.plugin.add', { cli: 'OpenCode', name: OPENCODE_ENTRY }))
-      // 파일이 없거나 plugin 키가 없으면 배열째 만들고, 있으면 끝에 덧붙인다.
-      else if (list.length === 0) setKey(repoPathStrict(root, OPENCODE_FILE), ['plugin'], [OPENCODE_ENTRY])
-      else setKey(repoPathStrict(root, OPENCODE_FILE), ['plugin', list.length], OPENCODE_ENTRY)
-    }
-    if (deferred) return { fallback: true, message: msg('item.plugin.deferred') }
-  },
-
-  async uninstall({ root, dryRun, exec, log = () => {}, t }) {
-    if (isPluginEnabled(root, [INSTALL_ID])) {
-      const r = await exec('claude', ['plugin', 'uninstall', INSTALL_ID], { cwd: root })
-      if (!r.ok && !dryRun) disablePlugin(root, [INSTALL_ID])
-    }
-    if (!hasOpencode(root)) return
-    if (dryRun) {
-      log(t('log.plugin.remove', { cli: 'OpenCode', name: OPENCODE_ENTRY }))
-      return
-    }
-    const kept = opencodeListOrThrow(root).filter((p) => p !== OPENCODE_ENTRY)
-    const file = repoPathStrict(root, OPENCODE_FILE)
-    // 우리가 넣은 항목만 빼고 비면 키째 지운다 — 빈 배열을 남기면 우리가
-    // 만든 흔적이 설정에 계속 남는다.
-    if (kept.length === 0) removeKey(file, ['plugin'])
-    else setKey(file, ['plugin'], kept)
-  },
-}
+  verified: '2026-11-06',
+  hooks: true,
+  postInstall: 'item.plugin.ponytail.post',
+  ...marketplacePlugin({
+    claude: { marketplace: 'DietrichGebert/ponytail', id: 'ponytail@ponytail' },
+    codex: { marketplace: 'DietrichGebert/ponytail', id: 'ponytail@ponytail' },
+    opencode: { module: '@dietrichgebert/ponytail' },
+    antigravity: { source: 'https://github.com/DietrichGebert/ponytail', name: 'ponytail' },
+    copilot: { marketplace: 'DietrichGebert/ponytail', id: 'ponytail@ponytail' },
+  }),
+  reasons: { vscode: 'item.unsupported.vscodePlugin' },
+})

package/lib/items/plugin.superpowers.mjs

@@ -1,28 +1,24 @@
-import { definePlugin } from '../catalog.mjs'
-import { CLI_IDS } from '../clis.mjs'
-import { msg } from '../i18n/index.mjs'
+import { defineRecipe } from '../recipe.mjs'
+import { marketplacePlugin } from '../recipe-helpers.mjs'
 
-// 상류(obra/superpowers v6.3.0)는 Codex·Antigravity·Copilot CLI 등 14개
-// 하니스를 지원하지만 설치 명령이 하니스마다 전부 달라 공유 경로가 없다
-// (README: "install Superpowers separately for each one"). 이 항목이 배선하는
-// 것은 Claude Code 플러그인 판뿐이다. Kilo·Kiro·VS Code는 상류에 공식 설치
-// 경로가 없다(2026-08-15 재측정).
-// Grok은 6.2.0에는 없다가 6.3.0에서 들어왔다 — `### Grok Build CLI`의
-// `grok plugin install superpowers@xai-official --trust`다. Devin·Hermes도 같이
-// 늘었지만 둘 다 이 저장소가 다루는 CLI가 아니다.
-const SEPARATE = ['codex', 'gemini', 'opencode', 'kimi', 'copilot', 'grok', 'antigravity']
-
-export default definePlugin({
-  id: 'plugin.superpowers', label: 'superpowers', group: '__flow',
+// obra/superpowers. 상류는 하니스마다 설치 명령이 다르다(README: "install
+// Superpowers separately for each one"). Claude는 공식 마켓플레이스
+// (claude-plugins-official, 추가 등록 불필요), Codex는 obra/superpowers-marketplace
+// (2026-08-15 헤드리스 실측), OpenCode는 git 모듈(.opencode/INSTALL.md),
+// Antigravity는 agy plugin install <git URL>(README), Copilot CLI는 같은 마켓플레이스
+// (README "GitHub Copilot CLI" 절). VS Code Copilot은 공식 경로가 없다. 같은 상류를 공유 스킬
+// (skill.superpowers)로도 넣을 수 있어 배타로 묶는다.
+export default defineRecipe({
+  id: 'plugin.superpowers', category: 'plugin', label: 'superpowers', group: '__flow',
   exclusive: 'superpowers',
-  installId: 'superpowers@claude-plugins-official',
-  detectIds: ['superpowers@claude-plugins-official', 'superpowers@superpowers-marketplace'],
   note: 'item.plugin.superpowers.note',
-  verified: '2026-08-15',
-  unsupported: Object.fromEntries(
-    CLI_IDS.filter((c) => c !== 'claude').map((c) => [
-      c,
-      SEPARATE.includes(c) ? msg('item.unsupported.superpowersSeparate') : msg('item.unsupported.upstreamNone'),
-    ]),
-  ),
+  verified: '2026-11-06',
+  ...marketplacePlugin({
+    claude: { id: 'superpowers@claude-plugins-official', detectIds: ['superpowers@claude-plugins-official', 'superpowers@superpowers-marketplace'] },
+    codex: { marketplace: 'obra/superpowers-marketplace', id: 'superpowers@superpowers-marketplace' },
+    opencode: { module: 'superpowers@git+https://github.com/obra/superpowers.git' },
+    antigravity: { source: 'https://github.com/obra/superpowers', name: 'superpowers' },
+    copilot: { marketplace: 'obra/superpowers-marketplace', id: 'superpowers@superpowers-marketplace' },
+  }),
+  reasons: { vscode: 'item.unsupported.vscodePlugin' },
 })

package/lib/items/plugin.understand-anything.mjs

@@ -1,22 +1,24 @@
-import { definePlugin } from '../catalog.mjs'
-import { CLI_IDS } from '../clis.mjs'
-import { msg } from '../i18n/index.mjs'
+import { defineRecipe } from '../recipe.mjs'
+import { marketplacePlugin } from '../recipe-helpers.mjs'
+
 // 상류는 Claude 전용이 아니다 — README의 "Multi-Platform Installation"이
-// codex·opencode·gemini·vscode·kimi·kiro를 install.sh -s <platform>으로 안내한다.
-// 그 경로가 ~/.understand-anything/repo에 클론하고 홈에 심볼릭 링크를 거는
-// 사용자 스코프라 이 저장소의 항목이 될 수 없다.
-// Copilot CLI만 갈래가 다르다 —
-// `copilot plugin install Egonex-AI/Understand-Anything:understand-anything-plugin`
-// 이라는 플러그인 직접 설치인데, `copilot plugin install`에 스코프 플래그가
-// 없어 결국 사용자 스코프다(2026-08-15 재측정).
-export default definePlugin({
-  id: 'plugin.understand-anything', label: 'Understand Anything', group: '__context',
-  installId: 'understand-anything@understand-anything',
-  detectIds: ['understand-anything@understand-anything'],
-  marketplace: { name: 'understand-anything', repo: 'Egonex-AI/Understand-Anything' },
+// codex·opencode·antigravity 등을 install.sh <platform>으로 안내한다. 그 경로는
+// ~/.understand-anything/repo에 클론하고 홈에 심볼릭 링크를 거는 스크립트라
+// CLI 명령이 아니고, 이 설치기가 감지·제거할 근거도 없다(2026-08-15 재측정).
+export default defineRecipe({
+  id: 'plugin.understand-anything', category: 'plugin', label: 'Understand Anything', group: '__context',
   note: 'item.plugin.understand-anything.note',
-  verified: '2026-08-15',
-  unsupported: Object.fromEntries(
-    CLI_IDS.filter((c) => c !== 'claude').map((c) => [c, msg('item.unsupported.uaUser')]),
-  ),
+  verified: '2026-11-06',
+  ...marketplacePlugin({
+    claude: { marketplace: 'Egonex-AI/Understand-Anything', id: 'understand-anything@understand-anything' },
+    // README "Copilot CLI" 절의 명령(2026-11-06). 마켓 없이 하위 경로를 직접 설치하므로
+    // 목록에는 마켓 없는 이름으로 나올 것이다 — 직접 설치의 목록 모양은 실측하지 못했다.
+    copilot: { source: 'Egonex-AI/Understand-Anything:understand-anything-plugin', id: 'understand-anything' },
+  }),
+  reasons: {
+    codex: 'item.unsupported.uaUser',
+    opencode: 'item.unsupported.uaUser',
+    antigravity: 'item.unsupported.uaUser',
+    vscode: 'item.unsupported.vscodePlugin',
+  },
 })

package/lib/items/skill.agent-browser.mjs

@@ -1,17 +1,17 @@
-import { defineRegistrySkill } from '../catalog.mjs'
+import { defineRecipe } from '../recipe.mjs'
+import { skillsAdd } from '../recipe-helpers.mjs'
 // SKILL.md는 안내 스텁이다 — 실제 워크플로 지침은 설치된 CLI가 런타임에 준다
 // (`agent-browser skills get core`). 그래서 스킬 복사만으로는 반쪽이고, PATH의
 // agent-browser 바이너리(npm i -g agent-browser)와 최초 1회
 // `agent-browser install`(Chrome for Testing 다운로드)이 사실상 전제다 —
 // note가 알린다. 본문은 Bash로 agent-browser를 부르라는 하네스 중립 문서라
-// 공유 디렉터리의 10개 CLI가 함께 쓴다. frontmatter의 allowed-tools와
+// 공유 디렉터리의 네 CLI가 함께 쓴다. frontmatter의 allowed-tools와
 // hidden: true는 Claude Code 문법이라 다른 CLI는 무시한다.
 // (2026-08-15 확인: skills/agent-browser/SKILL.md 단일 스킬, npm agent-browser
 // 0.34.0 = vercel-labs 리포, 네이티브 바이너리는 Windows x64 포함.)
-export default defineRegistrySkill({
-  id: 'skill.agent-browser', label: 'agent-browser', group: '__service',
-  source: 'https://github.com/vercel-labs/agent-browser',
-  skill: 'agent-browser',
+export default defineRecipe({
+  id: 'skill.agent-browser', category: 'skill', label: 'agent-browser', group: '__service',
   note: 'item.skill.agent-browser.note',
   verified: '2026-08-15',
+  ...skillsAdd({ source: 'https://github.com/vercel-labs/agent-browser', skill: 'agent-browser' }),
 })

package/lib/items/skill.agent-handoff-manager.mjs

@@ -0,0 +1,14 @@
+import { defineRecipe } from '../recipe.mjs'
+import { skillsAdd } from '../recipe-helpers.mjs'
+// rch4com/agent-handoff-manager(MIT). 에이전트 사이 작업 인계를 저장·재개하는
+// 스킬 하나(skills/agent-handoff-manager). 본체는 스킬 폴더의 scripts/handoff.py
+// (표준 라이브러리만, Python 3.10+)라 PATH에 Python이 있어야 한다. 상류는
+// Claude·Copilot 플러그인 매니페스트도 두지만 담긴 것이 같은 스킬 하나라
+// 여섯 CLI가 함께 보는 공유 스킬 판을 택했다. 데이터는 대상 저장소의
+// .handoffs/에 쌓인다.
+export default defineRecipe({
+  id: 'skill.agent-handoff-manager', category: 'skill', label: 'Agent Handoff Manager', group: '__context',
+  note: 'item.skill.agent-handoff-manager.note',
+  verified: '2026-11-12',
+  ...skillsAdd({ source: 'https://github.com/rch4com/agent-handoff-manager', skill: 'agent-handoff-manager' }),
+})

package/lib/items/skill.archify.mjs

@@ -1,4 +1,5 @@
-import { defineRegistrySkill } from '../catalog.mjs'
+import { defineRecipe } from '../recipe.mjs'
+import { skillsAdd } from '../recipe-helpers.mjs'
 // 상류 스킬은 archify/SKILL.md(MIT)이고, 저장소에는 기여자용
 // .agents/skills/archify-review도 있다. 레지스트리 경로가 늘 --skill archify를
 // 넘기므로 루트를 source로 줘도 archify 하나만 들어온다 — 상류 README가
@@ -10,10 +11,9 @@ import { defineRegistrySkill } from '../catalog.mjs'
 // 복사본에서 validate가 그대로 통과한다(2026-09-27 스크래치 저장소 실측).
 // 본문이 첫 산출물 뒤 scripts/check-update.mjs로 상류 매니페스트를 한 번
 // GET한다 — ARCHIFY_UPDATE_CHECK_DISABLED=1로 끈다. note가 알린다.
-export default defineRegistrySkill({
-  id: 'skill.archify', label: 'Archify', group: '__style',
-  source: 'https://github.com/tt-a1i/archify',
-  skill: 'archify',
+export default defineRecipe({
+  id: 'skill.archify', category: 'skill', label: 'Archify', group: '__style',
   note: 'item.skill.archify.note',
   verified: '2026-09-27',
+  ...skillsAdd({ source: 'https://github.com/tt-a1i/archify', skill: 'archify' }),
 })

package/lib/items/skill.caveman.mjs

@@ -1,7 +1,7 @@
-import { defineRegistrySkill } from '../catalog.mjs'
-export default defineRegistrySkill({
-  id: 'skill.caveman', label: 'caveman', group: '__token',
-  source: 'https://github.com/JuliusBrussee/caveman',
-  skill: 'caveman',
+import { defineRecipe } from '../recipe.mjs'
+import { skillsAdd } from '../recipe-helpers.mjs'
+export default defineRecipe({
+  id: 'skill.caveman', category: 'skill', label: 'caveman', group: '__token',
   note: 'item.skill.caveman.note',
+  ...skillsAdd({ source: 'https://github.com/JuliusBrussee/caveman', skill: 'caveman' }),
 })

package/lib/items/skill.diagram-design.mjs

@@ -1,4 +1,5 @@
-import { defineRegistrySkill } from '../catalog.mjs'
+import { defineRecipe } from '../recipe.mjs'
+import { skillsAdd } from '../recipe-helpers.mjs'
 // 상류는 .claude-plugin·.codex-plugin 매니페스트를 함께 두지만 알맹이는
 // skills/diagram-design/SKILL.md 배치라, 기존 레지스트리 경로가 그대로 읽는다 —
 // 배선은 한 줄도 새로 만들지 않았다. SKILL.md의 name이 디렉터리 이름과 같아
@@ -6,9 +7,8 @@ import { defineRegistrySkill } from '../catalog.mjs'
 // 플러그인 경로만 주는 것은 commands/ 3개(/export-diagram·/import-drawio·
 // /import-mermaid)인데, 본문을 skills/.../references/에 위임하는 얇은 래퍼라
 // 규칙의 알맹이는 스킬 쪽에 전부 온다.
-export default defineRegistrySkill({
-  id: 'skill.diagram-design', label: 'Diagram Design', group: '__style',
-  source: 'https://github.com/cathrynlavery/diagram-design',
-  skill: 'diagram-design',
+export default defineRecipe({
+  id: 'skill.diagram-design', category: 'skill', label: 'Diagram Design', group: '__style',
   note: 'item.skill.diagram-design.note',
+  ...skillsAdd({ source: 'https://github.com/cathrynlavery/diagram-design', skill: 'diagram-design' }),
 })

package/lib/items/skill.eli5.mjs

@@ -1,4 +1,5 @@
-import { defineRegistrySkill } from '../catalog.mjs'
+import { defineRecipe } from '../recipe.mjs'
+import { skillsAdd } from '../recipe-helpers.mjs'
 // Anthropic 커뮤니티 마켓플레이스(anthropics/claude-plugins-community)의 eli5
 // 플러그인이 담은 스킬 하나(eli5/skills/eli5/SKILL.md, MIT). `/eli5 <주제>`를
 // 큰 그림과 짧은 글의 HTML 설명서로 만든다. 저장소 전체가 아니라 eli5/ 하위
@@ -7,13 +8,12 @@ import { defineRegistrySkill } from '../catalog.mjs'
 // (1K)만 들어온다(2026-09-18 스크래치 저장소 실측).
 //
 // 상류의 본래 경로는 Claude 플러그인(eli5@claude-community)이지만, 플러그인이
-// 더 주는 것이 없고(훅·명령 없이 스킬 하나) 공유 스킬 판은 11개 CLI가 함께
+// 더 주는 것이 없고(훅·명령 없이 스킬 하나) 공유 스킬 판은 네 CLI가 함께
 // 보므로 이쪽을 택했다. 본문은 $ARGUMENTS를 쓰는 슬래시 호출 형식이라
 // 인자 치환이 없는 CLI에서는 대화로 주제를 주면 된다.
-export default defineRegistrySkill({
-  id: 'skill.eli5', label: 'ELI5', group: '__style',
-  source: 'https://github.com/anthropics/claude-plugins-community/tree/main/eli5',
-  skill: 'eli5',
+export default defineRecipe({
+  id: 'skill.eli5', category: 'skill', label: 'ELI5', group: '__style',
   note: 'item.skill.eli5.note',
   verified: '2026-09-18',
+  ...skillsAdd({ source: 'https://github.com/anthropics/claude-plugins-community/tree/main/eli5', skill: 'eli5' }),
 })

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

@@ -1,13 +1,13 @@
-import { defineRegistrySkill } from '../catalog.mjs'
+import { defineRecipe } from '../recipe.mjs'
+import { skillsAdd } from '../recipe-helpers.mjs'
 // vercel-labs/skills는 이 저장소의 레지스트리 항목들이 쓰는 `npx skills` CLI
 // 본체 리포인데, 자체 배포 스킬은 find-skills 하나다(skills/find-skills/
 // SKILL.md, 2026-08-15 확인). 본문은 npx skills find/add/update 명령만
 // 지시하는 하네스 중립 문서다. README 예시에 나오는 web-design-guidelines
 // 등은 별도 리포(vercel-labs/agent-skills) 소속이라 이 항목과 무관하다.
-export default defineRegistrySkill({
-  id: 'skill.find-skills', label: 'find-skills', group: '__flow',
-  source: 'https://github.com/vercel-labs/skills',
-  skill: 'find-skills',
+export default defineRecipe({
+  id: 'skill.find-skills', category: 'skill', label: 'find-skills', group: '__flow',
   note: 'item.skill.find-skills.note',
   verified: '2026-08-15',
+  ...skillsAdd({ source: 'https://github.com/vercel-labs/skills', skill: 'find-skills' }),
 })