[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M77KC6YMCJDEE3MT53EMMHZN":3,"skill-same:01M77KC6YMCJDEE3MT53EMMHZN":44},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":14,"repositoryHtmlUrl":27,"repositoryHomepageUrl":6,"ownerHtmlUrl":28,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":29,"install":30,"resources":43},"01M77KC6YMCJDEE3MT53EMMHZN","repo-public-mirror-setup",null,"Bootstrap a filtered, read-only public mirror for the current private repo (paired public repo, deploy key, filter config, mailmap, workflow, read-only enforcement).","TheVoskamps\u002Fclaude-plugins-marketplace","TheVoskamps","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F235012489?v=4","01M77K5ZCP12QCJPQ85WVJSHTS","Irene and Edwin Voskamp","01M77K5ZDS7DB0PA1W8FM7G2QD",0,"GPL-3.0","https:\u002F\u002Fgithub.com\u002FTheVoskamps\u002Fclaude-plugins-marketplace\u002Fblob\u002Fmain\u002Fplugins\u002Fgithub-setup\u002Fskills\u002Frepo-public-mirror-setup\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: repo-public-mirror-setup\ndescription: \"Bootstrap a filtered, read-only public mirror for the current private repo (paired public repo, deploy key, filter config, mailmap, workflow, read-only enforcement).\"\n---\n\nYou are running the `\u002Frepo-public-mirror-setup` skill. Your job is to\nbootstrap a filtered, read-only public mirror for the **current\nprivate repo** (the repo `cd`-ed into when this skill was invoked).\nThe setup is multi-step and partly destructive: it creates a new\npublic GitHub repo, uploads a deploy key, and stores a repo secret.\nIt also writes (but does not commit) filter config and a workflow\nfile in the source repo.\n\nThe first instance of this pattern is issue #26 in\n`TheVoskamps\u002Fglobal-claude-config` (creating\n`TheVoskamps\u002Fglobal-claude-config-public`). This skill codifies\nthat pattern so it can be applied to other private repos without\nre-deriving the plumbing each time.\n\nFollow the steps below in order. There are three explicit **halts**\nwhere you wait for the user before proceeding. Do not skip them.\n\n## Template payload\n\nThe starter files this skill installs (the workflow, filter config,\nmirror `.gitignore`, `CONTRIBUTORS`, and the public-facing `LICENSE`,\n`PATENTS`, `PRIOR_ART.md`, and `README.md`)\nlive as templates under\n`${CLAUDE_PLUGIN_ROOT}\u002Fpayload\u002Frepo-public-mirror-setup\u002F`, following\nthe bundled-payload convention (see\n`${CLAUDE_PLUGIN_ROOT}\u002Fpayload\u002FREADME.md` for the placeholder\u002Frender\u002F\nexistence-check contract). The skill reads each template, substitutes\nthe placeholders below, and writes the rendered result into the source\nrepo. The skill does **not** carry the file bodies inline — it renders\nthem from the payload.\n\nPlaceholders used by this skill's templates:\n\n- `__GH_ORG__` — owner of the source repo. Inferred:\n  `gh repo view --json owner -q .owner.login`.\n- `__GH_REPO__` — source repo short name; also the\n  `__GH_REPO__-public` mirror name and the `__GH_REPO__.local`\n  mailmap domain. Inferred: `gh repo view --json name -q .name`.\n- `__GH_OWNER_NAME__` — human owner name in the `PATENTS` \u002F\n  `PRIOR_ART.md` prior-art notice. Prompted from the user.\n- `__RELEASE_DATE__` — public-release date in the `PATENTS` \u002F\n  `PRIOR_ART.md` prior-art notice. Prompted from the user.\n\nRender with simple string substitution (the\n`${CLAUDE_PLUGIN_ROOT}\u002Fpayload\u002FREADME.md` reference recipe), e.g. read a\ntemplate via the `Read` tool, replace each `__PLACEHOLDER__` with its\nresolved value, and write the result with `Write`. Never write a\nrendered file that still contains a `__...__` placeholder — if any\nremains after inference and prompting, abort per the\n`${CLAUDE_PLUGIN_ROOT}\u002Fpayload\u002FREADME.md` \"Resolving placeholder values\" rule.\n\n## Workflow-auth identity\n\nThis skill uses the **deploy-key** flow (Steps 15–16): a write-enabled\ndeploy key on the mirror plus the `PUBLIC_MIRROR_DEPLOY_KEY` secret on\nthe source. That flow is intact and is the supported path; this skill\ndoes **not** resolve a GitHub App identity via `skills\u002Flib\u002Fgh-app.md`.\nThe App resolver is only warranted if a future variant pushes via an\nApp rather than a deploy key — out of scope here.\n\n---\n\n## Inputs\n\n- **SSH key path** (required): path to the keypair the user\n  generated out-of-band with `ssh-keygen`. The agent cannot\n  generate SSH keypairs (blocked by `settings.json`), so the user\n  must produce the key first and pass the path in.\n\n  If the user did not provide a path when invoking the skill, ask\n  for one before doing anything else. The path may be absolute\n  (`\u002FUsers\u002F\u003Cname>\u002F.ssh\u002F\u003Crepo>-mirror`) or `~`-prefixed; expand `~`\n  to the user's home directory before checking the filesystem.\n\nEverything else is derived by convention (see Step 4).\n\n---\n\n## Step 0: Payload\n\nThe template payloads this skill renders ship with the plugin at\n`${CLAUDE_PLUGIN_ROOT}\u002Fpayload\u002Frepo-public-mirror-setup\u002F`. Treat that\ndirectory as `$PAYLOAD` for the rest of the skill. Every starter file\nthe skill writes is rendered from a template under `$PAYLOAD` — the\nskill does not carry those file bodies inline. The placeholder\u002Frender\nconvention is documented in `${CLAUDE_PLUGIN_ROOT}\u002Fpayload\u002FREADME.md`.\n\n## Step 1: Pre-flight — repo root and visibility\n\nVerify you are inside a git working tree:\n\n```bash\ngit rev-parse --show-toplevel\n```\n\nTreat the path printed by this command as the **repo root** for the\nrest of the skill. The skill operates on the source repo (the repo\nthe user invoked it from), not on `~\u002F.claude`. Do **not** assume\n`~\u002F.claude` or any other path.\n\nIf the command fails (non-zero exit, \"not a git repository\"), abort\nwith:\n\n> `\u002Frepo-public-mirror-setup` must be run from inside a git\n> repository. The current directory is not a git working tree.\n\nThen verify the source repo is **private**:\n\n```bash\ngh repo view --json visibility -q .visibility\n```\n\nIf the value is anything other than `PRIVATE`, abort with:\n\n> `\u002Frepo-public-mirror-setup` is only valid for private source\n> repos. The current repo's visibility is `\u003Cvalue>`. A public repo\n> doesn't need a filtered public mirror; if you want a different\n> kind of mirror, that's out of scope for this skill.\n\n## Step 2: Pre-flight — SSH key path\n\nResolve `~` in the SSH key path the user gave you, then verify both\nhalves exist:\n\n- `\u003Cpath>` (private half) must exist and be a regular file.\n- `\u003Cpath>.pub` (public half) must exist and be a regular file.\n\nIf either is missing, abort with a message naming the exact path\nthat was missing and reminding the user to generate the keypair\nwith `ssh-keygen`. Use the same `\u003Cshort>-public` suffix as the\nmirror repo so the key→repo mapping is obvious (e.g.\n`ssh-keygen -t ed25519 -C '\u003Cshort>-public'\n-f ~\u002F.ssh\u002F\u003Cshort>-public`). Do not offer to generate the key\nyourself — key generation is out of scope and blocked by\n`settings.json`.\n\nDo **not** print the private key contents to the conversation at\nany point in this skill. Pass it to `gh secret set` via stdin, not\nvia a shell argument.\n\n## Step 3: Pre-flight — local tooling\n\nVerify `git-filter-repo` is installed locally:\n\n```bash\ncommand -v git-filter-repo\n```\n\nIf it returns nothing (exit non-zero), abort with:\n\n> `git-filter-repo` is not installed. Install it with\n> `brew install git-filter-repo`, then re-run\n> `\u002Frepo-public-mirror-setup`.\n\nAlso verify `gh` is authenticated and has scope to create\nrepositories under the target org. A quick smoke test:\n\n```bash\ngh auth status\n```\n\nIf `gh` reports the user is not authenticated, abort and instruct\nthem to run `gh auth login` (with `repo` scope, plus\n`admin:public_key` so the deploy-key step in Step 15 works).\n\n## Step 4: Derive names and identifiers\n\nFrom the source repo, derive the conventional names:\n\n- **Source repo full name**: read with\n  `gh repo view --json nameWithOwner -q .nameWithOwner` (e.g.\n  `TheVoskamps\u002Fglobal-claude-config`).\n- **Source repo short name**: the part after the slash (e.g.\n  `global-claude-config`).\n- **Mirror repo full name**: `\u003Cowner>\u002F\u003Cshort>-public`.\n- **Mailmap domain**: `\u003Cshort>.local` (the `.local` TLD is\n  RFC-reserved and non-routable; embedding the source short name\n  makes the mirror's origin obvious to anyone reading the\n  rewritten emails).\n- **Secret name on source repo**: `PUBLIC_MIRROR_DEPLOY_KEY`\n  (constant; not per-repo).\n- **Deploy-key title on mirror repo**: `public-mirror-workflow`\n  (constant).\n\n## Step 5: Halt #1 — confirm derived values\n\nPresent the derived values to the user and ask for explicit\nconfirmation before doing anything that touches the filesystem or\nGitHub. Use this exact shape:\n\n```text\nAbout to set up a public mirror with the following derived values:\n\n  Source repo:    \u003Cowner>\u002F\u003Cshort>\n  Mirror repo:    \u003Cowner>\u002F\u003Cshort>-public        (will be CREATED public)\n  Mailmap domain: \u003Cshort>.local\n  Source secret:  PUBLIC_MIRROR_DEPLOY_KEY      (will be SET on source)\n  Deploy key:     public-mirror-workflow        (will be UPLOADED to mirror)\n  SSH key path:   \u003Cexpanded-path>\n\nProceed? (y to continue, or tell me what to change)\n```\n\nWait for explicit approval (`y`, `yes`, `go`, `do it`). If the user\nasks for a different mirror name, mailmap domain, or secret name,\nupdate the derived values and re-display this halt — do not\nproceed without confirmation.\n\nThe remaining steps perform real work. Do not skip this halt.\n\n## Step 6: Render `.github\u002Fpublic-mirror\u002F` config in the source repo\n\nCreate the directory `\u003Crepo-root>\u002F.github\u002Fpublic-mirror\u002F` if it does\nnot exist, then render the files below **from the payload**\n(`$PAYLOAD`, set in Step 0). Each is a template under\n`$PAYLOAD\u002F\u003Cfile>`; read it, substitute the placeholders, and write the\nresult to the target path. These files are **not** committed by the\nskill — the user reviews the diff and commits manually, per global\nrule §0 (\"never write\u002Fcommit without approval\").\n\n### `paths.allowlist`\n\nRender `$PAYLOAD\u002Fpaths.allowlist` (no placeholders) to\n`\u003Crepo-root>\u002F.github\u002Fpublic-mirror\u002Fpaths.allowlist` verbatim. It is the\nrequired-files starting set with an empty `--- repo-specific (add\nbelow) ---` section the user fills in at Halt #2. `CONTRIBUTORS` ships\nlike any other allowlisted path (a static tracked file in the source\nrepo — see below), and `.github\u002Fpublic-mirror\u002F` is not wholesale on the\nallowlist: only `gitignore.mirror` survives, renamed to root\n`.gitignore` by the rename directive at the bottom of the template.\nShipping both `CONTRIBUTORS` and the mirror `.gitignore` through\n`git-filter-repo` (rather than synthesizing them as commits on top of\nfilter-repo's output) is what keeps the mirror fast-forwarding on\nroutine runs instead of diverging and force-pushing.\n\n### `mailmap`\n\nRender `$PAYLOAD\u002Fmailmap` to\n`\u003Crepo-root>\u002F.github\u002Fpublic-mirror\u002Fmailmap`, substituting\n`__GH_REPO__` with the source short name, then **seed the author\nentries** from the source repo's unique authors:\n\n```bash\ngit log --format='%aN \u003C%aE>' | sort -u\n```\n\nFor each unique `Name \u003Clocal@domain>` line, append a mailmap entry that\npreserves the localpart and rewrites the domain to `\u003Cshort>.local`:\n\n```text\n\u003CName> \u003Clocal@\u003Cshort>.local> \u003Clocal@\u003Coriginal-domain>>\n```\n\nThe template provides only the comment header (with `__GH_REPO__`\nalready substituted). If `git log` returns zero authors (empty repo),\nwrite the header alone. Do not invent entries.\n\n### `CONTRIBUTORS` (static, at the source repo root)\n\nRender `$PAYLOAD\u002FCONTRIBUTORS.template` to `$REPO_ROOT\u002FCONTRIBUTORS`,\nsubstituting `__GH_REPO__` with the source short name. `CONTRIBUTORS`\nis a **static tracked file** at the source repo root; it ships to the\nmirror like any other allowlisted path and is NOT synthesized at\nruntime (an earlier design regenerated it as a commit stacked on top of\nfilter-repo's output, which sat outside filter-repo's persisted state\nand made every source-change run diverge from the previous mirror tip\nand force-push, breaking consumers' `git pull`). The source repo must\n**track** this file — if the source `.gitignore` ignores root-level\nfiles by default, add an explicit `!\u002FCONTRIBUTORS` un-ignore so it is\ncommitted and therefore ships.\n\n### `gitignore.mirror` (the mirror's root `.gitignore`)\n\nRender `$PAYLOAD\u002Fgitignore.mirror` (no placeholders) to\n`\u003Crepo-root>\u002F.github\u002Fpublic-mirror\u002Fgitignore.mirror`: the **static**\nroot `.gitignore` for the mirror. The rename directive in\n`paths.allowlist` selects it and renames it to repo-root `.gitignore`\non the mirror, so it ships inside `git-filter-repo`'s own commit — not\nas a synthesized post-filter commit.\n\nThe mirror needs its OWN `.gitignore` rather than the source repo's:\nthe source `.gitignore` un-ignores paths that exist privately but are\ndeliberately excluded from the mirror, so shipping it would leave a\nconsumer's `git status` referencing rules for paths absent from their\nclone. The template un-ignores exactly the required shipped set plus\nthe `.gitignore` itself. Keep it in sync **by hand** with\n`paths.allowlist`: when the user adds a repo-specific shipped path at\nHalt #2, add or remove the matching `!\u002F\u003Cpath>` line here (and a\nrecursive `!\u002F\u003Cdir>**` line for directories). It is part of the input\nfingerprint (see Step 7), so editing it correctly triggers a refilter.\n\n### `replacements.txt` (optional identifier scrubbing)\n\nRender `$PAYLOAD\u002Freplacements.txt` (no placeholders) to\n`\u003Crepo-root>\u002F.github\u002Fpublic-mirror\u002Freplacements.txt`. The template\nships with no concrete rules — redaction rules are inherently\nrepo-specific. A mirror with no sensitive identifiers in history may\nleave it rule-free; the allowlist filter is the primary fail-safe.\n\n## Step 7: Render `.github\u002Fworkflows\u002Fpublic-mirror.yml`\n\nCreate the workflow file. It triggers on `push` to `main` and on\n`workflow_dispatch` for manual reruns. Steps: checkout full\nhistory, install `git-filter-repo`, clone a fresh bare copy, fetch\nthe persisted `filter-repo-state` and `filter-repo-meta` branches\nfrom the mirror, fetch the mirror's `main` and `filter-repo-blobs`\ninto local anchor refs (so all target-side objects referenced in\n`target-marks` are present for incremental runs), run the filter\nwith `--paths-from-file`, `--mailmap`, `--replace-text`,\n`--replace-message`, `--state-branch`, `--prune-empty=never`, and\n`--refs refs\u002Fheads\u002Fmain` (with a fingerprint check that triggers a\nfull refilter when `paths.allowlist`, `mailmap`, `gitignore.mirror`,\nor the `replacements.txt` rule set changes), build a\nblob-anchor commit for unreachable replacement blobs, and push to the\nmirror's `main` (skipped when the new local tip already equals the\nmirror's current tip; force-pushed only on from-scratch refilters,\nfast-forwarded on incremental runs) plus the three bookkeeping\nbranches (always force-pushed). `CONTRIBUTORS` ships as a static\ntracked file and `gitignore.mirror` is renamed to root `.gitignore` —\nboth through `git-filter-repo` itself, so there are no post-filter\nsynth steps.\n\nRender the workflow from `$PAYLOAD\u002Fpublic-mirror.yml` to\n`\u003Crepo-root>\u002F.github\u002Fworkflows\u002Fpublic-mirror.yml`, substituting\n`__GH_ORG__` with the owner and `__GH_REPO__` with the source short\nname. Those two placeholders appear in the `MIRROR_URL` env of the\nfilter step (`git@github-mirror:__GH_ORG__\u002F__GH_REPO__-public.git`)\nand `__GH_REPO__` also in the bot identity\n(`public-mirror@__GH_REPO__.local`). After rendering, confirm no\n`__...__` placeholder remains in the written file.\n\nNotes on the template:\n\n- There are **no post-filter synth steps**. `CONTRIBUTORS` ships as a\n  static tracked file at the source repo root (on `paths.allowlist`),\n  and the mirror's root `.gitignore` is renamed in from\n  `gitignore.mirror` by the rename directive in `paths.allowlist`.\n  Both land inside `git-filter-repo`'s own commit. An earlier design\n  synthesized these two files as commits stacked on top of\n  filter-repo's output; those commits sat outside filter-repo's\n  `--state-branch` marks and made every source-change run diverge from\n  the previous mirror tip and force-push, breaking consumers'\n  `git pull`. Shipping both through filter-repo means nothing is\n  stacked on its output, so routine runs fast-forward.\n- The meta-index temp file lives under `${RUNNER_TEMP}` (the\n  GitHub-recommended runner temp dir). The bare clone\n  (`WORK=$(mktemp -d)`) and the blob-type scratch file\n  (`TYPES_FILE=$(mktemp)`) use the runner's system default temp dir,\n  which on GitHub-hosted runners already resolves under the runner's\n  workspace — neither writes to the repo tree.\n- The `user.email` bot identity (`public-mirror@__GH_REPO__.local`) and\n  the mirror remote URL \u002F `MIRROR_URL`\n  (`git@github-mirror:__GH_ORG__\u002F__GH_REPO__-public.git`) carry the\n  `__GH_REPO__` \u002F `__GH_ORG__` placeholders in the template; the render\n  step in Step 7 substitutes them. No hand-editing of the written file\n  is needed.\n- The bot git identity is set **once**, repo-locally, on the bare\n  clone (`git config user.name` \u002F `user.email` right after the\n  `cd \"$WORK\u002Fsrc.git\"`), and every commit-creating path inherits it:\n  the meta-branch commit, the blob-anchor commit, and filter-repo's\n  own internal `--state-branch` mark-saving commit\n  (`git_filter_repo.py`'s `git -C . commit-tree`, which carries no\n  identity flags). Do not re-decorate individual `commit-tree` calls\n  with inline `-c user.name=… -c user.email=…` — that per-commit\n  pattern structurally cannot cover filter-repo's internal commit and\n  reintroduces issue #147 (`fatal: empty ident name`). Local scope\n  (not `--global`) is deliberate: filter-repo runs `commit-tree` with\n  cwd inside the clone, so git reads identity from the clone's local\n  `config`, and nothing outside the clone needs the identity. The\n  `.local` email is intentionally unverifiable — the `mailmap` pass\n  rewrites these bookkeeping commits' identities anyway.\n- `concurrency: public-mirror` prevents overlapping force-pushes if\n  two pushes land on `main` close together.\n- `CONTRIBUTORS` is a static tracked file in the source repo, shipped\n  by filter-repo like any other allowlisted path. Refresh it by hand\n  (regenerate `git shortlog -sne` against the rewritten history,\n  excluding the mirror bot) when desired. Because it is a normally\n  tracked source file, editing it is a source commit handled by\n  filter-repo's normal incremental path — it is deliberately NOT in\n  the input fingerprint.\n- `gitignore.mirror` becomes the mirror's root `.gitignore` via the\n  rename directive in `paths.allowlist`. It un-ignores exactly the\n  shipped set plus the `.gitignore` itself (with a recursive\n  `!\u002F\u003Cdir>**` line for each shipped directory), so a user who clones\n  the mirror underneath `~\u002F.claude` gets a clean `git status`. It is\n  kept in sync with `paths.allowlist` BY HAND and is part of the input\n  fingerprint, so editing it triggers a refilter — without that, the\n  mirror's `.gitignore` could go silently stale relative to\n  `gitignore.mirror`.\n- The `Filter into a fresh bare clone with persisted marks` step\n  uses `git filter-repo --state-branch filter-repo-state` so the\n  fast-import marks (source-commit → public-commit SHA mapping)\n  persist between runs on a dedicated mirror branch. Unchanged\n  source commits keep their previously-computed public SHAs across\n  runs, which is what makes a consumer's `git pull` fast-forward\n  cleanly after a genuine source change instead of seeing the entire\n  public history rewritten. `--refs refs\u002Fheads\u002Fmain` scopes\n  fast-export to walk only the source branch, not the fetched\n  anchor\u002Fblob refs; without it, filter-repo's default `--all` would\n  walk every ref in the clone, including the anchor refs whose\n  commits are target-side. A sibling `filter-repo-meta` branch\n  holds a `inputs.sha256` fingerprint over `paths.allowlist`,\n  `mailmap`, `gitignore.mirror`, and the cleaned `replacements.txt`\n  rule set; on each run the live fingerprint\n  is compared to the stored one,\n  and a mismatch triggers a full refilter (which is logged with a\n  GitHub `::warning::` annotation so the operator notices). A third\n  `filter-repo-blobs` branch anchors unreachable replacement blobs\n  created by `--replace-text` so they survive between runs. The\n  three bookkeeping branches are pushed alongside `main` on every\n  run (the blob-anchor push is conditional on blobs existing in\n  target-marks).\n- `--prune-empty=never` is paired with `--state-branch` deliberately:\n  filter-repo's source warns that `--state-branch` does not work\n  well with empty-commit pruning. The trade-off is that source\n  commits which touch only excluded paths show up in the mirror as\n  empty commits with their original commit messages intact. For\n  this skill's use case (private repo → public mirror) leaking\n  both the timing AND the commit-message contents for changes\n  touching only excluded paths is acceptable; the excluded diff\n  payload itself stays excluded. Operators with commit messages\n  that themselves contain sensitive content should weigh this\n  carefully before adopting the skill.\n- The `Push to mirror` step compares the new local tip to the\n  mirror's current `refs\u002Fheads\u002Fmain` (`git ls-remote`) and skips the\n  `main` push when they match. Because nothing is stacked on\n  filter-repo's output, the local tip IS filter-repo's output —\n  together with `--state-branch` this makes both no-source-change runs\n  AND genuine-source-change runs (where new commits add to the public\n  tip without rewriting history below) consumer-friendly. When the\n  tips differ, the step\n  checks `REFILTER_REASON`: on a from-scratch refilter (non-empty\n  reason) it force-pushes main (history was rewritten); on an\n  incremental run (empty reason) it pushes without `--force` so\n  consumers see a clean fast-forward. Before either push, a\n  strict-ancestor safety guard fails the run fast if the local\n  `main` is a strict ancestor of the remote `main` (local is behind,\n  remote has commits local lacks) — pushing in that state would\n  regress the mirror, so the step refuses rather than emit git's\n  ambiguous non-fast-forward hint. The state, meta, and\n  blob-anchor branches are always pushed (force) so the next run\n  can read them back; when the fingerprint is unchanged the\n  meta-branch SHA is stable, and when the blob set is unchanged the\n  blob-anchor SHA is stable, so those pushes are true no-ops. The\n  blob-anchor push is conditional on the ref existing (it may not\n  exist on the first run or when target-marks contains no blobs).\n\n## Step 8: Halt #2 — user populates `paths.allowlist`\n\nTell the user that the three config files and the workflow now\nexist on disk (uncommitted), and that the **allowlist's\nrepo-specific section is empty**. The mirror will be nearly empty\non first run if the user does not add paths.\n\nSuggest a starting place: re-read the source repo's `.gitignore`\n(if it uses a whitelist style) or list the top-level entries with\n`ls -A` so the user can decide which directories belong in the\nmirror. Then ask:\n\n> Edit `.github\u002Fpublic-mirror\u002Fpaths.allowlist` now, adding any\n> repo-specific paths under the `--- repo-specific (add below) ---`\n> marker. Tell me when you're done.\n\nWait for explicit confirmation that the file is ready. Do not\nadvance to Step 9 until the user says so.\n\n## Step 9: Dry-run the filter locally\n\nIn a sandbox directory under `.claude\u002Ftmp\u002Frepo-public-mirror-setup\u002F`\n(per the `\u003Crepo-root>\u002F.claude\u002Ftmp\u002F` convention — never `\u002Ftmp\u002F`),\nrun the filter against a fresh bare clone of the source repo.\nPrint the resulting tree so the user can see exactly what would\nland in the mirror.\n\n```bash\n# Capture the absolute repo root BEFORE cd-ing, so the filter\n# config paths resolve correctly regardless of cwd depth.\nREPO_ROOT=\"$(git rev-parse --show-toplevel)\"\nmkdir -p \"$REPO_ROOT\u002F.claude\u002Ftmp\u002Frepo-public-mirror-setup\"\nWORK=\"$REPO_ROOT\u002F.claude\u002Ftmp\u002Frepo-public-mirror-setup\u002Fdryrun\"\nrm -rf \"$WORK\"\n# --no-local forces a real object copy instead of hardlinking into the\n# source repo's object store. git-filter-repo aborts on a clone whose\n# objects are hardlinked back to the original, so a plain --bare clone\n# (which hardlinks for a local path) would fail here.\ngit clone --no-local --bare \"$REPO_ROOT\" \"$WORK\"\n( cd \"$WORK\" \\\n  && git filter-repo \\\n       --paths-from-file \"$REPO_ROOT\u002F.github\u002Fpublic-mirror\u002Fpaths.allowlist\" \\\n       --mailmap \"$REPO_ROOT\u002F.github\u002Fpublic-mirror\u002Fmailmap\" \\\n  && git ls-tree -r --name-only HEAD | sort )\n```\n\nPrint the sorted list of file paths from `git ls-tree -r\n--name-only HEAD`. Group it by top-level directory for legibility\nif the list is long.\n\nIf `tree` is installed, an alternative second display is helpful:\n\n```bash\n( cd \"$WORK\" \\\n  && git archive --format=tar HEAD | tar -tf - | sort \\\n       | sed 's#[^\u002F]##g;s#\u002F#  #g' )\n```\n\nEither form is fine — the point is the user can audit the contents\nbefore any remote push.\n\nCleanup of the sandbox is deferred to after Step 16 succeeds, so\nthe user can re-run the listing if they want.\n\n## Step 10: Halt #3 — user confirms the dry-run tree\n\nAsk explicitly:\n\n> Does this look right? Check for two things:\n>\n> 1. No leaked sensitive paths (anything you don't want published).\n> 2. All expected paths present (every file the mirror needs).\n>\n> Reply `y` to proceed with creating the mirror repo, or tell me\n> what to change in the allowlist.\n\nWait for explicit `y`\u002F`yes`\u002F`go`. If the user asks for changes,\nloop back to Step 8 — they edit the allowlist, you re-run the\ndry-run, you re-display the tree, you ask again.\n\nAfter this halt the skill proceeds through repo creation, deploy\nkey, and secret upload **without further halts** — those are the\nplumbing steps that are safe once the tree has been approved.\n\n## Step 11: Create the mirror repo\n\n```bash\nDESC=\"Read-only public mirror of \u003Cowner>\u002F\u003Cshort> (private).\"\ngh repo create \u003Cowner>\u002F\u003Cshort>-public \\\n  --public \\\n  --description \"$DESC\" \\\n  --disable-wiki\n```\n\nOnly `--disable-wiki` is passed at creation time. **Issues stay\nON** — this mirror's posture is `issues-allowed`: external users\nmay report problems on the mirror, which we triage and fix in the\nupstream private repo. Do **not** pass `--disable-issues`. `gh repo\ncreate` does not have a `--disable-discussions` flag, so Discussions\nare handled in Step 13.\n\nThen set merge methods and the merge-cleanup flag with `gh repo\nedit`. The mirror's gold-standard posture is **merge-commit on,\nsquash off, rebase off**, with `deleteBranchOnMerge=true`:\n\n```bash\ngh repo edit \u003Cowner>\u002F\u003Cshort>-public \\\n  --enable-merge-commit \\\n  --enable-squash-merge=false \\\n  --enable-rebase-merge=false \\\n  --delete-branch-on-merge\n```\n\nNote: PRs are **not** blocked by disabling merge methods — the\nmirror keeps merge-commit ON. PR-blocking comes from the\n`mirror-main-readonly` ruleset's `update` rule applied in Step 14.\nThe merge-method setting here just mirrors the live gold-standard\nrepo's configuration; it is not the PR guard.\n\nIf the repo already exists, abort with a clear message rather than\noverwriting. This skill is for green-field setup — migration of an\nexisting public mirror to this pattern is out of scope.\n\n## Step 12: Push the initial commit to establish `main`\n\nCreate the bootstrap content locally in\n`.claude\u002Ftmp\u002Frepo-public-mirror-setup\u002Fbootstrap\u002F` and push it as\nthe first commit on the mirror's `main`. This establishes `main`\nso the read-only ruleset in Step 14 can apply. The workflow will\noverwrite this commit's history on the first real filter run; the\npurpose here is purely to create a default branch.\n\nFiles in the bootstrap commit:\n\n- `README.md` — read-only banner (rendered from `$PAYLOAD\u002FREADME.md`).\n  The banner welcomes issues and states PRs are not accepted; it\n  carries **no link to the private upstream repo**.\n- `LICENSE`, `PATENTS`, `PRIOR_ART.md`, `CODEOWNERS`, `CONTRIBUTORS`:\n  the source repo's own copy if it exists; otherwise the payload\n  starter (`$PAYLOAD\u002FLICENSE`, `$PAYLOAD\u002FPATENTS`,\n  `$PAYLOAD\u002FPRIOR_ART.md`). `CODEOWNERS` has no payload starter — copy\n  it only if the source has it. `CONTRIBUTORS` was rendered to\n  `$REPO_ROOT\u002FCONTRIBUTORS` in Step 6; copy that.\n- The mirror's root `.gitignore` from\n  `.github\u002Fpublic-mirror\u002Fgitignore.mirror` (copied to `$BOOT\u002F.gitignore`).\n  Do NOT copy the source repo's own root `.gitignore` — the mirror\n  ships `gitignore.mirror` instead, and the first real workflow run\n  will produce the same `.gitignore` via the rename directive.\n\nThe `README.md` payload starter carries the read-only banner; render\n`$PAYLOAD\u002FREADME.md` (substitute `__GH_REPO__`). The banner welcomes\nissues and states PRs are not accepted, with no upstream link.\n\nThe `PATENTS` and `PRIOR_ART.md` payload starters carry the\n`__GH_OWNER_NAME__` and `__RELEASE_DATE__` placeholders. These are\n**only** needed when the source repo lacks its own copy of those files.\nIf a starter is needed, prompt the user for the owner name and the\npublic-release date before rendering, per the\n`${CLAUDE_PLUGIN_ROOT}\u002Fpayload\u002FREADME.md` \"Resolving placeholder values\"\nrule (these two cannot be inferred). If the source already has the\nfile, copy it verbatim and skip the prompt.\n\nPush sequence (run from the source repo root):\n\n```bash\nREPO_ROOT=\"$(git rev-parse --show-toplevel)\"\nBOOT=\"$REPO_ROOT\u002F.claude\u002Ftmp\u002Frepo-public-mirror-setup\u002Fbootstrap\"\nmkdir -p \"$BOOT\"\ncd \"$BOOT\"\ngit init -b main\n```\n\nThen populate the bootstrap directory as explicit, separate\nactions (do not bundle into a comment):\n\n1. Render `$PAYLOAD\u002FREADME.md` (substitute `__GH_REPO__`) to\n   `$BOOT\u002FREADME.md`.\n2. For each of `LICENSE`, `PATENTS`, `PRIOR_ART.md`, `CODEOWNERS`,\n   `CONTRIBUTORS`: if the file exists at `$REPO_ROOT\u002F\u003Cname>`, copy it\n   to `$BOOT\u002F\u003Cname>`. Otherwise, for `LICENSE` \u002F `PATENTS` \u002F\n   `PRIOR_ART.md`, render the payload starter\n   (`$PAYLOAD\u002F\u003Cname>` — `PATENTS` and `PRIOR_ART.md` need the\n   `__GH_OWNER_NAME__` \u002F `__RELEASE_DATE__` prompt above) to\n   `$BOOT\u002F\u003Cname>`. `CODEOWNERS` has no starter; skip silently when\n   absent. `CONTRIBUTORS` always exists (rendered in Step 6).\n3. Copy `$REPO_ROOT\u002F.github\u002Fpublic-mirror\u002Fgitignore.mirror` to\n   `$BOOT\u002F.gitignore` (the mirror's root `.gitignore`). Do NOT copy\n   the source repo's own `$REPO_ROOT\u002F.gitignore`.\n\nThen commit and push:\n\n```bash\ngit add .\ngit -c user.name='public-mirror-setup' \\\n    -c user.email='public-mirror-setup@\u003Cshort>.local' \\\n    commit -m 'Bootstrap mirror; real history follows from workflow'\ngit remote add origin git@github.com:\u003Cowner>\u002F\u003Cshort>-public.git\ngit push -u origin main\n```\n\nThis commit will be replaced on the first real workflow run. Its\nonly purpose is to give `main` a SHA so the read-only ruleset can\nattach to it.\n\n## Step 13: Set Issues \u002F Discussions \u002F Wiki \u002F Projects on the mirror\n\n```bash\ngh repo edit \u003Cowner>\u002F\u003Cshort>-public \\\n  --enable-issues=true \\\n  --enable-discussions=false \\\n  --enable-wiki=false \\\n  --enable-projects=false\n```\n\n**Issues stay ON** (`--enable-issues=true`) — this is the\ngold-standard `issues-allowed` posture: external users report\nproblems on the mirror, which we triage and fix upstream. Wiki,\nDiscussions, and Projects are off. `--enable-wiki=false` is\nredundant with the `--disable-wiki` passed at create time, but\nstating it here keeps the intent explicit and makes this step\nself-contained if re-run.\n\n## Step 14: Create the `mirror-main-readonly` ruleset on the mirror\n\nApply a **repository ruleset** (not legacy branch protection) that\nmakes `main` read-only to everyone except repo admins. This is the\nPR-and-push guard: the ruleset's `update` rule is what blocks PRs\nand direct pushes, while the admin bypass is what still lets the\nworkflow force-push. PR-blocking does **NOT** come from disabling\nmerge methods (the mirror keeps merge-commit on — see Step 11).\n\nDo **not** create legacy branch protection\n(`\u002Fbranches\u002Fmain\u002Fprotection`); the live gold-standard mirror has\nnone (that REST endpoint returns 404 there — it was superseded by\nthis ruleset). Use `gh api` to POST the ruleset:\n\n```bash\ngh api \\\n  --method POST \\\n  -H 'Accept: application\u002Fvnd.github+json' \\\n  \u002Frepos\u002F\u003Cowner>\u002F\u003Cshort>-public\u002Frulesets \\\n  --input - \u003C\u003C'JSON'\n{\n  \"name\": \"mirror-main-readonly\",\n  \"target\": \"branch\",\n  \"enforcement\": \"active\",\n  \"conditions\": {\n    \"ref_name\": {\n      \"include\": [\"~DEFAULT_BRANCH\"],\n      \"exclude\": []\n    }\n  },\n  \"rules\": [\n    { \"type\": \"deletion\" },\n    { \"type\": \"non_fast_forward\" },\n    { \"type\": \"update\" }\n  ],\n  \"bypass_actors\": [\n    {\n      \"actor_type\": \"RepositoryRole\",\n      \"actor_id\": 5,\n      \"bypass_mode\": \"always\"\n    }\n  ]\n}\nJSON\n```\n\nNotes:\n\n- **`actor_id: 5` is the built-in `admin` RepositoryRole.** The\n  bypass is the **admin role**, not a per-deploy-key bypass,\n  because deploy keys cannot be named as ruleset bypass actors —\n  ruleset `bypass_actors` accept org teams, GitHub Apps, and the\n  built-in RepositoryRole IDs (1 maintain, 2 write, 4 triage, 5\n  admin, etc.), but not deploy keys. A deploy key authenticates as\n  the repository itself and inherits **admin-equivalent** write\n  access to the repo it is attached to, so it lands inside the\n  admin bypass and can force-push `main`. Granting the bypass to\n  the admin role (rather than, say, the write role) keeps the set\n  of identities that can push `main` as small as possible: repo\n  admins and the workflow's deploy key, nobody else.\n- **The three rules together** make `main` read-only for non-admins:\n  `update` blocks ref updates (this is what rejects PRs and direct\n  pushes), `non_fast_forward` blocks force-pushes, and `deletion`\n  blocks branch deletion. The admin bypass (`bypass_mode: always`)\n  lets the workflow's deploy key do all three when it needs to —\n  the workflow force-pushes `main` on the first run and on any\n  filter-input change, and always force-pushes the bookkeeping\n  branches (`filter-repo-state`, `filter-repo-meta`,\n  `filter-repo-blobs`). The ruleset only targets `~DEFAULT_BRANCH`\n  (`main`), so the bookkeeping branches are unrestricted regardless.\n- **`~DEFAULT_BRANCH`** is the ref-name macro for the repo's default\n  branch; using it (rather than a literal `refs\u002Fheads\u002Fmain`) keeps\n  the ruleset correct if the default branch is ever renamed.\n- Admins are intentionally **not** locked out — leaving the admin\n  RepositoryRole in `bypass_actors` means a human admin can\n  intervene if the workflow gets stuck, the same rationale as the\n  old `enforce_admins: false` posture.\n- If the target org enforces stricter org-level rulesets, this POST\n  may conflict or be rejected. In that case surface the error to\n  the user and stop — the user resolves the conflict at the org\n  level, then asks the skill to retry.\n\n## Step 15: Upload the public half as a deploy key on the mirror\n\n```bash\ngh repo deploy-key add \u003Cexpanded-path>.pub \\\n  --repo \u003Cowner>\u002F\u003Cshort>-public \\\n  --title public-mirror-workflow \\\n  --allow-write\n```\n\n`--allow-write` is required because the workflow force-pushes to\nthe mirror.\n\n## Step 16: Store the private half as a secret on the source repo\n\nRead the private-key file and pipe it to `gh secret set`. Do not\nexpand the contents into the conversation or into shell argv.\n\n```bash\ngh secret set PUBLIC_MIRROR_DEPLOY_KEY \\\n  --repo \u003Cowner>\u002F\u003Cshort> \\\n  \u003C \"\u003Cexpanded-path>\"\n```\n\nThe redirect target is quoted so paths containing spaces (e.g.\n`\u002FUsers\u002FAlice Smith\u002F.ssh\u002Frepo-mirror`) work correctly.\n\nThe secret name `PUBLIC_MIRROR_DEPLOY_KEY` matches the\n`${{ secrets.PUBLIC_MIRROR_DEPLOY_KEY }}` reference in the\nworkflow written in Step 7.\n\n## Step 17: Print the next-steps checklist\n\nPrint this checklist to the user. The skill does **not** commit\nthe source-repo files — the user reviews and commits manually\n(global rule §0).\n\n```text\nPublic mirror bootstrap complete.\n\nCreated on GitHub:\n  - \u003Cowner>\u002F\u003Cshort>-public (public, Issues ON; Wiki\u002FProjects\u002F\n    Discussions off; merge-commit only, delete-branch-on-merge on)\n  - Ruleset mirror-main-readonly on main (deletion +\n    non_fast_forward + update; admin RepositoryRole bypass, so the\n    workflow's deploy key can still force-push)\n  - Deploy key: public-mirror-workflow (write-enabled)\n  - Source secret: PUBLIC_MIRROR_DEPLOY_KEY\n\nUncommitted in this repo (review and commit when ready):\n  - .github\u002Fpublic-mirror\u002Fpaths.allowlist\n  - .github\u002Fpublic-mirror\u002Fmailmap\n  - .github\u002Fpublic-mirror\u002Fgitignore.mirror\n  - .github\u002Fpublic-mirror\u002Freplacements.txt\n  - CONTRIBUTORS\n  - .github\u002Fworkflows\u002Fpublic-mirror.yml\n\nNext steps:\n  1. Review the diff:    git diff --stat .github\u002F\n  2. Commit and push:    triggers the first real workflow run.\n  3. Watch the run:      gh run watch (on push to main)\n  4. Verify the mirror:  the contents on\n     \u003Cowner>\u002F\u003Cshort>-public should match the dry-run tree.\n     The first run logs a `::warning::Refiltering from scratch:\n     first run (no state branch on mirror)` annotation; this is\n     expected. The state, meta, and blob-anchor branches\n     (`filter-repo-state`, `filter-repo-meta`,\n     `filter-repo-blobs`) appear on the mirror after this run;\n     subsequent runs reuse them.\n  5. Verify no-op runs:  re-trigger the workflow via\n     `gh workflow run public-mirror.yml --ref main` with no\n     intervening source changes. The `Push to mirror`\n     step should log `Mirror refs\u002Fheads\u002Fmain already at\n     \u003Csha>; nothing to push to main.` and a consumer clone's\n     `git pull` should report `Already up to date.`\n  6. Verify source-change runs are fast-forward:  land one new\n     commit on the source's `main`, watch the workflow, then on\n     the consumer clone run `git pull`. It should fast-forward\n     by exactly one commit (the new tip), NOT report a forced\n     update. The previous public history's SHAs are unchanged\n     because `--state-branch` reused them.\n\nWhen you later edit the filter config (paths.allowlist, mailmap, or\ngitignore.mirror), the next workflow run detects the input change via\nthe fingerprint stored on filter-repo-meta, logs a warning\n\"Refiltering from scratch: filter inputs changed\", and\nforce-pushes a rebuilt main. Tell consumers of the mirror to do\na one-time `git fetch && git reset --hard origin\u002Fmain` after a\nconfig-change run. (Editing the static CONTRIBUTORS file is NOT a\nconfig change — it is a normal source commit that the incremental\npath fast-forwards.)\n\nIf the first real workflow run fails, common causes:\n  - paths.allowlist references a path that doesn't exist in\n    history (filter-repo treats this as fatal — fix the path\n    or drop the entry)\n  - mailmap has malformed entries (filter-repo logs the bad line)\n  - deploy key lacks write scope (re-run gh repo deploy-key add\n    with --allow-write); the deploy key also needs write scope\n    to push the filter-repo-state, filter-repo-meta, and\n    filter-repo-blobs bookkeeping branches alongside main.\n```\n\nThen clean up the sandbox if the run succeeded:\n\n```bash\nrm -rf .claude\u002Ftmp\u002Frepo-public-mirror-setup\n```\n\nLeave the sandbox in place if any step from 11 onward failed, so\nthe user can inspect it.\n\n---\n\n## Halts and approval gates (summary)\n\nThe skill **must** halt and wait for explicit user confirmation at:\n\n- **Halt #1 (Step 5)** — derived values (mirror name, mailmap\n  domain, secret name, deploy-key title).\n- **Halt #2 (Step 8)** — user populates `paths.allowlist` with\n  repo-specific paths.\n- **Halt #3 (Step 10)** — dry-run tree review before any\n  destructive remote action.\n\nAfter Halt #3, Steps 11–16 run without further halts — those are\nthe plumbing steps that are safe once the tree has been approved.\n\n---\n\n## Hard constraints\n\n- **Never run before all pre-flight checks (Steps 0–3) pass.**\n  Each abort message must name the exact thing that failed and\n  what the user should do about it. Step 0 aborts with the standard\n  `${CLAUDE_PLUGIN_ROOT}\u002Fpayload\u002FREADME.md` existence-check message if the\n  payload directory is missing.\n- **Never write or commit the source-repo files for the user.**\n  Step 6 and Step 7 create the files on disk uncommitted; the user\n  reviews the diff and commits manually. (Global rule §0: never\n  commit without approval.)\n- **Never edit anything outside the source repo.** The skill\n  writes files under `\u003Crepo-root>\u002F.github\u002Fpublic-mirror\u002F`,\n  `\u003Crepo-root>\u002F.github\u002Fworkflows\u002F`, and\n  `\u003Crepo-root>\u002F.claude\u002Ftmp\u002Frepo-public-mirror-setup\u002F`. It **reads**\n  templates from\n  `${CLAUDE_PLUGIN_ROOT}\u002Fpayload\u002Frepo-public-mirror-setup\u002F`\n  (read-only — never written to). Nothing outside the source repo\n  gets touched on disk; the only remote changes are on the\n  newly-created mirror and the `PUBLIC_MIRROR_DEPLOY_KEY` secret on\n  the source.\n- **Never skip a halt.** All three halts (Steps 5, 8, 10) are\n  required. A \"looks fine, proceeding\" response without explicit\n  user confirmation is not approval.\n- **Never print private key material to the conversation.** Pipe\n  the private key file directly into `gh secret set` via stdin.\n  The `gh secret set ... \u003C \u003Cpath>` form is required.\n- **Never run on a public source repo.** Step 1 aborts if the\n  source visibility is anything other than `PRIVATE`.\n- **Never proceed if `git-filter-repo` is missing.** Step 3 aborts\n  with the install command. Do not attempt to install it yourself\n  — the user runs `brew install git-filter-repo`.\n- **All scratch work done by the skill on the user's machine goes\n  under `.claude\u002Ftmp\u002F...`** in the source repo, never `\u002Ftmp\u002F`,\n  never the user's home directory, never a path outside the repo.\n  Clean up on success; leave in place on failure. (This constraint\n  applies to the **skill**. The generated workflow runs on\n  GitHub-hosted Actions runners, a separate execution context with\n  its own conventions — there the meta-index uses `${RUNNER_TEMP}`,\n  the GitHub-recommended runner temp dir, while the bare clone and\n  blob-type scratch file use the runner's default temp dir. Neither\n  writes to the repo tree.)\n- **Keep Issues ON on the mirror** (`issues-allowed` posture).\n  Pass only `--disable-wiki` at create time (Step 11); do **not**\n  pass `--disable-issues`. Discussions and Projects are turned off\n  via the follow-up `gh repo edit` in Step 13 because `gh repo\n  create` does not expose `--disable-discussions` \u002F a Projects\n  flag.\n- **Block PRs via the `mirror-main-readonly` ruleset, not by\n  disabling merge methods.** Step 11 keeps merge-commit ON to match\n  the live gold-standard mirror; Step 14's ruleset `update` rule is\n  the actual PR-and-push guard. Do **not** create legacy branch\n  protection on the mirror.\n\n---\n\n## Out of scope\n\n- **SSH keypair generation.** Blocked by `settings.json`. The user\n  generates the key out-of-band and passes the path in.\n- **The first real filtered push.** The skill establishes `main`\n  with a bootstrap commit (Step 12) so the read-only ruleset can\n  apply, but the first filtered history push only happens when the\n  user commits the source-repo files (Steps 6–7) and pushes,\n  triggering the workflow.\n- **Repo-specific allowlist contents** beyond the required-files\n  starting set. The user fills these in at Halt #2.\n- **Migration of an existing public mirror to this pattern.** This\n  skill is for green-field setup only. If `\u003Cowner>\u002F\u003Cshort>-public`\n  already exists, Step 11 aborts.\n- **Auditing the contents of the source repo for sensitive data\n  before publishing.** The allowlist-only filter is fail-safe for\n  *new* files added later, but the user is responsible for\n  reviewing the dry-run tree at Halt #3 to confirm nothing\n  currently in history leaks.\n","You are running the `\u002Frepo-public-mirror-setup` skill. Your job is to\nbootstrap a filtered, read-only public mirror for the **current\nprivate repo** (the repo `cd`-ed into when this skill was invoked).\nThe setup is multi-step and partly destructive: it creates a new\npublic GitHub repo, uploads a deploy key, and stores a repo secret.\nIt also writes (but does not commit) filter config and a workflow\nfile in the source repo.\n\nThe first instance of this pattern is issue #26 in\n`TheVoskamps\u002Fglobal-claude-config` (creating\n`TheVoskamps\u002Fglobal-claude-config-public`). This skill codifies\nthat pattern so it can be applied to other private repos without\nre-deriving the plumbing each time.\n\nFollow the steps below in order. There are three explicit **halts**\nwhere you wait for the user before proceeding. Do not skip them.\n\n## Template payload\n\nThe starter files this skill installs (the workflow, filter config,\nmirror `.gitignore`, `CONTRIBUTORS`, and the public-facing `LICENSE`,\n`PATENTS`, `PRIOR_ART.md`, and `README.md`)\nlive as templates under\n`${CLAUDE_PLUGIN_ROOT}\u002Fpayload\u002Frepo-public-mirror-setup\u002F`, following\nthe bundled-payload convention (see\n`${CLAUDE_PLUGIN_ROOT}\u002Fpayload\u002FREADME.md` for the placeholder\u002Frender\u002F\nexistence-check contract). The skill reads each template, substitutes\nthe placeholders below, and writes the rendered result into the source\nrepo. The skill does **not** carry the file bodies inline — it renders\nthem from the payload.\n\nPlaceholders used by this skill's templates:\n\n- `__GH_ORG__` — owner of the source repo. Inferred:\n  `gh repo view --json owner -q .owner.login`.\n- `__GH_REPO__` — source repo short name; also the\n  `__GH_REPO__-public` mirror name and the `__GH_REPO__.local`\n  mailmap domain. Inferred: `gh repo view --json name -q .name`.\n- `__GH_OWNER_NAME__` — human owner name in the `PATENTS` \u002F\n  `PRIOR_ART.md` prior-art notice. Prompted from the user.\n- `__RELEASE_DATE__` — public-release date in the `PATENTS` \u002F\n  `PRIOR_ART.md` prior-art notice. Prompted from the user.\n\nRender with simple string substitution (the\n`${CLAUDE_PLUGIN_ROOT}\u002Fpayload\u002FREADME.md` reference recipe), e.g. read a\ntemplate via the `Read` tool, replace each `__PLACEHOLDER__` with its\nresolved value, and write the result with `Write`. Never write a\nrendered file that still contains a `__...__` placeholder — if any\nremains after inference and prompting, abort per the\n`${CLAUDE_PLUGIN_ROOT}\u002Fpayload\u002FREADME.md` \"Resolving placeholder values\" rule.\n\n## Workflow-auth identity\n\nThis skill uses the **deploy-key** flow (Steps 15–16): a write-enabled\ndeploy key on the mirror plus the `PUBLIC_MIRROR_DEPLOY_KEY` secret on\nthe source. That flow is intact and is the supported path; this skill\ndoes **not** resolve a GitHub App identity via `skills\u002Flib\u002Fgh-app.md`.\nThe App resolver is only warranted if a future variant pushes via an\nApp rather than a deploy key — out of scope here.\n\n---\n\n## Inputs\n\n- **SSH key path** (required): path to the keypair the user\n  generated out-of-band with `ssh-keygen`. The agent cannot\n  generate SSH keypairs (blocked by `settings.json`), so the user\n  must produce the key first and pass the path in.\n\n  If the user did not provide a path when invoking the skill, ask\n  for one before doing anything else. The path may be absolute\n  (`\u002FUsers\u002F\u003Cname>\u002F.ssh\u002F\u003Crepo>-mirror`) or `~`-prefixed; expand `~`\n  to the user's home directory before checking the filesystem.\n\nEverything else is derived by convention (see Step 4).\n\n---\n\n## Step 0: Payload\n\nThe template payloads this skill renders ship with the plugin at\n`${CLAUDE_PLUGIN_ROOT}\u002Fpayload\u002Frepo-public-mirror-setup\u002F`. Treat that\ndirectory as `$PAYLOAD` for the rest of the skill. Every starter file\nthe skill writes is rendered from a template under `$PAYLOAD` — the\nskill does not carry those file bodies inline. The placeholder\u002Frender\nconvention is documented in `${CLAUDE_PLUGIN_ROOT}\u002Fpayload\u002FREADME.md`.\n\n## Step 1: Pre-flight — repo root and visibility\n\nVerify you are inside a git working tree:\n\n```bash\ngit rev-parse --show-toplevel\n```\n\nTreat the path printed by this command as the **repo root** for the\nrest of the skill. The skill operates on the source repo (the repo\nthe user invoked it from), not on `~\u002F.claude`. Do **not** assume\n`~\u002F.claude` or any other path.\n\nIf the command fails (non-zero exit, \"not a git repository\"), abort\nwith:\n\n> `\u002Frepo-public-mirror-setup` must be run from inside a git\n> repository. The current directory is not a git working tree.\n\nThen verify the source repo is **private**:\n\n```bash\ngh repo view --json visibility -q .visibility\n```\n\nIf the value is anything other than `PRIVATE`, abort with:\n\n> `\u002Frepo-public-mirror-setup` is only valid for private source\n> repos. The current repo's visibility is `\u003Cvalue>`. A public repo\n> doesn't need a filtered public mirror; if you want a different\n> kind of mirror, that's out of scope for this skill.\n\n## Step 2: Pre-flight — SSH key path\n\nResolve `~` in the SSH key path the user gave you, then verify both\nhalves exist:\n\n- `\u003Cpath>` (private half) must exist and be a regular file.\n- `\u003Cpath>.pub` (public half) must exist and be a regular file.\n\nIf either is missing, abort with a message naming the exact path\nthat was missing and reminding the user to generate the keypair\nwith `ssh-keygen`. Use the same `\u003Cshort>-public` suffix as the\nmirror repo so the key→repo mapping is obvious (e.g.\n`ssh-keygen -t ed25519 -C '\u003Cshort>-public'\n-f ~\u002F.ssh\u002F\u003Cshort>-public`). Do not offer to generate the key\nyourself — key generation is out of scope and blocked by\n`settings.json`.\n\nDo **not** print the private key contents to the conversation at\nany point in this skill. Pass it to `gh secret set` via stdin, not\nvia a shell argument.\n\n## Step 3: Pre-flight — local tooling\n\nVerify `git-filter-repo` is installed locally:\n\n```bash\ncommand -v git-filter-repo\n```\n\nIf it returns nothing (exit non-zero), abort with:\n\n> `git-filter-repo` is not installed. Install it with\n> `brew install git-filter-repo`, then re-run\n> `\u002Frepo-public-mirror-setup`.\n\nAlso verify `gh` is authenticated and has scope to create\nrepositories under the target org. A quick smoke test:\n\n```bash\ngh auth status\n```\n\nIf `gh` reports the user is not authenticated, abort and instruct\nthem to run `gh auth login` (with `repo` scope, plus\n`admin:public_key` so the deploy-key step in Step 15 works).\n\n## Step 4: Derive names and identifiers\n\nFrom the source repo, derive the conventional names:\n\n- **Source repo full name**: read with\n  `gh repo view --json nameWithOwner -q .nameWithOwner` (e.g.\n  `TheVoskamps\u002Fglobal-claude-config`).\n- **Source repo short name**: the part after the slash (e.g.\n  `global-claude-config`).\n- **Mirror repo full name**: `\u003Cowner>\u002F\u003Cshort>-public`.\n- **Mailmap domain**: `\u003Cshort>.local` (the `.local` TLD is\n  RFC-reserved and non-routable; embedding the source short name\n  makes the mirror's origin obvious to anyone reading the\n  rewritten emails).\n- **Secret name on source repo**: `PUBLIC_MIRROR_DEPLOY_KEY`\n  (constant; not per-repo).\n- **Deploy-key title on mirror repo**: `public-mirror-workflow`\n  (constant).\n\n## Step 5: Halt #1 — confirm derived values\n\nPresent the derived values to the user and ask for explicit\nconfirmation before doing anything that touches the filesystem or\nGitHub. Use this exact shape:\n\n```text\nAbout to set up a public mirror with the following derived values:\n\n  Source repo:    \u003Cowner>\u002F\u003Cshort>\n  Mirror repo:    \u003Cowner>\u002F\u003Cshort>-public        (will be CREATED public)\n  Mailmap domain: \u003Cshort>.local\n  Source secret:  PUBLIC_MIRROR_DEPLOY_KEY      (will be SET on source)\n  Deploy key:     public-mirror-workflow        (will be UPLOADED to mirror)\n  SSH key path:   \u003Cexpanded-path>\n\nProceed? (y to continue, or tell me what to change)\n```\n\nWait for explicit approval (`y`, `yes`, `go`, `do it`). If the user\nasks for a different mirror name, mailmap domain, or secret name,\nupdate the derived values and re-display this halt — do not\nproceed without confirmation.\n\nThe remaining steps perform real work. Do not skip this halt.\n\n## Step 6: Render `.github\u002Fpublic-mirror\u002F` config in the source repo\n\nCreate the directory `\u003Crepo-root>\u002F.github\u002Fpublic-mirror\u002F` if it does\nnot exist, then render the files below **from the payload**\n(`$PAYLOAD`, set in Step 0). Each is a template under\n`$PAYLOAD\u002F\u003Cfile>`; read it, substitute the placeholders, and write the\nresult to the target path. These files are **not** committed by the\nskill — the user reviews the diff and commits manually, per global\nrule §0 (\"never write\u002Fcommit without approval\").\n\n### `paths.allowlist`\n\nRender `$PAYLOAD\u002Fpaths.allowlist` (no placeholders) to\n`\u003Crepo-root>\u002F.github\u002Fpublic-mirror\u002Fpaths.allowlist` verbatim. It is the\nrequired-files starting set with an empty `--- repo-specific (add\nbelow) ---` section the user fills in at Halt #2. `CONTRIBUTORS` ships\nlike any other allowlisted path (a static tracked file in the source\nrepo — see below), and `.github\u002Fpublic-mirror\u002F` is not wholesale on the\nallowlist: only `gitignore.mirror` survives, renamed to root\n`.gitignore` by the rename directive at the bottom of the template.\nShipping both `CONTRIBUTORS` and the mirror `.gitignore` through\n`git-filter-repo` (rather than synthesizing them as commits on top of\nfilter-repo's output) is what keeps the mirror fast-forwarding on\nroutine runs instead of diverging and force-pushing.\n\n### `mailmap`\n\nRender `$PAYLOAD\u002Fmailmap` to\n`\u003Crepo-root>\u002F.github\u002Fpublic-mirror\u002Fmailmap`, substituting\n`__GH_REPO__` with the source short name, then **seed the author\nentries** from the source repo's unique authors:\n\n```bash\ngit log --format='%aN \u003C%aE>' | sort -u\n```\n\nFor each unique `Name \u003Clocal@domain>` line, append a mailmap entry that\npreserves the localpart and rewrites the domain to `\u003Cshort>.local`:\n\n```text\n\u003CName> \u003Clocal@\u003Cshort>.local> \u003Clocal@\u003Coriginal-domain>>\n```\n\nThe template provides only the comment header (with `__GH_REPO__`\nalready substituted). If `git log` returns zero authors (empty repo),\nwrite the header alone. Do not invent entries.\n\n### `CONTRIBUTORS` (static, at the source repo root)\n\nRender `$PAYLOAD\u002FCONTRIBUTORS.template` to `$REPO_ROOT\u002FCONTRIBUTORS`,\nsubstituting `__GH_REPO__` with the source short name. `CONTRIBUTORS`\nis a **static tracked file** at the source repo root; it ships to the\nmirror like any other allowlisted path and is NOT synthesized at\nruntime (an earlier design regenerated it as a commit stacked on top of\nfilter-repo's output, which sat outside filter-repo's persisted state\nand made every source-change run diverge from the previous mirror tip\nand force-push, breaking consumers' `git pull`). The source repo must\n**track** this file — if the source `.gitignore` ignores root-level\nfiles by default, add an explicit `!\u002FCONTRIBUTORS` un-ignore so it is\ncommitted and therefore ships.\n\n### `gitignore.mirror` (the mirror's root `.gitignore`)\n\nRender `$PAYLOAD\u002Fgitignore.mirror` (no placeholders) to\n`\u003Crepo-root>\u002F.github\u002Fpublic-mirror\u002Fgitignore.mirror`: the **static**\nroot `.gitignore` for the mirror. The rename directive in\n`paths.allowlist` selects it and renames it to repo-root `.gitignore`\non the mirror, so it ships inside `git-filter-repo`'s own commit — not\nas a synthesized post-filter commit.\n\nThe mirror needs its OWN `.gitignore` rather than the source repo's:\nthe source `.gitignore` un-ignores paths that exist privately but are\ndeliberately excluded from the mirror, so shipping it would leave a\nconsumer's `git status` referencing rules for paths absent from their\nclone. The template un-ignores exactly the required shipped set plus\nthe `.gitignore` itself. Keep it in sync **by hand** with\n`paths.allowlist`: when the user adds a repo-specific shipped path at\nHalt #2, add or remove the matching `!\u002F\u003Cpath>` line here (and a\nrecursive `!\u002F\u003Cdir>**` line for directories). It is part of the input\nfingerprint (see Step 7), so editing it correctly triggers a refilter.\n\n### `replacements.txt` (optional identifier scrubbing)\n\nRender `$PAYLOAD\u002Freplacements.txt` (no placeholders) to\n`\u003Crepo-root>\u002F.github\u002Fpublic-mirror\u002Freplacements.txt`. The template\nships with no concrete rules — redaction rules are inherently\nrepo-specific. A mirror with no sensitive identifiers in history may\nleave it rule-free; the allowlist filter is the primary fail-safe.\n\n## Step 7: Render `.github\u002Fworkflows\u002Fpublic-mirror.yml`\n\nCreate the workflow file. It triggers on `push` to `main` and on\n`workflow_dispatch` for manual reruns. Steps: checkout full\nhistory, install `git-filter-repo`, clone a fresh bare copy, fetch\nthe persisted `filter-repo-state` and `filter-repo-meta` branches\nfrom the mirror, fetch the mirror's `main` and `filter-repo-blobs`\ninto local anchor refs (so all target-side objects referenced in\n`target-marks` are present for incremental runs), run the filter\nwith `--paths-from-file`, `--mailmap`, `--replace-text`,\n`--replace-message`, `--state-branch`, `--prune-empty=never`, and\n`--refs refs\u002Fheads\u002Fmain` (with a fingerprint check that triggers a\nfull refilter when `paths.allowlist`, `mailmap`, `gitignore.mirror`,\nor the `replacements.txt` rule set changes), build a\nblob-anchor commit for unreachable replacement blobs, and push to the\nmirror's `main` (skipped when the new local tip already equals the\nmirror's current tip; force-pushed only on from-scratch refilters,\nfast-forwarded on incremental runs) plus the three bookkeeping\nbranches (always force-pushed). `CONTRIBUTORS` ships as a static\ntracked file and `gitignore.mirror` is renamed to root `.gitignore` —\nboth through `git-filter-repo` itself, so there are no post-filter\nsynth steps.\n\nRender the workflow from `$PAYLOAD\u002Fpublic-mirror.yml` to\n`\u003Crepo-root>\u002F.github\u002Fworkflows\u002Fpublic-mirror.yml`, substituting\n`__GH_ORG__` with the owner and `__GH_REPO__` with the source short\nname. Those two placeholders appear in the `MIRROR_URL` env of the\nfilter step (`git@github-mirror:__GH_ORG__\u002F__GH_REPO__-public.git`)\nand `__GH_REPO__` also in the bot identity\n(`public-mirror@__GH_REPO__.local`). After rendering, confirm no\n`__...__` placeholder remains in the written file.\n\nNotes on the template:\n\n- There are **no post-filter synth steps**. `CONTRIBUTORS` ships as a\n  static tracked file at the source repo root (on `paths.allowlist`),\n  and the mirror's root `.gitignore` is renamed in from\n  `gitignore.mirror` by the rename directive in `paths.allowlist`.\n  Both land inside `git-filter-repo`'s own commit. An earlier design\n  synthesized these two files as commits stacked on top of\n  filter-repo's output; those commits sat outside filter-repo's\n  `--state-branch` marks and made every source-change run diverge from\n  the previous mirror tip and force-push, breaking consumers'\n  `git pull`. Shipping both through filter-repo means nothing is\n  stacked on its output, so routine runs fast-forward.\n- The meta-index temp file lives under `${RUNNER_TEMP}` (the\n  GitHub-recommended runner temp dir). The bare clone\n  (`WORK=$(mktemp -d)`) and the blob-type scratch file\n  (`TYPES_FILE=$(mktemp)`) use the runner's system default temp dir,\n  which on GitHub-hosted runners already resolves under the runner's\n  workspace — neither writes to the repo tree.\n- The `user.email` bot identity (`public-mirror@__GH_REPO__.local`) and\n  the mirror remote URL \u002F `MIRROR_URL`\n  (`git@github-mirror:__GH_ORG__\u002F__GH_REPO__-public.git`) carry the\n  `__GH_REPO__` \u002F `__GH_ORG__` placeholders in the template; the render\n  step in Step 7 substitutes them. No hand-editing of the written file\n  is needed.\n- The bot git identity is set **once**, repo-locally, on the bare\n  clone (`git config user.name` \u002F `user.email` right after the\n  `cd \"$WORK\u002Fsrc.git\"`), and every commit-creating path inherits it:\n  the meta-branch commit, the blob-anchor commit, and filter-repo's\n  own internal `--state-branch` mark-saving commit\n  (`git_filter_repo.py`'s `git -C . commit-tree`, which carries no\n  identity flags). Do not re-decorate individual `commit-tree` calls\n  with inline `-c user.name=… -c user.email=…` — that per-commit\n  pattern structurally cannot cover filter-repo's internal commit and\n  reintroduces issue #147 (`fatal: empty ident name`). Local scope\n  (not `--global`) is deliberate: filter-repo runs `commit-tree` with\n  cwd inside the clone, so git reads identity from the clone's local\n  `config`, and nothing outside the clone needs the identity. The\n  `.local` email is intentionally unverifiable — the `mailmap` pass\n  rewrites these bookkeeping commits' identities anyway.\n- `concurrency: public-mirror` prevents overlapping force-pushes if\n  two pushes land on `main` close together.\n- `CONTRIBUTORS` is a static tracked file in the source repo, shipped\n  by filter-repo like any other allowlisted path. Refresh it by hand\n  (regenerate `git shortlog -sne` against the rewritten history,\n  excluding the mirror bot) when desired. Because it is a normally\n  tracked source file, editing it is a source commit handled by\n  filter-repo's normal incremental path — it is deliberately NOT in\n  the input fingerprint.\n- `gitignore.mirror` becomes the mirror's root `.gitignore` via the\n  rename directive in `paths.allowlist`. It un-ignores exactly the\n  shipped set plus the `.gitignore` itself (with a recursive\n  `!\u002F\u003Cdir>**` line for each shipped directory), so a user who clones\n  the mirror underneath `~\u002F.claude` gets a clean `git status`. It is\n  kept in sync with `paths.allowlist` BY HAND and is part of the input\n  fingerprint, so editing it triggers a refilter — without that, the\n  mirror's `.gitignore` could go silently stale relative to\n  `gitignore.mirror`.\n- The `Filter into a fresh bare clone with persisted marks` step\n  uses `git filter-repo --state-branch filter-repo-state` so the\n  fast-import marks (source-commit → public-commit SHA mapping)\n  persist between runs on a dedicated mirror branch. Unchanged\n  source commits keep their previously-computed public SHAs across\n  runs, which is what makes a consumer's `git pull` fast-forward\n  cleanly after a genuine source change instead of seeing the entire\n  public history rewritten. `--refs refs\u002Fheads\u002Fmain` scopes\n  fast-export to walk only the source branch, not the fetched\n  anchor\u002Fblob refs; without it, filter-repo's default `--all` would\n  walk every ref in the clone, including the anchor refs whose\n  commits are target-side. A sibling `filter-repo-meta` branch\n  holds a `inputs.sha256` fingerprint over `paths.allowlist`,\n  `mailmap`, `gitignore.mirror`, and the cleaned `replacements.txt`\n  rule set; on each run the live fingerprint\n  is compared to the stored one,\n  and a mismatch triggers a full refilter (which is logged with a\n  GitHub `::warning::` annotation so the operator notices). A third\n  `filter-repo-blobs` branch anchors unreachable replacement blobs\n  created by `--replace-text` so they survive between runs. The\n  three bookkeeping branches are pushed alongside `main` on every\n  run (the blob-anchor push is conditional on blobs existing in\n  target-marks).\n- `--prune-empty=never` is paired with `--state-branch` deliberately:\n  filter-repo's source warns that `--state-branch` does not work\n  well with empty-commit pruning. The trade-off is that source\n  commits which touch only excluded paths show up in the mirror as\n  empty commits with their original commit messages intact. For\n  this skill's use case (private repo → public mirror) leaking\n  both the timing AND the commit-message contents for changes\n  touching only excluded paths is acceptable; the excluded diff\n  payload itself stays excluded. Operators with commit messages\n  that themselves contain sensitive content should weigh this\n  carefully before adopting the skill.\n- The `Push to mirror` step compares the new local tip to the\n  mirror's current `refs\u002Fheads\u002Fmain` (`git ls-remote`) and skips the\n  `main` push when they match. Because nothing is stacked on\n  filter-repo's output, the local tip IS filter-repo's output —\n  together with `--state-branch` this makes both no-source-change runs\n  AND genuine-source-change runs (where new commits add to the public\n  tip without rewriting history below) consumer-friendly. When the\n  tips differ, the step\n  checks `REFILTER_REASON`: on a from-scratch refilter (non-empty\n  reason) it force-pushes main (history was rewritten); on an\n  incremental run (empty reason) it pushes without `--force` so\n  consumers see a clean fast-forward. Before either push, a\n  strict-ancestor safety guard fails the run fast if the local\n  `main` is a strict ancestor of the remote `main` (local is behind,\n  remote has commits local lacks) — pushing in that state would\n  regress the mirror, so the step refuses rather than emit git's\n  ambiguous non-fast-forward hint. The state, meta, and\n  blob-anchor branches are always pushed (force) so the next run\n  can read them back; when the fingerprint is unchanged the\n  meta-branch SHA is stable, and when the blob set is unchanged the\n  blob-anchor SHA is stable, so those pushes are true no-ops. The\n  blob-anchor push is conditional on the ref existing (it may not\n  exist on the first run or when target-marks contains no blobs).\n\n## Step 8: Halt #2 — user populates `paths.allowlist`\n\nTell the user that the three config files and the workflow now\nexist on disk (uncommitted), and that the **allowlist's\nrepo-specific section is empty**. The mirror will be nearly empty\non first run if the user does not add paths.\n\nSuggest a starting place: re-read the source repo's `.gitignore`\n(if it uses a whitelist style) or list the top-level entries with\n`ls -A` so the user can decide which directories belong in the\nmirror. Then ask:\n\n> Edit `.github\u002Fpublic-mirror\u002Fpaths.allowlist` now, adding any\n> repo-specific paths under the `--- repo-specific (add below) ---`\n> marker. Tell me when you're done.\n\nWait for explicit confirmation that the file is ready. Do not\nadvance to Step 9 until the user says so.\n\n## Step 9: Dry-run the filter locally\n\nIn a sandbox directory under `.claude\u002Ftmp\u002Frepo-public-mirror-setup\u002F`\n(per the `\u003Crepo-root>\u002F.claude\u002Ftmp\u002F` convention — never `\u002Ftmp\u002F`),\nrun the filter against a fresh bare clone of the source repo.\nPrint the resulting tree so the user can see exactly what would\nland in the mirror.\n\n```bash\n# Capture the absolute repo root BEFORE cd-ing, so the filter\n# config paths resolve correctly regardless of cwd depth.\nREPO_ROOT=\"$(git rev-parse --show-toplevel)\"\nmkdir -p \"$REPO_ROOT\u002F.claude\u002Ftmp\u002Frepo-public-mirror-setup\"\nWORK=\"$REPO_ROOT\u002F.claude\u002Ftmp\u002Frepo-public-mirror-setup\u002Fdryrun\"\nrm -rf \"$WORK\"\n# --no-local forces a real object copy instead of hardlinking into the\n# source repo's object store. git-filter-repo aborts on a clone whose\n# objects are hardlinked back to the original, so a plain --bare clone\n# (which hardlinks for a local path) would fail here.\ngit clone --no-local --bare \"$REPO_ROOT\" \"$WORK\"\n( cd \"$WORK\" \\\n  && git filter-repo \\\n       --paths-from-file \"$REPO_ROOT\u002F.github\u002Fpublic-mirror\u002Fpaths.allowlist\" \\\n       --mailmap \"$REPO_ROOT\u002F.github\u002Fpublic-mirror\u002Fmailmap\" \\\n  && git ls-tree -r --name-only HEAD | sort )\n```\n\nPrint the sorted list of file paths from `git ls-tree -r\n--name-only HEAD`. Group it by top-level directory for legibility\nif the list is long.\n\nIf `tree` is installed, an alternative second display is helpful:\n\n```bash\n( cd \"$WORK\" \\\n  && git archive --format=tar HEAD | tar -tf - | sort \\\n       | sed 's#[^\u002F]##g;s#\u002F#  #g' )\n```\n\nEither form is fine — the point is the user can audit the contents\nbefore any remote push.\n\nCleanup of the sandbox is deferred to after Step 16 succeeds, so\nthe user can re-run the listing if they want.\n\n## Step 10: Halt #3 — user confirms the dry-run tree\n\nAsk explicitly:\n\n> Does this look right? Check for two things:\n>\n> 1. No leaked sensitive paths (anything you don't want published).\n> 2. All expected paths present (every file the mirror needs).\n>\n> Reply `y` to proceed with creating the mirror repo, or tell me\n> what to change in the allowlist.\n\nWait for explicit `y`\u002F`yes`\u002F`go`. If the user asks for changes,\nloop back to Step 8 — they edit the allowlist, you re-run the\ndry-run, you re-display the tree, you ask again.\n\nAfter this halt the skill proceeds through repo creation, deploy\nkey, and secret upload **without further halts** — those are the\nplumbing steps that are safe once the tree has been approved.\n\n## Step 11: Create the mirror repo\n\n```bash\nDESC=\"Read-only public mirror of \u003Cowner>\u002F\u003Cshort> (private).\"\ngh repo create \u003Cowner>\u002F\u003Cshort>-public \\\n  --public \\\n  --description \"$DESC\" \\\n  --disable-wiki\n```\n\nOnly `--disable-wiki` is passed at creation time. **Issues stay\nON** — this mirror's posture is `issues-allowed`: external users\nmay report problems on the mirror, which we triage and fix in the\nupstream private repo. Do **not** pass `--disable-issues`. `gh repo\ncreate` does not have a `--disable-discussions` flag, so Discussions\nare handled in Step 13.\n\nThen set merge methods and the merge-cleanup flag with `gh repo\nedit`. The mirror's gold-standard posture is **merge-commit on,\nsquash off, rebase off**, with `deleteBranchOnMerge=true`:\n\n```bash\ngh repo edit \u003Cowner>\u002F\u003Cshort>-public \\\n  --enable-merge-commit \\\n  --enable-squash-merge=false \\\n  --enable-rebase-merge=false \\\n  --delete-branch-on-merge\n```\n\nNote: PRs are **not** blocked by disabling merge methods — the\nmirror keeps merge-commit ON. PR-blocking comes from the\n`mirror-main-readonly` ruleset's `update` rule applied in Step 14.\nThe merge-method setting here just mirrors the live gold-standard\nrepo's configuration; it is not the PR guard.\n\nIf the repo already exists, abort with a clear message rather than\noverwriting. This skill is for green-field setup — migration of an\nexisting public mirror to this pattern is out of scope.\n\n## Step 12: Push the initial commit to establish `main`\n\nCreate the bootstrap content locally in\n`.claude\u002Ftmp\u002Frepo-public-mirror-setup\u002Fbootstrap\u002F` and push it as\nthe first commit on the mirror's `main`. This establishes `main`\nso the read-only ruleset in Step 14 can apply. The workflow will\noverwrite this commit's history on the first real filter run; the\npurpose here is purely to create a default branch.\n\nFiles in the bootstrap commit:\n\n- `README.md` — read-only banner (rendered from `$PAYLOAD\u002FREADME.md`).\n  The banner welcomes issues and states PRs are not accepted; it\n  carries **no link to the private upstream repo**.\n- `LICENSE`, `PATENTS`, `PRIOR_ART.md`, `CODEOWNERS`, `CONTRIBUTORS`:\n  the source repo's own copy if it exists; otherwise the payload\n  starter (`$PAYLOAD\u002FLICENSE`, `$PAYLOAD\u002FPATENTS`,\n  `$PAYLOAD\u002FPRIOR_ART.md`). `CODEOWNERS` has no payload starter — copy\n  it only if the source has it. `CONTRIBUTORS` was rendered to\n  `$REPO_ROOT\u002FCONTRIBUTORS` in Step 6; copy that.\n- The mirror's root `.gitignore` from\n  `.github\u002Fpublic-mirror\u002Fgitignore.mirror` (copied to `$BOOT\u002F.gitignore`).\n  Do NOT copy the source repo's own root `.gitignore` — the mirror\n  ships `gitignore.mirror` instead, and the first real workflow run\n  will produce the same `.gitignore` via the rename directive.\n\nThe `README.md` payload starter carries the read-only banner; render\n`$PAYLOAD\u002FREADME.md` (substitute `__GH_REPO__`). The banner welcomes\nissues and states PRs are not accepted, with no upstream link.\n\nThe `PATENTS` and `PRIOR_ART.md` payload starters carry the\n`__GH_OWNER_NAME__` and `__RELEASE_DATE__` placeholders. These are\n**only** needed when the source repo lacks its own copy of those files.\nIf a starter is needed, prompt the user for the owner name and the\npublic-release date before rendering, per the\n`${CLAUDE_PLUGIN_ROOT}\u002Fpayload\u002FREADME.md` \"Resolving placeholder values\"\nrule (these two cannot be inferred). If the source already has the\nfile, copy it verbatim and skip the prompt.\n\nPush sequence (run from the source repo root):\n\n```bash\nREPO_ROOT=\"$(git rev-parse --show-toplevel)\"\nBOOT=\"$REPO_ROOT\u002F.claude\u002Ftmp\u002Frepo-public-mirror-setup\u002Fbootstrap\"\nmkdir -p \"$BOOT\"\ncd \"$BOOT\"\ngit init -b main\n```\n\nThen populate the bootstrap directory as explicit, separate\nactions (do not bundle into a comment):\n\n1. Render `$PAYLOAD\u002FREADME.md` (substitute `__GH_REPO__`) to\n   `$BOOT\u002FREADME.md`.\n2. For each of `LICENSE`, `PATENTS`, `PRIOR_ART.md`, `CODEOWNERS`,\n   `CONTRIBUTORS`: if the file exists at `$REPO_ROOT\u002F\u003Cname>`, copy it\n   to `$BOOT\u002F\u003Cname>`. Otherwise, for `LICENSE` \u002F `PATENTS` \u002F\n   `PRIOR_ART.md`, render the payload starter\n   (`$PAYLOAD\u002F\u003Cname>` — `PATENTS` and `PRIOR_ART.md` need the\n   `__GH_OWNER_NAME__` \u002F `__RELEASE_DATE__` prompt above) to\n   `$BOOT\u002F\u003Cname>`. `CODEOWNERS` has no starter; skip silently when\n   absent. `CONTRIBUTORS` always exists (rendered in Step 6).\n3. Copy `$REPO_ROOT\u002F.github\u002Fpublic-mirror\u002Fgitignore.mirror` to\n   `$BOOT\u002F.gitignore` (the mirror's root `.gitignore`). Do NOT copy\n   the source repo's own `$REPO_ROOT\u002F.gitignore`.\n\nThen commit and push:\n\n```bash\ngit add .\ngit -c user.name='public-mirror-setup' \\\n    -c user.email='public-mirror-setup@\u003Cshort>.local' \\\n    commit -m 'Bootstrap mirror; real history follows from workflow'\ngit remote add origin git@github.com:\u003Cowner>\u002F\u003Cshort>-public.git\ngit push -u origin main\n```\n\nThis commit will be replaced on the first real workflow run. Its\nonly purpose is to give `main` a SHA so the read-only ruleset can\nattach to it.\n\n## Step 13: Set Issues \u002F Discussions \u002F Wiki \u002F Projects on the mirror\n\n```bash\ngh repo edit \u003Cowner>\u002F\u003Cshort>-public \\\n  --enable-issues=true \\\n  --enable-discussions=false \\\n  --enable-wiki=false \\\n  --enable-projects=false\n```\n\n**Issues stay ON** (`--enable-issues=true`) — this is the\ngold-standard `issues-allowed` posture: external users report\nproblems on the mirror, which we triage and fix upstream. Wiki,\nDiscussions, and Projects are off. `--enable-wiki=false` is\nredundant with the `--disable-wiki` passed at create time, but\nstating it here keeps the intent explicit and makes this step\nself-contained if re-run.\n\n## Step 14: Create the `mirror-main-readonly` ruleset on the mirror\n\nApply a **repository ruleset** (not legacy branch protection) that\nmakes `main` read-only to everyone except repo admins. This is the\nPR-and-push guard: the ruleset's `update` rule is what blocks PRs\nand direct pushes, while the admin bypass is what still lets the\nworkflow force-push. PR-blocking does **NOT** come from disabling\nmerge methods (the mirror keeps merge-commit on — see Step 11).\n\nDo **not** create legacy branch protection\n(`\u002Fbranches\u002Fmain\u002Fprotection`); the live gold-standard mirror has\nnone (that REST endpoint returns 404 there — it was superseded by\nthis ruleset). Use `gh api` to POST the ruleset:\n\n```bash\ngh api \\\n  --method POST \\\n  -H 'Accept: application\u002Fvnd.github+json' \\\n  \u002Frepos\u002F\u003Cowner>\u002F\u003Cshort>-public\u002Frulesets \\\n  --input - \u003C\u003C'JSON'\n{\n  \"name\": \"mirror-main-readonly\",\n  \"target\": \"branch\",\n  \"enforcement\": \"active\",\n  \"conditions\": {\n    \"ref_name\": {\n      \"include\": [\"~DEFAULT_BRANCH\"],\n      \"exclude\": []\n    }\n  },\n  \"rules\": [\n    { \"type\": \"deletion\" },\n    { \"type\": \"non_fast_forward\" },\n    { \"type\": \"update\" }\n  ],\n  \"bypass_actors\": [\n    {\n      \"actor_type\": \"RepositoryRole\",\n      \"actor_id\": 5,\n      \"bypass_mode\": \"always\"\n    }\n  ]\n}\nJSON\n```\n\nNotes:\n\n- **`actor_id: 5` is the built-in `admin` RepositoryRole.** The\n  bypass is the **admin role**, not a per-deploy-key bypass,\n  because deploy keys cannot be named as ruleset bypass actors —\n  ruleset `bypass_actors` accept org teams, GitHub Apps, and the\n  built-in RepositoryRole IDs (1 maintain, 2 write, 4 triage, 5\n  admin, etc.), but not deploy keys. A deploy key authenticates as\n  the repository itself and inherits **admin-equivalent** write\n  access to the repo it is attached to, so it lands inside the\n  admin bypass and can force-push `main`. Granting the bypass to\n  the admin role (rather than, say, the write role) keeps the set\n  of identities that can push `main` as small as possible: repo\n  admins and the workflow's deploy key, nobody else.\n- **The three rules together** make `main` read-only for non-admins:\n  `update` blocks ref updates (this is what rejects PRs and direct\n  pushes), `non_fast_forward` blocks force-pushes, and `deletion`\n  blocks branch deletion. The admin bypass (`bypass_mode: always`)\n  lets the workflow's deploy key do all three when it needs to —\n  the workflow force-pushes `main` on the first run and on any\n  filter-input change, and always force-pushes the bookkeeping\n  branches (`filter-repo-state`, `filter-repo-meta`,\n  `filter-repo-blobs`). The ruleset only targets `~DEFAULT_BRANCH`\n  (`main`), so the bookkeeping branches are unrestricted regardless.\n- **`~DEFAULT_BRANCH`** is the ref-name macro for the repo's default\n  branch; using it (rather than a literal `refs\u002Fheads\u002Fmain`) keeps\n  the ruleset correct if the default branch is ever renamed.\n- Admins are intentionally **not** locked out — leaving the admin\n  RepositoryRole in `bypass_actors` means a human admin can\n  intervene if the workflow gets stuck, the same rationale as the\n  old `enforce_admins: false` posture.\n- If the target org enforces stricter org-level rulesets, this POST\n  may conflict or be rejected. In that case surface the error to\n  the user and stop — the user resolves the conflict at the org\n  level, then asks the skill to retry.\n\n## Step 15: Upload the public half as a deploy key on the mirror\n\n```bash\ngh repo deploy-key add \u003Cexpanded-path>.pub \\\n  --repo \u003Cowner>\u002F\u003Cshort>-public \\\n  --title public-mirror-workflow \\\n  --allow-write\n```\n\n`--allow-write` is required because the workflow force-pushes to\nthe mirror.\n\n## Step 16: Store the private half as a secret on the source repo\n\nRead the private-key file and pipe it to `gh secret set`. Do not\nexpand the contents into the conversation or into shell argv.\n\n```bash\ngh secret set PUBLIC_MIRROR_DEPLOY_KEY \\\n  --repo \u003Cowner>\u002F\u003Cshort> \\\n  \u003C \"\u003Cexpanded-path>\"\n```\n\nThe redirect target is quoted so paths containing spaces (e.g.\n`\u002FUsers\u002FAlice Smith\u002F.ssh\u002Frepo-mirror`) work correctly.\n\nThe secret name `PUBLIC_MIRROR_DEPLOY_KEY` matches the\n`${{ secrets.PUBLIC_MIRROR_DEPLOY_KEY }}` reference in the\nworkflow written in Step 7.\n\n## Step 17: Print the next-steps checklist\n\nPrint this checklist to the user. The skill does **not** commit\nthe source-repo files — the user reviews and commits manually\n(global rule §0).\n\n```text\nPublic mirror bootstrap complete.\n\nCreated on GitHub:\n  - \u003Cowner>\u002F\u003Cshort>-public (public, Issues ON; Wiki\u002FProjects\u002F\n    Discussions off; merge-commit only, delete-branch-on-merge on)\n  - Ruleset mirror-main-readonly on main (deletion +\n    non_fast_forward + update; admin RepositoryRole bypass, so the\n    workflow's deploy key can still force-push)\n  - Deploy key: public-mirror-workflow (write-enabled)\n  - Source secret: PUBLIC_MIRROR_DEPLOY_KEY\n\nUncommitted in this repo (review and commit when ready):\n  - .github\u002Fpublic-mirror\u002Fpaths.allowlist\n  - .github\u002Fpublic-mirror\u002Fmailmap\n  - .github\u002Fpublic-mirror\u002Fgitignore.mirror\n  - .github\u002Fpublic-mirror\u002Freplacements.txt\n  - CONTRIBUTORS\n  - .github\u002Fworkflows\u002Fpublic-mirror.yml\n\nNext steps:\n  1. Review the diff:    git diff --stat .github\u002F\n  2. Commit and push:    triggers the first real workflow run.\n  3. Watch the run:      gh run watch (on push to main)\n  4. Verify the mirror:  the contents on\n     \u003Cowner>\u002F\u003Cshort>-public should match the dry-run tree.\n     The first run logs a `::warning::Refiltering from scratch:\n     first run (no state branch on mirror)` annotation; this is\n     expected. The state, meta, and blob-anchor branches\n     (`filter-repo-state`, `filter-repo-meta`,\n     `filter-repo-blobs`) appear on the mirror after this run;\n     subsequent runs reuse them.\n  5. Verify no-op runs:  re-trigger the workflow via\n     `gh workflow run public-mirror.yml --ref main` with no\n     intervening source changes. The `Push to mirror`\n     step should log `Mirror refs\u002Fheads\u002Fmain already at\n     \u003Csha>; nothing to push to main.` and a consumer clone's\n     `git pull` should report `Already up to date.`\n  6. Verify source-change runs are fast-forward:  land one new\n     commit on the source's `main`, watch the workflow, then on\n     the consumer clone run `git pull`. It should fast-forward\n     by exactly one commit (the new tip), NOT report a forced\n     update. The previous public history's SHAs are unchanged\n     because `--state-branch` reused them.\n\nWhen you later edit the filter config (paths.allowlist, mailmap, or\ngitignore.mirror), the next workflow run detects the input change via\nthe fingerprint stored on filter-repo-meta, logs a warning\n\"Refiltering from scratch: filter inputs changed\", and\nforce-pushes a rebuilt main. Tell consumers of the mirror to do\na one-time `git fetch && git reset --hard origin\u002Fmain` after a\nconfig-change run. (Editing the static CONTRIBUTORS file is NOT a\nconfig change — it is a normal source commit that the incremental\npath fast-forwards.)\n\nIf the first real workflow run fails, common causes:\n  - paths.allowlist references a path that doesn't exist in\n    history (filter-repo treats this as fatal — fix the path\n    or drop the entry)\n  - mailmap has malformed entries (filter-repo logs the bad line)\n  - deploy key lacks write scope (re-run gh repo deploy-key add\n    with --allow-write); the deploy key also needs write scope\n    to push the filter-repo-state, filter-repo-meta, and\n    filter-repo-blobs bookkeeping branches alongside main.\n```\n\nThen clean up the sandbox if the run succeeded:\n\n```bash\nrm -rf .claude\u002Ftmp\u002Frepo-public-mirror-setup\n```\n\nLeave the sandbox in place if any step from 11 onward failed, so\nthe user can inspect it.\n\n---\n\n## Halts and approval gates (summary)\n\nThe skill **must** halt and wait for explicit user confirmation at:\n\n- **Halt #1 (Step 5)** — derived values (mirror name, mailmap\n  domain, secret name, deploy-key title).\n- **Halt #2 (Step 8)** — user populates `paths.allowlist` with\n  repo-specific paths.\n- **Halt #3 (Step 10)** — dry-run tree review before any\n  destructive remote action.\n\nAfter Halt #3, Steps 11–16 run without further halts — those are\nthe plumbing steps that are safe once the tree has been approved.\n\n---\n\n## Hard constraints\n\n- **Never run before all pre-flight checks (Steps 0–3) pass.**\n  Each abort message must name the exact thing that failed and\n  what the user should do about it. Step 0 aborts with the standard\n  `${CLAUDE_PLUGIN_ROOT}\u002Fpayload\u002FREADME.md` existence-check message if the\n  payload directory is missing.\n- **Never write or commit the source-repo files for the user.**\n  Step 6 and Step 7 create the files on disk uncommitted; the user\n  reviews the diff and commits manually. (Global rule §0: never\n  commit without approval.)\n- **Never edit anything outside the source repo.** The skill\n  writes files under `\u003Crepo-root>\u002F.github\u002Fpublic-mirror\u002F`,\n  `\u003Crepo-root>\u002F.github\u002Fworkflows\u002F`, and\n  `\u003Crepo-root>\u002F.claude\u002Ftmp\u002Frepo-public-mirror-setup\u002F`. It **reads**\n  templates from\n  `${CLAUDE_PLUGIN_ROOT}\u002Fpayload\u002Frepo-public-mirror-setup\u002F`\n  (read-only — never written to). Nothing outside the source repo\n  gets touched on disk; the only remote changes are on the\n  newly-created mirror and the `PUBLIC_MIRROR_DEPLOY_KEY` secret on\n  the source.\n- **Never skip a halt.** All three halts (Steps 5, 8, 10) are\n  required. A \"looks fine, proceeding\" response without explicit\n  user confirmation is not approval.\n- **Never print private key material to the conversation.** Pipe\n  the private key file directly into `gh secret set` via stdin.\n  The `gh secret set ... \u003C \u003Cpath>` form is required.\n- **Never run on a public source repo.** Step 1 aborts if the\n  source visibility is anything other than `PRIVATE`.\n- **Never proceed if `git-filter-repo` is missing.** Step 3 aborts\n  with the install command. Do not attempt to install it yourself\n  — the user runs `brew install git-filter-repo`.\n- **All scratch work done by the skill on the user's machine goes\n  under `.claude\u002Ftmp\u002F...`** in the source repo, never `\u002Ftmp\u002F`,\n  never the user's home directory, never a path outside the repo.\n  Clean up on success; leave in place on failure. (This constraint\n  applies to the **skill**. The generated workflow runs on\n  GitHub-hosted Actions runners, a separate execution context with\n  its own conventions — there the meta-index uses `${RUNNER_TEMP}`,\n  the GitHub-recommended runner temp dir, while the bare clone and\n  blob-type scratch file use the runner's default temp dir. Neither\n  writes to the repo tree.)\n- **Keep Issues ON on the mirror** (`issues-allowed` posture).\n  Pass only `--disable-wiki` at create time (Step 11); do **not**\n  pass `--disable-issues`. Discussions and Projects are turned off\n  via the follow-up `gh repo edit` in Step 13 because `gh repo\n  create` does not expose `--disable-discussions` \u002F a Projects\n  flag.\n- **Block PRs via the `mirror-main-readonly` ruleset, not by\n  disabling merge methods.** Step 11 keeps merge-commit ON to match\n  the live gold-standard mirror; Step 14's ruleset `update` rule is\n  the actual PR-and-push guard. Do **not** create legacy branch\n  protection on the mirror.\n\n---\n\n## Out of scope\n\n- **SSH keypair generation.** Blocked by `settings.json`. The user\n  generates the key out-of-band and passes the path in.\n- **The first real filtered push.** The skill establishes `main`\n  with a bootstrap commit (Step 12) so the read-only ruleset can\n  apply, but the first filtered history push only happens when the\n  user commits the source-repo files (Steps 6–7) and pushes,\n  triggering the workflow.\n- **Repo-specific allowlist contents** beyond the required-files\n  starting set. The user fills these in at Halt #2.\n- **Migration of an existing public mirror to this pattern.** This\n  skill is for green-field setup only. If `\u003Cowner>\u002F\u003Cshort>-public`\n  already exists, Step 11 aborts.\n- **Auditing the contents of the source repo for sensitive data\n  before publishing.** The allowlist-only filter is fail-safe for\n  *new* files added later, but the user is responsible for\n  reviewing the dry-run tree at Halt #3 to confirm nothing\n  currently in history leaks.\n",{"name":5,"description":7},"main","4b187366f06afb374243166f6a0f5fc1514fa579","plugins\u002Fgithub-setup\u002Fskills\u002Frepo-public-mirror-setup","https:\u002F\u002Fgithub.com\u002FTheVoskamps\u002Fclaude-plugins-marketplace","https:\u002F\u002Fgithub.com\u002FTheVoskamps","2026-11-14 13:16:57",{"source":8,"skillName":5,"commands":31,"prompt":41,"zipAvailable":42},[32,35,38],{"tool":33,"command":34},"npx","npx skills add TheVoskamps\u002Fclaude-plugins-marketplace --skill repo-public-mirror-setup",{"tool":36,"command":37},"bunx","bunx skills add TheVoskamps\u002Fclaude-plugins-marketplace --skill repo-public-mirror-setup",{"tool":39,"command":40},"pnpm","pnpm dlx skills add TheVoskamps\u002Fclaude-plugins-marketplace --skill repo-public-mirror-setup","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FTheVoskamps\u002Fclaude-plugins-marketplace\u002Fblob\u002Fmain\u002Fplugins\u002Fgithub-setup\u002Fskills\u002Frepo-public-mirror-setup\u002FSKILL.md",true,[],[45,52,59,66,73,80],{"skillNo":46,"name":47,"nameZh":6,"description":48,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":49,"categories":50,"keywords":51,"publishedAt":19},"01M77KH3GAXPPXNQS96KDEEZBS","mask-inappropriate-language","Replace inappropriate language (profanity, slurs, strong insults) in provided text or a file with asterisks, character-for-character, preserving everything else.","https:\u002F\u002Fgithub.com\u002FTheVoskamps\u002Fclaude-plugins-marketplace\u002Fblob\u002Fmain\u002Fplugins\u002Fwriting-tools\u002Fskills\u002Fmask-inappropriate-language\u002FSKILL.md",[],[],{"skillNo":53,"name":54,"nameZh":6,"description":55,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":56,"categories":57,"keywords":58,"publishedAt":19},"01M77KGY5TZDQT8QR23Y0R8P7A","theorem-agents-interface","The interface between the sdlc reviewer and the theorem agents it spawns — what each double-dash brief parameter means, and what each consequence class means. Preloaded into every theorem agent (sdlc:theorem-generator, the disprover, and the verifier) via its skills frontmatter, and read by name by the sdlc:theorem-based-pr-reviewer agent for what its briefs' parameters mean; not invoked from the user's slash menu.","https:\u002F\u002Fgithub.com\u002FTheVoskamps\u002Fclaude-plugins-marketplace\u002Fblob\u002Fmain\u002Fplugins\u002Fsdlc\u002Fskills\u002Ftheorem-agents-interface\u002FSKILL.md",[],[],{"skillNo":60,"name":61,"nameZh":6,"description":62,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":63,"categories":64,"keywords":65,"publishedAt":19},"01M77KGT5HW0XAE500WSSM0PZY","sdlc-config-user","Interactively create or merge-update the repo user sdlc config, `\u003Crepo-root>\u002F.sdlc\u002Fuser-config.yml` (tier 3 — this user, this repo, never committed), and add it to the repo's tracked `.gitignore`.","https:\u002F\u002Fgithub.com\u002FTheVoskamps\u002Fclaude-plugins-marketplace\u002Fblob\u002Fmain\u002Fplugins\u002Fsdlc\u002Fskills\u002Fsdlc-config-user\u002FSKILL.md",[],[],{"skillNo":67,"name":68,"nameZh":6,"description":69,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":70,"categories":71,"keywords":72,"publishedAt":19},"01M77KGQGQVB0NYZX0WJRJPDEK","sdlc-config-repo","Interactively create or merge-update the shared repo sdlc config, `\u003Crepo-root>\u002F.sdlc\u002Frepo-config.yml` (tier 2 — tracked, every user of this repo).","https:\u002F\u002Fgithub.com\u002FTheVoskamps\u002Fclaude-plugins-marketplace\u002Fblob\u002Fmain\u002Fplugins\u002Fsdlc\u002Fskills\u002Fsdlc-config-repo\u002FSKILL.md",[],[],{"skillNo":74,"name":75,"nameZh":6,"description":76,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":19},"01M77KGKPEN7C5RCEDSEP3Z1XB","sdlc-config-global","Interactively create or merge-update the global user sdlc config, `$XDG_CONFIG_HOME\u002Fsdlc\u002Fuser-config.yml` (tier 1 — this user, every repo on this machine).","https:\u002F\u002Fgithub.com\u002FTheVoskamps\u002Fclaude-plugins-marketplace\u002Fblob\u002Fmain\u002Fplugins\u002Fsdlc\u002Fskills\u002Fsdlc-config-global\u002FSKILL.md",[],[],{"skillNo":81,"name":82,"nameZh":6,"description":83,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":84,"categories":85,"keywords":86,"publishedAt":19},"01M77KGFX95J2XEQBBD49QHTXK","pr-read-cli-interface","The contract for sdlc's PR-read CLIs — sdlc-pr-round, sdlc-pr-adjustments, sdlc-fixer-brief and sdlc-records-chain — their arguments, exit codes and output grammar. Preloaded into sdlc:theorem-based-pr-reviewer, sdlc:issue-fixer, sdlc:docs-writer and sdlc:pr-finalizer via their skills frontmatter; not invoked from the user's slash menu.","https:\u002F\u002Fgithub.com\u002FTheVoskamps\u002Fclaude-plugins-marketplace\u002Fblob\u002Fmain\u002Fplugins\u002Fsdlc\u002Fskills\u002Fpr-read-cli-interface\u002FSKILL.md",[],[]]