Agent skill

Target Repo Setup

by protect-my-hair in protect-my-hair/nucleus-marketplace

A skill your agent uses when 需要初始化目标产品仓库的 Nucleus V2 资产、只读检查、候选产物、审批后写入和结果证据。

MITAuto-check passed

Install Target Repo Setup

skills CLI
$ npx skills add protect-my-hair/nucleus-marketplace --skill target-repo-setup -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install protect-my-hair/nucleus-marketplace target-repo-setup --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/protect-my-hair/nucleus-marketplace.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/nucleus/skills/target-repo-setup .claude/skills/target-repo-setup && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
target-repo-setup
GitHub stars
164
Token cost
~763 tokens
SKILL.md length
184 words
Files
20 (incl. scripts, references, assets)
Skills in repo
18
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when 需要初始化目标产品仓库的 Nucleus V2 资产、只读检查、候选产物、审批后写入和结果证据。

  • Works in 7 steps: 执行目标仓库只读检查(run-preflight),原始报告写到目标仓库外部。 → 归一化只读检查结果(normalize-preflight);未审批时只写… → 生成初始化计划、规则块候选差异、docs/specs/**… → …
  • 需要初始化目标产品仓库的 Nucleus V2 资产、只读检查、候选产物、审批后写入和结果证据
  • SKILL.md covers 最短操作顺序, 对人交付口径, 人审前子代理预审 and 本地子命令, plus 3 more sections
  • Calls python3

What it does

Target Repo Setup is an agent skill from protect-my-hair/nucleus-marketplace. Use when 需要初始化目标产品仓库的 Nucleus V2 资产、只读检查、候选产物、审批后写入和结果证据。

Its SKILL.md is about 760 tokens, which your agent loads only when the skill is triggered. The skill folder holds 22 other files, including scripts, reference files and assets (for example `agents/openai.yaml`, `assets/docs-specs-readme-template.md` and `assets/feature-leaf-template.md`).

The repository describes itself as: Nucleus — Claude Code / Codex 工作流插件,确保 AI 编码产出结构可信、边界可审计、过程可追溯. The licence is MIT.

When your agent uses it

  • 需要初始化目标产品仓库的 Nucleus V2 资产、只读检查、候选产物、审批后写入和结果证据

Example prompts

  • “/target-repo-setup”

Requirements

  • Python 3

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

  1. 执行目标仓库只读检查(run-preflight),原始报告写到目标仓库外部。
  2. 归一化只读检查结果(normalize-preflight);未审批时只写 .nucleus/runs//**。
  3. 生成初始化计划、规则块候选差异、docs/specs/** 规范模板候选和模板候选产物(build-plan、check-boundary、build-candidates)。
  4. 生成运行结果包(build-result):先读 .nucleus/runs//summary.md,机器事实源仍是 .nucleus/runs//result.json。
  5. 缺少人工审批事实时停在 NEEDS_HUMAN_REVIEW;只有审批事实有效时,才能写 AGENTS.md 的 Nucleus 管理规则块、允许目录和缺失的默认 docs/specs/** 规范模板。
  6. 正式特性/测试骨架不由初始化步骤默认选择路径;必须由目标仓库特性树评审给出明确目标路径(targetPath)后,才允许单独执行提升命令。
  7. 如需检查、安装、配置或激活宿主工具,单独使用 $host-tool-setup;本 Skill 的成功不代表宿主工具可用。

What it can do on your machine

Read from SKILL.md and the folder at commit 3c82085. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/, which the agent can run.

    Shell commands in SKILL.md call:

    • python3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Target Repo Setup loads about 763 tokens when it runs, and up to ~6k if it reads all its reference files. Until then it costs about 19 tokens; SKILL.md has 184 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~19
When it runs · the whole SKILL.md, loaded when a task matches
~763
With references · SKILL.md plus every file in references/, read only if the agent opens them
~6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from protect-my-hair/nucleus-marketplace at commit 3c82085, republished under its MIT licence (© protect-my-hair). 184 words, ~763 tokens.

Download SKILL.mdSave it as .claude/skills/target-repo-setup/SKILL.md (or your agent's skills folder). This skill also uses 19 other files; get the full folder from GitHub.
name
target-repo-setup
description
Use when 需要初始化目标产品仓库的 Nucleus V2 资产、只读检查、候选产物、审批后写入和结果证据。

Target Repo Setup

用于目标产品仓库的 Nucleus V2 初始化。它是 Skill package 入口,确定性本地能力由 scripts/target_repo_setup.py 的显式子命令执行。人读说明先使用中文动作;CLI 子命令、JSON 字段和 approval scope 保持英文机器契约。

最短操作顺序

  1. 执行目标仓库只读检查(run-preflight),原始报告写到目标仓库外部。
  2. 归一化只读检查结果(normalize-preflight);未审批时只写 .nucleus/runs/<workflowRunId>/**。
  3. 生成初始化计划、规则块候选差异、docs/specs/** 规范模板候选和模板候选产物(build-plan、check-boundary、build-candidates)。
  4. 生成运行结果包(build-result):先读 .nucleus/runs/<workflowRunId>/summary.md,机器事实源仍是 .nucleus/runs/<workflowRunId>/result.json。
  5. 缺少人工审批事实时停在 NEEDS_HUMAN_REVIEW;只有审批事实有效时,才能写 AGENTS.md 的 Nucleus 管理规则块、允许目录和缺失的默认 docs/specs/** 规范模板。
  6. 正式特性/测试骨架不由初始化步骤默认选择路径;必须由目标仓库特性树评审给出明确目标路径(targetPath)后,才允许单独执行提升命令。
  7. 如需检查、安装、配置或激活宿主工具,单独使用 $host-tool-setup;本 Skill 的成功不代表宿主工具可用。

对人交付口径

运行结束后必须先读 .nucleus/runs/<workflowRunId>/summary.md 和 result.json,再按 references/human-interaction.md 输出结论。最终回复不能只列状态(status)、检查项(gate)或工具状态;必须明确“已经完成什么、还没有做什么、需要用户决定什么、下一步怎么做”。

人审前子代理预审

到达 setup plan review 或 template candidate review 前,必须按 workflow 的 subagentPreReview 调度独立 reviewer 子代理;未取得“材料可提交人工审查”预审结论时,不得请求人工审批或评审通过。

本地子命令

运行 python3 scripts/target_repo_setup.py list-subcommands 查看完整能力。当前实现:

  • 只读检查和运行证据:run-preflight、normalize-preflight、build-plan、check-boundary、build-candidates、build-result。
  • 审批后初始化写入:resolve-approval、write-managed-block、init-assets。
  • 评审后正式写入:promote-feature-skeleton、promote-test-skeleton。

边界

  • 目标是目标产品仓库,不是 Nucleus 插件仓库。
  • SKILL.md、scripts/、references/、assets/ 是 Claude Code / Codex 共享的 Skill 主体。
  • agents/openai.yaml 只是 Codex-only optional metadata;Claude Code 不应依赖它执行本 Skill。
  • 标准过程路径是 .nucleus/**,测试过程证据路径是 .nucleus/tests/**。
  • 正式开发规范事实源位于 docs/specs/**;初始化只在 init-assets 审批后写缺失的默认规则模板,已有文件不覆盖,后续补充必须走目标仓库评审。
  • 正式产品能力写入只面向 docs/features/** 和 tests/**,且必须经过 review gate。
  • docs/requirement/** 是受保护需求事实源;普通 setup 和普通开发不得写。
  • legacy risk path 只读探测:.autocode/**、.claude/notepads/**、docs/bugfix/**。命中时登记风险并阻塞确认。

何时读取资源

  • workflow step、artifact、approval 和 command policy:读 references/workflow-contract.md。
  • 写入边界或 plannedWrites 判断:读 references/repo-asset-boundaries.md。
  • managed block marker、重复 marker、partial marker 或 dirty conflict:读 references/managed-block.md。
  • 审批事实、result status 和 changedFiles 证据:读 references/approval-and-result.md。
  • blocker code、恢复建议和 result 映射:读 references/blocker-matrix.md。
  • 机器词和中文显示名:读 references/terminology.md。
  • 对人交付格式、审批提示和反例:读 references/human-interaction.md。
  • 候选内容只从 assets/ 取,不把 asset 当作已批准正式写入。

阻塞规则

必须 ALERT_AND_BLOCK:

  • 目标仓库只读检查报告(preflight report)缺失、结构错误或已阻塞。
  • plannedWrites 越界,或计划写 legacy risk path。
  • Nucleus 管理规则块边界标记(managed block marker)重复、残缺、hash 不匹配或无法安全定位。
  • 缺少 setup-plan-review.subagentPreReview 且材料可提交人工审查的预审结论,或缺少后续人工审批事实,却要写 AGENTS.md、CLAUDE.md、docs/features/** 或 tests/**。
  • 尝试把宿主工具检查、安装、配置、激活、索引或回滚纳入本 Skill。
  • hooks 被当作关键检查项(gate)的替代品,而不是增强检查项。

© protect-my-hair, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 19 other files (scripts, references, assets) in plugins/nucleus/skills/target-repo-setup of protect-my-hair/nucleus-marketplace.

  • SKILL.md
  • agents/openai.yaml
  • assets/docs-specs-readme-template.md
  • assets/feature-leaf-template.md
  • assets/managed-block-agents.md
  • assets/requirement-boundary-readme-candidate.md
  • assets/spec-rule-design-system-style.md
  • assets/spec-rule-ui-design-conformance.md
  • assets/spec-rule-verification-evidence.md
  • assets/test-attribution-template.md
  • references/approval-and-result.md
  • references/blocker-matrix.md
  • references/human-interaction.md
  • references/managed-block.md
  • references/nucleus-result.schema.json
  • references/repo-asset-boundaries.md
  • references/terminology.md
  • references/workflow-contract.md
  • … and 2 more

Open the folder on GitHubat commit 3c82085

Compare with similar skills

Target Repo Setup next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Target Repo Setup compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Target Repo Setup this skillprotect-my-hair/nucleus-marketplace164—~763Automated safety check: PassMIT
Bio Single Cell Hashing DemultiplexingGPTomics/bioSkills1.2k1 repos~4.2kAutomated safety check: PassMIT
Bio Single Cell Cnv InferenceGPTomics/bioSkills1.2k1 repos~4.7kAutomated safety check: PassMIT
Scenario Maya Fxscenario-labs/skills946—~5.3kAutomated safety check: PassMIT
Cellpose Cell Segmentationjaechang-hits/SciAgent-Skills3741 repos~3.5kAutomated safety check: PassBSD-3-Clause
Game Concept ArchitectDY-2026/GameDesignOS415—~2.1kAutomated safety check: PassMIT

Similar skills

  • Assign cells to their sample of origin from cell or nucleus hashing (CITE-seq HTOs, MULTI-seq lipid/cholesterol tags, CellPlex CMOs) and call cross-sample doublets using Seurat…

    1.2k GitHub starsUsed in 1 repo~4.2k tokens
    Research & ScienceAuto-check passed
  • Infer large-scale copy-number alterations from tumor single-cell or single-nucleus RNA-seq to separate malignant from normal cells and call subclones, using inferCNV, copyKAT, Numbat, and SCEVAN.

    1.2k GitHub starsUsed in 1 repo~4.7k tokens
    Research & ScienceAuto-check passed
  • Scenario Maya Fx

    scenario-labs/skills

    A skill your agent uses when a Maya task involves simulation or procedural effects: nCloth or Nucleus (a cape, skirt, flag or garment on an animated character, cloth through the body, jittery or…

    946 GitHub stars~5.3k tokensUpdated yesterday
    Game DevelopmentAuto-check passed
  • Cellpose Cell Segmentation

    jaechang-hits/SciAgent-Skills

    DL cell/nucleus segmentation for fluorescence and brightfield microscopy.

    374 GitHub starsUsed in 1 repo~3.5k tokens
    AI & LLM EngineeringAuto-check passed
  • Game Concept Architect

    DY-2026/GameDesignOS

    将一句话游戏创意扩展为可验证的游戏设计蓝图:从 concept seed、玩家动词、design nucleus options、动作-目标对齐、assumption ledger、玩家承诺、核心循环、scope gate 到 validation plan。适用于真实项目、私有项目、客户项目、公开案例或 synthetic cases;仓库示例发布规则由 CONTRIBUTING.md 管理。

    415 GitHub stars~2.1k tokensUpdated 1 mo ago
    Game DevelopmentAuto-check passed
  • Lattice

    yogthos/Matryoshka

    Analyze large files (500 lines) using handle-based Nucleus queries for 97% token savings.

    150 GitHub stars~1.1k tokensUpdated 4 mo ago
    Agent WorkflowsAuto-check passed

More from protect-my-hair/nucleus-marketplace

All 18 skills in this repo
  • Nucleus Delivery Evidence Closure

    protect-my-hair/nucleus-marketplace

    Collects prior Nucleus task evidence into a candidate-only delivery closure package and PR/MR draft text, blocking if any feature's design, review or verification evidence is missing.

    164 GitHub stars~1k tokensUpdated 2 mo ago
    Auto-check passed
  • Nucleus Context Validator

    protect-my-hair/nucleus-marketplace

    Validates the context file for a Nucleus V2 workflow run, discovers standalone context from explicit input, and writes a blocked result when required context is missing.

    164 GitHub stars~576 tokensUpdated 2 mo ago
    Auto-check passed
  • Nucleus Session Binding Report

    protect-my-hair/nucleus-marketplace

    Collects, freezes and validates a Nucleus V2 session binding report that records the native Claude Code or Codex session ID, transcript path and hash.

    164 GitHub stars~477 tokensUpdated 2 mo ago
    Auto-check passed
  • Nucleus Result Package Builder

    protect-my-hair/nucleus-marketplace

    Builds the result.json file for a Nucleus V2 workflow run from its context, gates, blockers and step status, and exits non-zero when the run is blocked.

    164 GitHub stars~414 tokensUpdated 2 mo ago
    Auto-check passed
  • Defect Intake and RCA Candidates

    protect-my-hair/nucleus-marketplace

    Checks whether a defect report has enough context to be accepted, then drafts candidate-only root-cause evidence for human review without confirming causes or changing code.

    164 GitHub stars~745 tokensUpdated 2 mo ago
    Auto-check passed
  • Nucleus Delivery Evidence Finalizer

    protect-my-hair/nucleus-marketplace

    Combines the evidence from completed Nucleus workflow steps into a final evidence report and result package, without scheduling steps, updating trackers or opening pull requests.

    164 GitHub stars~454 tokensUpdated 2 mo ago
    Auto-check passed

Questions about Target Repo Setup

What does Target Repo Setup do?

A skill your agent uses when 需要初始化目标产品仓库的 Nucleus V2 资产、只读检查、候选产物、审批后写入和结果证据。. Target Repo Setup is an agent skill from protect-my-hair/nucleus-marketplace.

When should I use Target Repo Setup?

Target Repo Setup fits situations like: 需要初始化目标产品仓库的 Nucleus V2 资产、只读检查、候选产物、审批后写入和结果证据.

How do I install Target Repo Setup in Claude Code?

Run `npx skills add protect-my-hair/nucleus-marketplace --skill target-repo-setup -a claude-code`. Or copy the skill folder (plugins/nucleus/skills/target-repo-setup in protect-my-hair/nucleus-marketplace) into .claude/skills/target-repo-setup in your project. Claude Code loads it when a task matches its description.

How do I install Target Repo Setup in Codex?

Run `npx skills add protect-my-hair/nucleus-marketplace --skill target-repo-setup -a codex`. Or copy the skill folder (plugins/nucleus/skills/target-repo-setup in protect-my-hair/nucleus-marketplace) into .agents/skills/target-repo-setup in your project. Codex loads it when a task matches its description.

Can I use Target Repo Setup in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add protect-my-hair/nucleus-marketplace --skill target-repo-setup -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/target-repo-setup, .gemini/skills/target-repo-setup, .github/skills/target-repo-setup and .opencode/skills/target-repo-setup in your project.

What does Target Repo Setup need to run?

Going by SKILL.md and its folder, Target Repo Setup needs the command-line tools its instructions call (python3). Our summary lists: Python 3.

Does Target Repo Setup access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Target Repo Setup safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Target Repo Setup use?

Target Repo Setup is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Target Repo Setup use?

About 763 tokens (SKILL.md is roughly 3.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 5.2k tokens, read only when the agent opens those files.

What are the alternatives to Target Repo Setup?

Skills that share tags, products or a category with Target Repo Setup: Bio Single Cell Hashing Demultiplexing (GPTomics/bioSkills, 1.2k stars), Bio Single Cell Cnv Inference (GPTomics/bioSkills, 1.2k stars), Scenario Maya Fx (scenario-labs/skills, 946 stars) and Cellpose Cell Segmentation (jaechang-hits/SciAgent-Skills, 374 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Target Repo Setup?

protect-my-hair (a GitHub user) maintains it in protect-my-hair/nucleus-marketplace, which has 164 GitHub stars. The repository holds 18 skills in this directory. The repository was last updated on July 23, 2026.

Source: protect-my-hair/nucleus-marketplace on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.