@rch4com/agent-setup 1.28.0 → 2.0.0

package/lib/items/skill.gsd.mjs

@@ -1,103 +1,38 @@
-import { existsSync, readdirSync } from 'node:fs'
-import { join } from 'node:path'
-import { defineSkill } from '../catalog.mjs'
-import { CLI_IDS } from '../clis.mjs'
-import { LocalizedError, msg } from '../i18n/index.mjs'
+import { defineRecipe } from '../recipe.mjs'
 
 // 상류(v1.10.0)는 런타임 플래그 18종을 주는데, 그중 이 저장소의 CLI이면서
 // **프로젝트 스코프(--local)로 설치되고 그 CLI가 실제로 읽는 것**만 배선한다.
-// 다섯 자리 전부 2026-08-15에 실측했다:
+// 2026-08-15 실측:
 //   claude   `.claude/commands`에 gsd-* (680파일). skills가 아니라 commands다 —
 //            부트스트랩 저장소의 `.claude/skills` Junction과 무관하다.
 //   codex    `.codex/skills`에 gsd-* 71종. `codex debug prompt-input`이 이
 //            경로를 스킬 루트로 등록하고 전부 나열하는 것을 확인했다.
 //   opencode `.opencode/skills`. `opencode debug skill`이 로드한다.
-//   copilot  `.github/skills`. `copilot skill list`가 전부 표시한다.
-//   kilo     `.kilo/skills` 71종을 @kilocode/cli 7.3.45가 읽는다(2026-08-15).
+// 런타임마다 명령 한 줄이다 — 부분 설치를 완성할 때 빠진 런타임만 돈다.
+// `--uninstall`도 런타임 플래그를 받아 그 런타임만 지운다.
+// Antigravity는 --antigravity 플래그가 있지만 설치 경로를 실측하지 못했다.
 //
