[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M787J4AMQXRM16BMVK98TYND":3,"skill-same:01M787J4AMQXRM16BMVK98TYND":48},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":26,"commitSha":27,"skillDirectory":28,"forksCount":13,"repositoryHtmlUrl":29,"repositoryHomepageUrl":6,"ownerHtmlUrl":30,"ownerBlogUrl":31,"ownerDescription":32,"updatedAt":33,"install":34,"resources":47},"01M787J4AMQXRM16BMVK98TYND","workspace-init",null,"Set up or refresh a multi-repo workspace from the parent folder of its sibling repos — the hub repo (repos registry, cross-repo backlog and decisions) that \u002Fvibe:next-task reads, and the local, untracked workspace-root CLAUDE.md that indexes the hub and the siblings","neolao\u002Fclaude-plugin-vibe","neolao","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F149506?v=4","01M787F66EN3C5HEKZCY53VPY8","01M787F67MZYM53GYFZWR4M59E",0,"MIT","https:\u002F\u002Fgithub.com\u002Fneolao\u002Fclaude-plugin-vibe\u002Fblob\u002Fmain\u002Fskills\u002Fworkspace-init\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: workspace-init\ndescription: Set up or refresh a multi-repo workspace from the parent folder of its sibling repos — the hub repo (repos registry, cross-repo backlog and decisions) that \u002Fvibe:next-task reads, and the local, untracked workspace-root CLAUDE.md that indexes the hub and the siblings\nargument-hint: \"[hub repo dir name, e.g. roadmap] (only used on first bootstrap)\"\nversion: 1.1.0\nmodel: claude-sonnet-5-5\n---\n\n# \u002Fvibe:workspace-init — Multi-Repo Workspace Bootstrap\n\nA **workspace** is a parent folder — never itself a Git repo — holding several sibling repos. This skill sets up, or idempotently refreshes, two things:\n- the **hub repo**: a Git repo with no application code that plans across the others — `repos.md` (registry of siblings) plus a workspace-scoped `.vibe\u002Fbacklog\u002F` and `.vibe\u002Fdecisions\u002F`. Recognized by a structural **marker**, never a fixed name: a directory with `.git\u002F` and `repos.md` at its root;\n- the **workspace-root `CLAUDE.md`**: a local, never-committed file at the parent folder's root pointing to the hub and listing the siblings.\n\nRe-run whenever a repo is added, retired, or renamed. This skill never pushes.\n\n## Step 1 — Where are we?\n\nRun `git rev-parse --show-toplevel` in cwd — a subdirectory of a repo has no `.git\u002F` of its own and would pass for a workspace root:\n- it prints a directory with the marker → inside the hub repo: the workspace root is that directory's parent; go to Step 3.\n- it prints a directory without `repos.md` → inside a code repo: stop with \"Run `\u002Fvibe:workspace-init` from the workspace root (the parent folder, not inside a repo), or from the hub repo itself.\"\n- it fails (not in a work tree) → cwd is the workspace root; go to Step 2.\n\n## Step 2 — Locate or create the hub repo\n\nPrefer the pointer: the `## Hub repo` line of a workspace-root `CLAUDE.md` from a previous run — valid if that directory still has the marker. Otherwise scan cwd's direct subdirectories for the marker.\n\nNot found → first bootstrap. The hub directory name is `$ARGUMENTS` when given — do not ask it again — otherwise `AskUserQuestion` for it, suggesting a neutral name such as \"roadmap\"; ask for an optional Git remote either way; `mkdir` + `git init` (+ `git remote add origin`), or `git init` in place if the directory exists without `.git\u002F`. Then invoke the `vibe:clarify` skill with \"the purpose of this new multi-repo workspace — why these repos belong together and what it's meant to achieve\": `settled`\u002F`partial` → its `### Synthesis` is the workspace vision used in Step 5; `abandoned` → no vision paragraph.\n\n## Step 3 — Task list\n\nInvoke the `vibe:tasks` skill with: `Update repos registry` → `Ensure .vibe\u002F scaffolding` → `Write hub repo CLAUDE.md` → `Refresh hub repo README` → `Refresh workspace CLAUDE.md`.\n\n## Step 4 — `repos.md`\n\nA sibling is a direct subdirectory of the workspace root whose `.git` is a directory, the hub excluded; nothing is scanned deeper (a repo nested in a sibling is that sibling's business) and folders without `.git` are ignored. Not siblings — named in the report, never registered: a directory whose `.git` is a file (a linked worktree, a second checkout of a repo registered elsewhere) and a bare repository (`something.git`, no working tree to work in).\n\n`repos.md` is never regenerated, only edited: a refresh adds rows in the columns the file already has (a hand-made registry may have its own), fills a Remote still `—` once the repo has an `origin`, and leaves every other cell, column and section — `## Naming convention` included — as it found them.\n\nAlready listed → keep `status` and `role` exactly as they are (never overwrite a human judgment). New sibling → `status: active` if it has `.vibe\u002Fbacklog\u002F`, otherwise `AskUserQuestion` for the status (`active` picked by `\u002Fvibe:next-task` \u002F `planned` no code yet \u002F `idea` no repo yet \u002F `archived` retired, kept for the record, never picked) and a one-line role — never guess the role. An `active` row whose directory is gone → report it and ask: mark it `archived` (the default — the row keeps what the workspace knew of it) or remove the row. A `planned`, `idea` or `archived` row needs no directory: never question it.\n\n```markdown\n# Repos registry\n\nMaintained by \u002Fvibe:workspace-init — re-run after adding, retiring, or renaming a repo.\n\n| Repo | Status | Role | Remote |\n|---|---|---|---|\n| api | active | REST backend, owns the `orders` domain | git@github.com:acme\u002Fapi.git |\n| sdk | planned | Shared TS client — not started | — |\n| legacy-portal | archived | Old customer portal, replaced by `api` | — |\n\n## Naming convention\n[the workspace's repo-naming pattern, or \"None documented yet.\"]\n```\n\nThen create `.vibe\u002Fbacklog\u002F` and `.vibe\u002Fdecisions\u002F` in the hub if absent, each with a `.gitkeep` while it is empty (git commits no empty directory, so a clone of the hub would lack them), never touching existing items or ADRs.\n\n## Step 5 — Hub repo `CLAUDE.md`\n\nWritten here, not by `vibe:init` (whose stack detection and DoD assume application code):\n\n```markdown\n# CLAUDE.md — [hub repo name] (workspace hub — no code)\n\n> Auto-generated by \u002Fvibe:workspace-init. Edit freely. Add `\u003C!-- keep -->` on a section heading to preserve it on regeneration.\n\n## Role\n\nThis repo holds no application code. It is the source of truth for cross-repo planning: [repos.md](repos.md) registers every sibling repo (status, role, remote); `.vibe\u002Fbacklog\u002F` and `.vibe\u002Fdecisions\u002F` hold Product Owner decisions and ADRs spanning more than one repo.\n\n[Vision paragraph: on a bootstrap, the Step 2 synthesis in the project's language; on a refresh, the paragraph standing here in the existing file, carried over unchanged — a refresh never drops it.]\n\n**Items here are never implementable work** — never picked up by `\u002Fvibe:feature`, `\u002Fvibe:fix`, or `\u002Fvibe:auto`. Run `\u002Fvibe:next-task` from the workspace root to pick and ship actual work in the right repo.\n\n## Backlog & decisions\n\nSame format as any vibe-managed repo, scoped to workspace-level concerns: which repo owns what, cross-repo sequencing, naming conventions. `\u002Fvibe:backlog` works here too. Managed by hand, never by an autonomous run.\n```\n\nThen invoke the `vibe:docs` skill (README skeleton or refresh) and the `vibe:sync` skill — a hub has little source; \"nothing to update\" is a normal outcome, noted in the report.\n\n## Step 6 — Workspace-root `CLAUDE.md`\n\nFull idempotent overwrite (with `\u003C!-- keep -->` support), never committed — the folder is not a repo and the file regenerates from `repos.md`:\n\n```markdown\n# CLAUDE.md — [workspace name] (workspace root — not a git repo)\n\n> Auto-generated by \u002Fvibe:workspace-init. Not version-controlled: local-only context. Add `\u003C!-- keep -->` on a section heading to preserve it.\n\n## Hub repo\n`[hub-dir]\u002F` — source of truth for cross-repo planning (`repos.md`, workspace-scope backlog\u002Fdecisions in `.vibe\u002F`). Its items are Product Owner decisions, never implementable work.\n\n## Sibling repos\n| Repo | Status | Role |\n|---|---|---|\n[mirrored from repos.md]\n\n## Cross-repo workflow\nRun `\u002Fvibe:next-task` from this directory to pick, implement, and ship the next eligible task across active repos.\n```\n\nThe `## Hub repo` line is the pointer Step 2 and `\u002Fvibe:next-task` read — keep the exact directory name in the backticks.\n\n## Step 7 — Commit and report\n\nIn the hub: stage everything this run wrote or changed — `repos.md`, `.vibe\u002F`, `CLAUDE.md`, `README.md`, and whatever `vibe:docs` and `vibe:sync` produced (`docs\u002F` included) — in one commit: `chore: bootstrap hub repo` on first init, `chore: refresh workspace registry` otherwise; nothing changed → say so. Report, short and plain: hub location (created \u002F existed); repos added, updated, flagged missing; files refreshed; commit or \"nothing to commit\"; a reminder to push the hub when convenient.\n","# \u002Fvibe:workspace-init — Multi-Repo Workspace Bootstrap\n\nA **workspace** is a parent folder — never itself a Git repo — holding several sibling repos. This skill sets up, or idempotently refreshes, two things:\n- the **hub repo**: a Git repo with no application code that plans across the others — `repos.md` (registry of siblings) plus a workspace-scoped `.vibe\u002Fbacklog\u002F` and `.vibe\u002Fdecisions\u002F`. Recognized by a structural **marker**, never a fixed name: a directory with `.git\u002F` and `repos.md` at its root;\n- the **workspace-root `CLAUDE.md`**: a local, never-committed file at the parent folder's root pointing to the hub and listing the siblings.\n\nRe-run whenever a repo is added, retired, or renamed. This skill never pushes.\n\n## Step 1 — Where are we?\n\nRun `git rev-parse --show-toplevel` in cwd — a subdirectory of a repo has no `.git\u002F` of its own and would pass for a workspace root:\n- it prints a directory with the marker → inside the hub repo: the workspace root is that directory's parent; go to Step 3.\n- it prints a directory without `repos.md` → inside a code repo: stop with \"Run `\u002Fvibe:workspace-init` from the workspace root (the parent folder, not inside a repo), or from the hub repo itself.\"\n- it fails (not in a work tree) → cwd is the workspace root; go to Step 2.\n\n## Step 2 — Locate or create the hub repo\n\nPrefer the pointer: the `## Hub repo` line of a workspace-root `CLAUDE.md` from a previous run — valid if that directory still has the marker. Otherwise scan cwd's direct subdirectories for the marker.\n\nNot found → first bootstrap. The hub directory name is `$ARGUMENTS` when given — do not ask it again — otherwise `AskUserQuestion` for it, suggesting a neutral name such as \"roadmap\"; ask for an optional Git remote either way; `mkdir` + `git init` (+ `git remote add origin`), or `git init` in place if the directory exists without `.git\u002F`. Then invoke the `vibe:clarify` skill with \"the purpose of this new multi-repo workspace — why these repos belong together and what it's meant to achieve\": `settled`\u002F`partial` → its `### Synthesis` is the workspace vision used in Step 5; `abandoned` → no vision paragraph.\n\n## Step 3 — Task list\n\nInvoke the `vibe:tasks` skill with: `Update repos registry` → `Ensure .vibe\u002F scaffolding` → `Write hub repo CLAUDE.md` → `Refresh hub repo README` → `Refresh workspace CLAUDE.md`.\n\n## Step 4 — `repos.md`\n\nA sibling is a direct subdirectory of the workspace root whose `.git` is a directory, the hub excluded; nothing is scanned deeper (a repo nested in a sibling is that sibling's business) and folders without `.git` are ignored. Not siblings — named in the report, never registered: a directory whose `.git` is a file (a linked worktree, a second checkout of a repo registered elsewhere) and a bare repository (`something.git`, no working tree to work in).\n\n`repos.md` is never regenerated, only edited: a refresh adds rows in the columns the file already has (a hand-made registry may have its own), fills a Remote still `—` once the repo has an `origin`, and leaves every other cell, column and section — `## Naming convention` included — as it found them.\n\nAlready listed → keep `status` and `role` exactly as they are (never overwrite a human judgment). New sibling → `status: active` if it has `.vibe\u002Fbacklog\u002F`, otherwise `AskUserQuestion` for the status (`active` picked by `\u002Fvibe:next-task` \u002F `planned` no code yet \u002F `idea` no repo yet \u002F `archived` retired, kept for the record, never picked) and a one-line role — never guess the role. An `active` row whose directory is gone → report it and ask: mark it `archived` (the default — the row keeps what the workspace knew of it) or remove the row. A `planned`, `idea` or `archived` row needs no directory: never question it.\n\n```markdown\n# Repos registry\n\nMaintained by \u002Fvibe:workspace-init — re-run after adding, retiring, or renaming a repo.\n\n| Repo | Status | Role | Remote |\n|---|---|---|---|\n| api | active | REST backend, owns the `orders` domain | git@github.com:acme\u002Fapi.git |\n| sdk | planned | Shared TS client — not started | — |\n| legacy-portal | archived | Old customer portal, replaced by `api` | — |\n\n## Naming convention\n[the workspace's repo-naming pattern, or \"None documented yet.\"]\n```\n\nThen create `.vibe\u002Fbacklog\u002F` and `.vibe\u002Fdecisions\u002F` in the hub if absent, each with a `.gitkeep` while it is empty (git commits no empty directory, so a clone of the hub would lack them), never touching existing items or ADRs.\n\n## Step 5 — Hub repo `CLAUDE.md`\n\nWritten here, not by `vibe:init` (whose stack detection and DoD assume application code):\n\n```markdown\n# CLAUDE.md — [hub repo name] (workspace hub — no code)\n\n> Auto-generated by \u002Fvibe:workspace-init. Edit freely. Add `\u003C!-- keep -->` on a section heading to preserve it on regeneration.\n\n## Role\n\nThis repo holds no application code. It is the source of truth for cross-repo planning: [repos.md](repos.md) registers every sibling repo (status, role, remote); `.vibe\u002Fbacklog\u002F` and `.vibe\u002Fdecisions\u002F` hold Product Owner decisions and ADRs spanning more than one repo.\n\n[Vision paragraph: on a bootstrap, the Step 2 synthesis in the project's language; on a refresh, the paragraph standing here in the existing file, carried over unchanged — a refresh never drops it.]\n\n**Items here are never implementable work** — never picked up by `\u002Fvibe:feature`, `\u002Fvibe:fix`, or `\u002Fvibe:auto`. Run `\u002Fvibe:next-task` from the workspace root to pick and ship actual work in the right repo.\n\n## Backlog & decisions\n\nSame format as any vibe-managed repo, scoped to workspace-level concerns: which repo owns what, cross-repo sequencing, naming conventions. `\u002Fvibe:backlog` works here too. Managed by hand, never by an autonomous run.\n```\n\nThen invoke the `vibe:docs` skill (README skeleton or refresh) and the `vibe:sync` skill — a hub has little source; \"nothing to update\" is a normal outcome, noted in the report.\n\n## Step 6 — Workspace-root `CLAUDE.md`\n\nFull idempotent overwrite (with `\u003C!-- keep -->` support), never committed — the folder is not a repo and the file regenerates from `repos.md`:\n\n```markdown\n# CLAUDE.md — [workspace name] (workspace root — not a git repo)\n\n> Auto-generated by \u002Fvibe:workspace-init. Not version-controlled: local-only context. Add `\u003C!-- keep -->` on a section heading to preserve it.\n\n## Hub repo\n`[hub-dir]\u002F` — source of truth for cross-repo planning (`repos.md`, workspace-scope backlog\u002Fdecisions in `.vibe\u002F`). Its items are Product Owner decisions, never implementable work.\n\n## Sibling repos\n| Repo | Status | Role |\n|---|---|---|\n[mirrored from repos.md]\n\n## Cross-repo workflow\nRun `\u002Fvibe:next-task` from this directory to pick, implement, and ship the next eligible task across active repos.\n```\n\nThe `## Hub repo` line is the pointer Step 2 and `\u002Fvibe:next-task` read — keep the exact directory name in the backticks.\n\n## Step 7 — Commit and report\n\nIn the hub: stage everything this run wrote or changed — `repos.md`, `.vibe\u002F`, `CLAUDE.md`, `README.md`, and whatever `vibe:docs` and `vibe:sync` produced (`docs\u002F` included) — in one commit: `chore: bootstrap hub repo` on first init, `chore: refresh workspace registry` otherwise; nothing changed → say so. Report, short and plain: hub location (created \u002F existed); repos added, updated, flagged missing; files refreshed; commit or \"nothing to commit\"; a reminder to push the hub when convenient.\n",{"name":5,"model":23,"version":24,"description":7,"argument-hint":25},"claude-sonnet-5-5","1.1.0","[hub repo dir name, e.g. roadmap] (only used on first bootstrap)","main","0c226fd01e28e24c34766470e441e4efd4277884","skills\u002Fworkspace-init","https:\u002F\u002Fgithub.com\u002Fneolao\u002Fclaude-plugin-vibe","https:\u002F\u002Fgithub.com\u002Fneolao","https:\u002F\u002Fneolao.com","Fullstack developer","2026-11-13 00:19:16",{"source":8,"skillName":5,"commands":35,"prompt":45,"zipAvailable":46},[36,39,42],{"tool":37,"command":38},"npx","npx skills add neolao\u002Fclaude-plugin-vibe --skill workspace-init",{"tool":40,"command":41},"bunx","bunx skills add neolao\u002Fclaude-plugin-vibe --skill workspace-init",{"tool":43,"command":44},"pnpm","pnpm dlx skills add neolao\u002Fclaude-plugin-vibe --skill workspace-init","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fneolao\u002Fclaude-plugin-vibe\u002Fblob\u002Fmain\u002Fskills\u002Fworkspace-init\u002FSKILL.md",true,[],[49,56,63,70,76,83],{"skillNo":50,"name":51,"nameZh":6,"description":52,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":53,"categories":54,"keywords":55,"publishedAt":18},"01M787J00GMM26BJ88M38T1FE4","usage-report","Usage report of a vibe workflow: counts, while the work runs, the bricks called, the loop rounds, the findings, the questions asked to the user and the fixes, then writes these statistics to `.vibe\u002Fusage-reports\u002F` in the project at the end. Invoked by `vibe:feature` and `vibe:fix` through their shared workflow, at the start of the work and at the end. Never triggered by a user request.","https:\u002F\u002Fgithub.com\u002Fneolao\u002Fclaude-plugin-vibe\u002Fblob\u002Fmain\u002Fskills\u002Fusage-report\u002FSKILL.md",[],[],{"skillNo":57,"name":58,"nameZh":6,"description":59,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":60,"categories":61,"keywords":62,"publishedAt":18},"01M787HTE89T0KDRHRQJ06TFKS","tasks","Creates and tracks a vibe workflow's task list and keeps it up to date until the end — through the native task system (TaskCreate \u002F TaskUpdate \u002F TaskList \u002F TaskGet) when it is available, otherwise through a `tasks.tsv` file in the scratchpad, kept by a script that reproduces the same model (ids, statuses, blockedBy dependencies, owner). Invoked internally by other vibe skills, never directly by users.","https:\u002F\u002Fgithub.com\u002Fneolao\u002Fclaude-plugin-vibe\u002Fblob\u002Fmain\u002Fskills\u002Ftasks\u002FSKILL.md",[],[],{"skillNo":64,"name":65,"nameZh":6,"description":66,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":67,"categories":68,"keywords":69,"publishedAt":18},"01M787HQPZHQZT9CGPRT1QM3V7","sync","Sync .vibe\u002F — generate on first run, incrementally update on subsequent runs","https:\u002F\u002Fgithub.com\u002Fneolao\u002Fclaude-plugin-vibe\u002Fblob\u002Fmain\u002Fskills\u002Fsync\u002FSKILL.md",[],[],{"skillNo":71,"name":72,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":73,"categories":74,"keywords":75,"publishedAt":18},"01M787HP2484TER1ZEMM7HSVJV","rewrite","https:\u002F\u002Fgithub.com\u002Fneolao\u002Fclaude-plugin-vibe\u002Fblob\u002Fmain\u002Fskills\u002Frewrite\u002FSKILL.md",[],[],{"skillNo":77,"name":78,"nameZh":6,"description":79,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":80,"categories":81,"keywords":82,"publishedAt":18},"01M787HH252DZHDHJF70DYAQ7A","review","Runs the project's active review agents on a scope and returns their raw findings — one owner per dimension, the shared finding contract injected into every prompt — without judging, fixing or committing anything. Invoked by the build workflow (`vibe:feature`, `vibe:fix`) as its internal review step and by `vibe:audit`, never directly by users.","https:\u002F\u002Fgithub.com\u002Fneolao\u002Fclaude-plugin-vibe\u002Fblob\u002Fmain\u002Fskills\u002Freview\u002FSKILL.md",[],[],{"skillNo":84,"name":85,"nameZh":6,"description":86,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":87,"categories":88,"keywords":89,"publishedAt":18},"01M787HD4F6Y7ESC3PHJAJHK04","release","Create a versioned release — bump version, finalize CHANGELOG.md, commit and tag","https:\u002F\u002Fgithub.com\u002Fneolao\u002Fclaude-plugin-vibe\u002Fblob\u002Fmain\u002Fskills\u002Frelease\u002FSKILL.md",[],[]]