-// 플래그는 한 번에 여러 개를 줄 수 있다 — `--claude --codex --local`이 두
-// 디렉터리를 만드는 것을 실측했다. 그래서 설치·제거 모두 호출 한 번이다.
-// `--uninstall`도 같은 플래그를 받아 그 런타임만 지운다(`--codex --local
-// --uninstall`이 .codex만 비우고 나머지 넷을 보존하는 것을 확인).
-//
-// 미배선 넷의 사유가 전부 다르다:
-//   gemini  상류가 명시 제거(2026-06-18 종료). `--gemini --local`은 안내만 찍고
-//           파일을 하나도 만들지 않는다.
-//   kimi    `--kimi --local`이 "Project-level Kimi install semantics remain
-//           deferred"를 찍고 거부한다 — 전역 설치만 가능하다.
-//   kiro·grok·vscode  상류 런타임 목록에 없다.
-//   antigravity  --antigravity 플래그가 있지만 설치 경로를 실측하지 못했다.
-const RUNTIMES = [
-  { cli: 'claude', dirs: ['.claude/commands', '.claude/skills'] },
-  { cli: 'codex', dirs: ['.codex/skills'] },
-  { cli: 'opencode', dirs: ['.opencode/skills'] },
-  { cli: 'copilot', dirs: ['.github/skills'] },
-  { cli: 'kilo', dirs: ['.kilo/skills'] },
-]
-const SUPPORTS = RUNTIMES.map((r) => r.cli)
-
-// gsd-* 이름을 기준으로 센다. 상류 제거가 `gsd-install-state.json`과 훅 몇
-// 개를 남기는 것을 실측했는데(디렉터리는 남고 gsd-* 스킬만 사라진다), 파일
-// 존재만 보면 제거한 런타임이 영원히 설치됨으로 읽힌다.
-function hasGsdFiles(dir) {
-  try {
-    return readdirSync(dir).some((f) => f.startsWith('gsd-'))
-  } catch {
-    return false
-  }
-}
-
-function wiredClis(root) {
-  return RUNTIMES.filter((r) => r.dirs.some((d) => hasGsdFiles(join(root, ...d.split('/'))))).map((r) => r.cli)
+// 감지는 gsd-* 이름을 기준으로 센다. 상류 제거가 `gsd-install-state.json`과
+// 훅 몇 개를 남기는 것을 실측했는데(디렉터리는 남고 gsd-* 스킬만 사라진다),
+// 파일 존재만 보면 제거한 런타임이 영원히 설치됨으로 읽힌다.
+const RUNTIMES = {
+  claude: ['.claude/commands', '.claude/skills'],
+  codex: ['.codex/skills'],
+  opencode: ['.opencode/skills'],
 }
+const NPX = ['npx', '-y', '@opengsd/gsd-core@latest']
 
-const flagsFor = (clis) => clis.map((c) => `--${c}`)
-
-export default defineSkill({
-  id: 'skill.gsd', label: 'GSD (Get Shit Done)', group: '__flow', scope: 'project',
+export default defineRecipe({
+  id: 'skill.gsd', category: 'skill', label: 'GSD (Get Shit Done)', group: '__flow',
   note: 'item.skill.gsd.note',
-  supports: SUPPORTS,
   verified: '2026-08-15',
-  unsupported: Object.fromEntries(
-    CLI_IDS.filter((c) => !SUPPORTS.includes(c)).map((c) => [
-      c,
-      c === 'gemini' ? msg('item.unsupported.gsdGemini')
-        : c === 'kimi' ? msg('item.unsupported.gsdKimiLocal')
-          // --antigravity 플래그가 있지만 어느 경로에 무엇을 쓰는지 실측하지
-          // 못했다 — 실측 전에는 배선하지 않는다.
-          : c === 'antigravity' ? msg('item.unsupported.unmeasuredUpstream')
-          : msg('item.unsupported.upstreamNone'),
-    ]),
-  ),
-
-  async detect({ root }) {
-    const present = wiredClis(root)
-    if (present.length === 0) return { status: 'absent' }
-    if (present.length === SUPPORTS.length) return { status: 'installed' }
-    return {
-      status: 'partial',
-      detail: msg('item.mcp.partial', {
-        present: present.join(', '),
-        missing: SUPPORTS.filter((c) => !present.includes(c)).join(', '),
-      }),
-    }
-  },
-
-  async install({ root, exec }) {
-    // 이미 있는 런타임은 빼고 부른다 — 상류가 덮어써도 무해하지만, 부분
-    // 설치를 완성할 때 3,500개 파일을 다시 쓰는 것은 낭비다.
-    const missing = SUPPORTS.filter((c) => !wiredClis(root).includes(c))
-    if (missing.length === 0) return
-    const r = await exec('npx', ['-y', '@opengsd/gsd-core@latest', ...flagsFor(missing), '--local'], { cwd: root })
-    if (!r.ok) throw new LocalizedError('error.gsdInstall', { output: r.output })
-  },
-
-  async uninstall({ root, exec }) {
-    // 런타임 플래그 없는 `--uninstall`은 기본값 claude만 지운다 — 설치된
-    // 런타임을 전부 넘겨야 나머지 넷이 남지 않는다.
-    const present = wiredClis(root)
-    if (present.length === 0) return
-    const r = await exec('npx', ['-y', '@opengsd/gsd-core@latest', ...flagsFor(present), '--local', '--uninstall'], { cwd: root })
-    if (!r.ok) throw new LocalizedError('error.gsdUninstall', { output: r.output })
-  },
+  recipes: Object.fromEntries(Object.keys(RUNTIMES).map((cli) => [cli, {
+    project: {
+      install: [[...NPX, `--${cli}`, '--local']],
+      // 런타임 플래그 없는 --uninstall은 기본값 claude를 지운다 — 늘 플래그를 준다.
+      uninstall: [[...NPX, `--${cli}`, '--local', '--uninstall']],
+    },
+  }])),
+  detect: Object.fromEntries(Object.entries(RUNTIMES).map(([cli, dirs]) => [cli, (p) => dirs.some((d) => p.dirHasPrefix(d, 'gsd-'))])),
+  reasons: { antigravity: 'item.unsupported.unmeasuredUpstream' },
 })

package/lib/items/skill.gstack.mjs

@@ -1,74 +1,63 @@
-import { existsSync, rmSync } from 'node:fs'
-import { join } from 'node:path'
-import { defineSkill } from '../catalog.mjs'
-import { CLI_IDS } from '../clis.mjs'
-import { repoPath, repoPathStrict } from '../context.mjs'
+import { rmSync } from 'node:fs'
+import { defineRecipe } from '../recipe.mjs'
+import { repoPathStrict } from '../context.mjs'
 import { ensureGitignoreEntries, removeGitignoreEntries } from '../gitignore.mjs'
-import { LocalizedError, msg } from '../i18n/index.mjs'
 
-const REL_DIR = '.claude/skills/gstack'
-const IGNORE_ENTRIES = ['.claude/skills/gstack', '.agents/skills/gstack']
-
-// 상류 setup은 --host codex·kiro·opencode(와 factory)도 지원하지만 이 항목은
-// 인자 없이 실행하며 setup의 기본값이 claude 단독이다. README 표에 있는
-// --host cursor·slate는 setup의 case 문이 거부해 exit 1로 죽는다 —
-// 확장한다면 안전한 값은 claude·codex·kiro·factory·opencode·auto뿐이다
-// (2026-08-02 검증, 2026-08-15 재확인: case 문과 에러 문구 그대로).
+// 상류 setup은 --host codex·opencode 등도 지원하지만 이 항목은 인자 없이
+// 실행하며 setup의 기본값이 claude 단독이다. README 표에 있는 --host
+// cursor·slate는 setup의 case 문이 거부해 exit 1로 죽는다(2026-08-15 재확인).
 //
-// 그런데 --host를 늘릴 필요가 없다는 것이 2026-08-15 실측으로 드러났다.
-// 상류 --host 경로는 홈(~/.codex/skills 등)에 까는 사용자 스코프인데, 이
-// 항목이 clone하는 `.claude/skills/gstack`은 부트스트랩 저장소에서 Junction
-// 이라 실물이 공유 `.agents/skills/gstack`에 앉는다. 거기서부터는 CLI의 스킬
-// 스캔 깊이가 도달 범위를 정한다 — gstack은 클론 루트에 라우터 SKILL.md가
-// 있고 개별 스킬이 그 아래 한 단계 더 들어간 2단계 구조다.
-//   codex·opencode  재귀 스캔이라 개별 스킬까지 전부 인식(중첩 프로브로 실측).
-//   copilot         1단계만 훑어 라우터 스킬 하나만 보인다(같은 프로브).
-// 나머지 CLI의 스캔 깊이는 미실측이라 "상류 경로 없음"으로 남긴다 — Junction
-// 도달은 우리 부트스트랩의 부수 효과지 상류 지원이 아니다.
-const SHARED_RECURSIVE = ['codex', 'opencode']
+// --host를 늘릴 필요가 없다는 것이 2026-08-15 실측으로 드러났다. 상류 --host
+// 경로는 홈(~/.codex/skills 등)에 까는 사용자 스코프인데, 이 항목이 clone하는
+// `.claude/skills/gstack`은 부트스트랩 저장소에서 Junction이라 실물이 공유
+// `.agents/skills/gstack`에 앉는다. codex·opencode는 스킬을 재귀로 스캔해
+// 클론 루트 아래 개별 스킬까지 인식한다(중첩 프로브로 실측). Antigravity의
+// 스캔 깊이는 미실측이라 "상류 경로 없음"으로 남긴다.
+const DIR = '.claude/skills/gstack'
+// 부트스트랩 저장소에서는 .claude/skills가 .agents/skills Junction이므로 두 경로 모두 무시 처리
+const IGNORE_ENTRIES = ['.claude/skills/gstack', '.agents/skills/gstack']
+// clone·삭제가 일어나는 경로다. 어휘적 검사만으로는 .claude/skills가 저장소
+// 밖을 가리키는 링크일 때를 막지 못한다 — 부트스트랩은 사용자가 관리하는
+// .claude/skills를 보존하므로, 그것이 홈을 가리키면 clone·setup이 저장소 밖에
+// 쓴다. 명령을 돌리기 전에 실제 경로가 저장소 안인지 확인한다.
+const guard = { describe: `check ${DIR} stays inside the repository`, fn: ({ root }) => { repoPathStrict(root, DIR) } }
+const removeDir = ({ root }) => rmSync(repoPathStrict(root, DIR), { recursive: true, force: true })
+// 디렉터리 이동을 bash 안에서 한다 — --print로 복사한 줄을 저장소 루트에서 붙여도
+// 엉뚱한 ./setup이 돌지 않는다.
+const inDir = (command) => ['bash', '-c', `cd ${DIR} && ${command}`]
 
-export default defineSkill({
-  id: 'skill.gstack', label: 'gstack', group: '__flow', scope: 'project',
+export default defineRecipe({
+  id: 'skill.gstack', category: 'skill', label: 'gstack', group: '__flow',
   note: 'item.skill.gstack.note',
   verified: '2026-08-15',
-  unsupported: Object.fromEntries(
-    CLI_IDS.filter((c) => c !== 'claude').map((c) => [
-      c,
-      SHARED_RECURSIVE.includes(c) ? msg('item.unsupported.gstackShared')
-        : c === 'copilot' ? msg('item.unsupported.gstackSharedShallow')
-          : c === 'kiro' ? msg('item.unsupported.gstackHost')
-            : msg('item.unsupported.upstreamNone'),
-    ]),
-  ),
-  async detect({ root }) {
-    return { status: existsSync(repoPath(root, REL_DIR)) ? 'installed' : 'absent' }
-  },
-  async install({ root, dryRun, exec }) {
-    // clone·삭제가 일어나는 경로다. 어휘적 검사만으로는 .claude/skills가
-    // 저장소 밖을 가리키는 링크일 때를 막지 못한다(부트스트랩이 만드는
-    // .agents/skills Junction은 저장소 안이라 그대로 통과한다).
-    const dir = repoPathStrict(root, REL_DIR)
-    if (!existsSync(dir)) {
-      const clone = await exec('git', ['clone', '--single-branch', '--depth', '1', 'https://github.com/garrytan/gstack.git', dir])
-      if (!clone.ok) throw new LocalizedError('error.gstackClone', { output: clone.output })
-      const setup = await exec('bash', ['./setup'], { cwd: dir })
-      if (!setup.ok) {
-        // setup 실패 잔존물이 detect를 installed로 오판시키지 않도록 정리한다.
-        rmSync(dir, { recursive: true, force: true })
-        throw new LocalizedError('error.gstackSetup', { output: setup.output })
-      }
-    }
-    // 부트스트랩 저장소에서는 .claude/skills가 .agents/skills Junction이므로 두 경로 모두 무시 처리
-    if (!dryRun) ensureGitignoreEntries(root, IGNORE_ENTRIES)
+  recipes: {
+    claude: {
+      project: {
+        install: [
+          guard,
+          ['git', 'clone', '--single-branch', '--depth', '1', 'https://github.com/garrytan/gstack.git', DIR],
+          // setup이 실패하면 반쯤 깔린 클론을 지운다 — 남기면 다음 감지가 설치됨으로 읽는다.
+          { argv: inDir('bash ./setup'), undo: removeDir },
+          { describe: `add ${IGNORE_ENTRIES.join(', ')} to .gitignore`, fn: ({ root }) => ensureGitignoreEntries(root, IGNORE_ENTRIES) },
+        ],
+        uninstall: [
+          guard,
+          // 상류 제거 스크립트가 실패해도 디렉터리 삭제로 마무리한다.
+          { argv: inDir('bash ./bin/gstack-uninstall --force'), tolerateFail: true },
+          {
+            // 설치가 넣은 두 줄을 도로 가져간다 — 남겨 두면 제거한 뒤에도 우리가
+            // 만든 흔적이 .gitignore에 계속 남는다.
+            describe: `remove ${DIR} and its .gitignore entries`,
+            fn: (ctx) => { removeDir(ctx); removeGitignoreEntries(ctx.root, IGNORE_ENTRIES) },
+          },
+        ],
+      },
+    },
   },
-  async uninstall({ root, dryRun, exec }) {
-    const dir = repoPathStrict(root, REL_DIR)
-    if (!existsSync(dir)) return
-    await exec('bash', [join(dir, 'bin', 'gstack-uninstall'), '--force'], { cwd: dir }) // 실패해도 디렉터리 삭제로 폴백
-    if (dryRun) return
-    if (existsSync(dir)) rmSync(dir, { recursive: true, force: true })
-    // 설치가 넣은 두 줄을 도로 가져간다 — 남겨 두면 제거한 뒤에도 우리가 만든
-    // 흔적이 .gitignore에 계속 남는다.
-    removeGitignoreEntries(root, IGNORE_ENTRIES)
+  detect: { claude: (p) => p.exists(DIR) },
+  reasons: {
+    codex: 'item.unsupported.gstackShared',
+    opencode: 'item.unsupported.gstackShared',
+    antigravity: 'item.unsupported.upstreamNone',
   },
 })

package/lib/items/skill.hallmark.mjs

@@ -1,11 +1,11 @@
-import { defineRegistrySkill } from '../catalog.mjs'
+import { defineRecipe } from '../recipe.mjs'
+import { skillsAdd } from '../recipe-helpers.mjs'
 // 상류 저장소는 skills/hallmark/SKILL.md 배치라 레지스트리가 그대로 읽는다 —
 // SKILL.md의 name도 hallmark라 디렉터리 이름과 어긋나지 않는다(taste와 다른 점).
 // references/가 100개가 넘지만 레지스트리가 통째로 복사한다(2026-08-10 실측).
-export default defineRegistrySkill({
-  id: 'skill.hallmark', label: 'Hallmark', group: '__style',
-  source: 'https://github.com/nutlope/hallmark',
-  skill: 'hallmark',
+export default defineRecipe({
+  id: 'skill.hallmark', category: 'skill', label: 'Hallmark', group: '__style',
   note: 'item.skill.hallmark.note',
   verified: '2026-08-10',
+  ...skillsAdd({ source: 'https://github.com/nutlope/hallmark', skill: 'hallmark' }),
 })

package/lib/items/skill.i-have-adhd.mjs

@@ -1,16 +1,16 @@
-import { defineRegistrySkill } from '../catalog.mjs'
+import { defineRecipe } from '../recipe.mjs'
+import { skillsAdd } from '../recipe-helpers.mjs'
 // 상류는 skills/i-have-adhd/에 SKILL.md와 agents/(gemini.toml·openai.yaml)를
 // 두고 루트에는 SKILL.md가 없다 — 레지스트리가 그 폴더만 복사한다(3파일,
 // 13K, 2026-09-17 실측). Claude 마켓플레이스 플러그인 판(ayghri/i-have-adhd)도
 // 있지만 그쪽이 더 주는 것은 SessionStart 훅 하나이고, 그 훅은
 // ~/.claude/.i-have-adhd-always 플래그가 있을 때만 규칙을 상시 주입한다.
-// 스킬의 기본 자세는 /i-have-adhd로 켜는 opt-in이라 공유 스킬 판으로 11개
+// 스킬의 기본 자세는 /i-have-adhd로 켜는 opt-in이라 공유 스킬 판으로 네
 // CLI를 함께 덮는 쪽을 택했다 — 상시 적용을 원하면 note가 안내하는 대로
 // 규칙 블록을 각 CLI의 지침 파일에 손으로 넣는다(상류 INSTALL.md).
-export default defineRegistrySkill({
-  id: 'skill.i-have-adhd', label: 'I Have ADHD', group: '__style',
-  source: 'https://github.com/ayghri/i-have-adhd',
-  skill: 'i-have-adhd',
+export default defineRecipe({
+  id: 'skill.i-have-adhd', category: 'skill', label: 'I Have ADHD', group: '__style',
   note: 'item.skill.i-have-adhd.note',
   verified: '2026-09-17',
+  ...skillsAdd({ source: 'https://github.com/ayghri/i-have-adhd', skill: 'i-have-adhd' }),
 })

package/lib/items/skill.im-not-ai.mjs

@@ -1,4 +1,5 @@
-import { defineRegistrySkill } from '../catalog.mjs'
+import { defineRecipe } from '../recipe.mjs'
+import { skillsAdd } from '../recipe-helpers.mjs'
 // epoko77-ai/im-not-ai(MIT)의 skills/에 SKILL.md 4종(humanize-korean·humanize·
 // humanize-scan·humanize-redo)이 있다. humanize-korean이 본체이고 나머지는 그
 // 진입점·정찰·재윤문 shim이라 함께 받는다. 2026-10-08 스크래치 저장소에서
@@ -6,11 +7,9 @@ import { defineRegistrySkill } from '../catalog.mjs'
 // 상류 루트의 agents/(서브에이전트 9종)와 플러그인 매니페스트는 스킬 폴더
 // 밖이라 따라오지 않는다 — 서브에이전트 경로는 Claude 플러그인 판 몫이고,
 // 여기서는 스킬만 공유 디렉터리로 들어온다(note가 알린다).
-export default defineRegistrySkill({
-  id: 'skill.im-not-ai', label: 'Humanize Korean', group: '__style',
-  source: 'https://github.com/epoko77-ai/im-not-ai',
-  skill: '*',
-  anchor: 'humanize-korean',
+export default defineRecipe({
+  id: 'skill.im-not-ai', category: 'skill', label: 'Humanize Korean', group: '__style',
   note: 'item.skill.im-not-ai.note',
   verified: '2026-10-08',
+  ...skillsAdd({ source: 'https://github.com/epoko77-ai/im-not-ai', skill: '*', anchor: 'humanize-korean' }),
 })

package/lib/items/skill.impeccable.mjs

@@ -1,16 +1,16 @@
-import { defineRegistrySkill } from '../catalog.mjs'
+import { defineRecipe } from '../recipe.mjs'
+import { skillsAdd } from '../recipe-helpers.mjs'
 // 같은 상류를 플러그인(plugin.impeccable)으로도 넣을 수 있다. 플러그인은 Claude
-// 하나에만 닿고, 이쪽은 공유 .agents/skills라 11개 CLI가 함께 본다. 둘을 함께
+// 하나에만 닿고, 이쪽은 공유 .agents/skills라 네 CLI가 함께 본다. 둘을 함께
 // 켜면 같은 스킬이 플러그인 캐시와 공유 디렉터리 양쪽에서 잡혀 중복 등록되므로
 // 배타로 묶는다.
 // 레지스트리가 pbakaus/impeccable에서 읽는 스킬은 impeccable 하나다
 // (`skills add --list`, 2026-10-06 확인). 엔진 바이너리는 포함되지 않는다 —
 // `npx impeccable install`만 플랫폼별 실행 파일을 함께 내려 준다.
-export default defineRegistrySkill({
-  id: 'skill.impeccable', label: 'impeccable (skill)', group: '__style',
-  source: 'https://github.com/pbakaus/impeccable',
-  skill: 'impeccable',
+export default defineRecipe({
+  id: 'skill.impeccable', category: 'skill', label: 'impeccable (skill)', group: '__style',
   exclusive: 'impeccable',
   note: 'item.skill.impeccable.note',
   verified: '2026-10-06',
+  ...skillsAdd({ source: 'https://github.com/pbakaus/impeccable', skill: 'impeccable' }),
 })

package/lib/items/skill.karpathy.mjs

@@ -1,7 +1,7 @@
-import { defineRegistrySkill } from '../catalog.mjs'
-export default defineRegistrySkill({
-  id: 'skill.karpathy', label: 'Karpathy guidelines', group: '__flow',
-  source: 'https://github.com/multica-ai/andrej-karpathy-skills',
-  skill: 'karpathy-guidelines',
+import { defineRecipe } from '../recipe.mjs'
+import { skillsAdd } from '../recipe-helpers.mjs'
+export default defineRecipe({
+  id: 'skill.karpathy', category: 'skill', label: 'Karpathy guidelines', group: '__flow',
   note: 'item.skill.karpathy.note',
+  ...skillsAdd({ source: 'https://github.com/multica-ai/andrej-karpathy-skills', skill: 'karpathy-guidelines' }),
 })

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

@@ -1,4 +1,5 @@
-import { defineRegistrySkill } from '../catalog.mjs'
+import { defineRecipe } from '../recipe.mjs'
+import { skillsAdd } from '../recipe-helpers.mjs'
 // 상류가 "Codex, and other agents" 절에서 이 경로를 직접 안내한다 —
 // `npx skills add mattpocock/skills`다. 그러니 이쪽이 곁길이 아니라 상류가
 // 의도한 두 경로 중 하나다. 훅이 없는 스킬 묶음이라 플러그인 판에 견줘 잃는
@@ -6,11 +7,9 @@ import { defineRegistrySkill } from '../catalog.mjs'
 //
 // 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',
+export default defineRecipe({
+  id: 'skill.mattpocock-skills', category: 'skill', label: 'Matt Pocock (skills)', group: '__flow',
   exclusive: 'mattpocock',
   note: 'item.skill.mattpocock-skills.note',
+  ...skillsAdd({ source: 'https://github.com/mattpocock/skills', skill: '*', anchor: 'setup-matt-pocock-skills' }),
 })

package/lib/items/skill.mcp-builder.mjs

@@ -1,14 +1,14 @@
-import { defineRegistrySkill } from '../catalog.mjs'
+import { defineRecipe } from '../recipe.mjs'
+import { skillsAdd } from '../recipe-helpers.mjs'
 // anthropics/skills 17종 중 mcp-builder 하나만 --skill로 고른다. 본문이
 // reference/*.md 넷을 상대경로로 참조하는데 레지스트리 --copy가 스킬
 // 디렉터리를 통째로 복사하므로 함께 온다 — 스킬별 LICENSE.txt(Apache-2.0)도
 // 같은 디렉터리에 실려 고지가 유지된다(2026-08-15 확인, 리포 단위 라이선스는
 // 없고 스킬별로 갈린다). Python(FastMCP)·Node(MCP SDK) 서버 작성 가이드라
 // Claude 전용 도구 없이 하네스 중립이다.
-export default defineRegistrySkill({
-  id: 'skill.mcp-builder', label: 'mcp-builder', group: '__service',
-  source: 'https://github.com/anthropics/skills',
-  skill: 'mcp-builder',
+export default defineRecipe({
+  id: 'skill.mcp-builder', category: 'skill', label: 'mcp-builder', group: '__service',
   note: 'item.skill.mcp-builder.note',
   verified: '2026-08-15',
+  ...skillsAdd({ source: 'https://github.com/anthropics/skills', skill: 'mcp-builder' }),
 })

package/lib/items/skill.officecli.mjs

@@ -1,4 +1,5 @@
-import { defineRegistrySkill } from '../catalog.mjs'
+import { defineRecipe } from '../recipe.mjs'
+import { skillsAdd } from '../recipe-helpers.mjs'
 // 상류는 루트 SKILL.md(공개 URL이 서빙하는 판)와 skills/officecli/SKILL.md
 // (레지스트리가 발견하는 spec 준수 판)를 바이트 동일하게 유지한다(상류
 // skill-parity 워크플로). 저장소 루트를 source로 주면 레지스트리가 루트
@@ -12,10 +13,9 @@ import { defineRegistrySkill } from '../catalog.mjs'
 // 전제다 — note가 알린다. 같은 폴더의 전문 스킬 10종(officecli-docx·pptx·
 // xlsx, pitch-deck, morph-ppt 등)은 넣지 않는다 — 상류가 에이전트에 안내하는
 // 공식 경로는 이 하나다(README "For AI Agents").
-export default defineRegistrySkill({
-  id: 'skill.officecli', label: 'OfficeCLI', group: '__service',
-  source: 'https://github.com/iOfficeAI/OfficeCLI/tree/main/skills/officecli',
-  skill: 'officecli',
+export default defineRecipe({
+  id: 'skill.officecli', category: 'skill', label: 'OfficeCLI', group: '__service',
   note: 'item.skill.officecli.note',
   verified: '2026-09-15',
+  ...skillsAdd({ source: 'https://github.com/iOfficeAI/OfficeCLI/tree/main/skills/officecli', skill: 'officecli' }),
 })

package/lib/items/skill.prompt-master.mjs

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

package/lib/items/skill.remotion.mjs

@@ -1,4 +1,5 @@
-import { defineRegistrySkill } from '../catalog.mjs'
+import { defineRecipe } from '../recipe.mjs'
+import { skillsAdd } from '../recipe-helpers.mjs'
 // remotion-dev/skills에는 최상위 스킬이 12개 있는데, remotion-best-practices가
 // 나머지 11개(create·markup·studio·render·captions·maps…)를 하위 폴더로 모두
 // 품는 상위 스킬이다(141개 파일, 1.1MB — 2026-10-06 실측). 하나만 받으면
@@ -6,10 +7,9 @@ import { defineRegistrySkill } from '../catalog.mjs'
 // 같은 개별 슬래시 명령은 생기지 않는다.
 // 상류 라이선스는 SPDX가 아닌 Remotion License다 — 개인·직원 3명 이하 영리
 // 조직·비영리는 무료, 그보다 큰 영리 조직은 회사 라이선스가 필요하다.
-export default defineRegistrySkill({
-  id: 'skill.remotion', label: 'Remotion', group: '__service',
-  source: 'https://github.com/remotion-dev/skills',
-  skill: 'remotion-best-practices',
+export default defineRecipe({
+  id: 'skill.remotion', category: 'skill', label: 'Remotion', group: '__service',
   note: 'item.skill.remotion.note',
   verified: '2026-10-06',
+  ...skillsAdd({ source: 'https://github.com/remotion-dev/skills', skill: 'remotion-best-practices' }),
 })

package/lib/items/skill.strix.mjs

@@ -1,13 +1,12 @@
-import { defineRegistrySkill } from '../catalog.mjs'
+import { defineRecipe } from '../recipe.mjs'
+import { skillsAdd } from '../recipe-helpers.mjs'
 // 상류가 skills/에 SKILL.md 9종을 두고 npx skills add usestrix/strix를 README로
 // 직접 안내한다. 스킬 본문은 strix CLI를 구동하는 지침이라 바이너리가 사실상
 // 전제다 — note가 알린다. 2026-09-02 스크래치 저장소에서 9종 설치와
 // skills-lock.json의 source(usestrix/strix) 기록을 실측했다.
-export default defineRegistrySkill({
-  id: 'skill.strix', label: 'Strix', group: '__service',
-  source: 'https://github.com/usestrix/strix',
-  skill: '*',
-  anchor: 'penetration-testing-with-strix',
+export default defineRecipe({
+  id: 'skill.strix', category: 'skill', label: 'Strix', group: '__service',
   note: 'item.skill.strix.note',
   verified: '2026-09-02',
+  ...skillsAdd({ source: 'https://github.com/usestrix/strix', skill: '*', anchor: 'penetration-testing-with-strix' }),
 })

package/lib/items/skill.superpowers.mjs

@@ -1,7 +1,8 @@
-import { defineRegistrySkill } from '../catalog.mjs'
+import { defineRecipe } from '../recipe.mjs'
+import { skillsAdd } from '../recipe-helpers.mjs'
 // 같은 상류를 플러그인(plugin.superpowers)으로도 넣을 수 있다. 그쪽은 Claude
 // 하나만 닿는 대신 session-start 훅으로 알아서 켜지고, 이쪽은 공유
-// .agents/skills라 10개 CLI가 함께 보는 대신 훅이 빠진다 — 스킬은 부르면 되지만
+// .agents/skills라 네 CLI가 함께 보는 대신 훅이 빠진다 — 스킬은 부르면 되지만
 // "대화 시작 시 using-superpowers 주입"은 오지 않는다.
 // 둘을 함께 켜면 같은 스킬이 플러그인 캐시와 공유 디렉터리 양쪽에서 잡혀 중복
 // 등록되므로 배타로 묶는다.
@@ -9,11 +10,9 @@ import { defineRegistrySkill } from '../catalog.mjs'
 // 상류 배치가 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',
+export default defineRecipe({
+  id: 'skill.superpowers', category: 'skill', label: 'superpowers (skills)', group: '__flow',
   exclusive: 'superpowers',
   note: 'item.skill.superpowers.note',
+  ...skillsAdd({ source: 'https://github.com/obra/superpowers', skill: '*', anchor: 'using-superpowers' }),
 })

package/lib/items/skill.taste.mjs

@@ -1,9 +1,9 @@
-import { defineRegistrySkill } from '../catalog.mjs'
+import { defineRecipe } from '../recipe.mjs'
+import { skillsAdd } from '../recipe-helpers.mjs'
 // 저장소의 폴더 이름은 taste-skill이지만 SKILL.md의 name은 design-taste-frontend다.
 // 레지스트리는 name으로 고르므로 여기에도 name을 적는다.
-export default defineRegistrySkill({
-  id: 'skill.taste', label: 'Taste Skill', group: '__style',
-  source: 'https://github.com/Leonxlnx/taste-skill',
-  skill: 'design-taste-frontend',
+export default defineRecipe({
+  id: 'skill.taste', category: 'skill', label: 'Taste Skill', group: '__style',
   note: 'item.skill.taste.note',
+  ...skillsAdd({ source: 'https://github.com/Leonxlnx/taste-skill', skill: 'design-taste-frontend' }),
 })