setup

setup is a skill for Claude Code, Codex from protect-my-hair/nucleus-marketplace. It costs 28 tokens per session (1,792 once invoked), scanned A, original, MIT.

A single entry point for initializing a repository and checking the tools used by the coding agent. It coordinates repository setup and host-tool setup while keeping their results separate.

In plain words
What is it for?
Use it when setting up a Nucleus project and its host tools. It covers inspection, planning, approval, applying changes, verification, building a result, and repeating tool checks when installation is incomplete.
Why use it?
It avoids treating a generated plan or initialized repository as proof that the tools are installed and working. It also requires checks, approvals, verification, and evidence at the appropriate points.

Skill for Claude CodeCodex

Written for Claude Code and Codex: SessionStart hook event, but also agents/openai.yaml present. Also seen: mentions subagents; names the TodoWrite tool; mentions Claude Code.

Part of the nucleus plugin — 27 skills, 1 agent, 1 hook shipped together

Good fit Use it when setting up a Nucleus project and its host tools. It covers inspection, planning, approval, applying changes, verification, building a result, and repeating tool checks when installation is incomplete.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/protect-my-hair/nucleus-marketplace/setup
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add protect-my-hair/nucleus-marketplace --skill setup
Clone the repo
git clone --depth 1 https://github.com/protect-my-hair/nucleus-marketplace

Made for: Claude Code, Codex.

Or install nucleus, the plugin that ships this one along with the rest of its 27 skills, 1 agent, 1 hook.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for setup

README.md
[![agentmods](https://agentmods.dev/badge/skills/protect-my-hair/nucleus-marketplace/setup/github.svg)](https://agentmods.dev/skills/protect-my-hair/nucleus-marketplace/setup)
Your own site
<a href="https://agentmods.dev/skills/protect-my-hair/nucleus-marketplace/setup"><img src="https://agentmods.dev/badge/skills/protect-my-hair/nucleus-marketplace/setup/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for setup

Your own site · 80×15
<a href="https://agentmods.dev/skills/protect-my-hair/nucleus-marketplace/setup"><img src="https://agentmods.dev/badge/skills/protect-my-hair/nucleus-marketplace/setup.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 28 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,792 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector pass 7 Sept 2026
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00028 $0.01792
Opus 5 $0.00014 $0.00896
Sonnet 5 $0.00006 $0.00358
Haiku 4.5 $0.00003 $0.00179

Measured 12d ago against content hash 7c483bdc17fc, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-12, from the pricing page.

Security

Grade A, and why

setup scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 12d ago.

The scan reads SKILL.md. This mod also ships 1 executable file (scripts/setup.py), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

plugins/nucleus/skills/setup/SKILL.md · 76 lines

How it starts

The opening of the file, as written. The whole thing — 76 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Setup

前置:使用本 Skill 前,先按 using-nucleus 完成 Nucleus 入口识别(Claude Code 会话由插件 SessionStart hook 自动注入该纪律)。

setup 是用户主入口。它对人呈现一次 setup 体验,内部仍然编排 target-repo-setuphost-tool-setup,不合并两者职责边界。

使用原则

  • 用户主要使用本 Skill;target-repo-setuphost-tool-setup 保留为内部能力或高级入口。
  • target-repo-setup 只初始化目标仓库资产,不检查、不安装、不配置宿主工具。
  • host-tool-setup 只处理宿主工具检查、规划、确认、验证和回滚证据,不写目标业务产物。
  • 计划已生成不代表安装成功。仓库初始化完成不代表工具可用。
  • 用户主动执行 setup 后,仓库初始化默认继续执行;遇到冲突、路径风险或宿主工具写配置风险时才停下来确认。
  • 宿主工具真实可用只能由 verify 证据证明。
  • 总结果必须分别记录目标仓库初始化和宿主工具状态;目标仓库成功不等于宿主工具成功。
  • 如果 hostTools.status 不是 SUCCEEDED,当前 agent 不得结束本轮 setup 回复;必须读取 host-tool-setup/references/host-tool-install-session.mdhost-tool-setup/references/tool-installation.md,按共享子代理预审协议(_shared/references/subagent-precheck-protocol.md)完成 subagentPreReview 并确认材料可提交人工审查,再继续发起安装确认和执行。

未按宿主任务逐项完成 inspect、plan、approval、apply、verify、build-result 和必要的宿主工具安装复验时,不得把 summary.mdresult.json 或 setup plan 当作 setup 终态。

内部 target-repo-setuphost-tool-setup 到达人工审查点时,必须先按 _shared/references/subagent-precheck-protocol.md 完成 subagentPreReview 预审并取得"材料可提交人工审查"结论;未预审不得请求人工审批或评审通过。

Checklist

启动本 Skill 后,必须先为以下每一项创建宿主 todo/task,并按顺序执行;Codex 使用计划 / 任务工具,Claude Code 使用 TodoWrite 或等价宿主 todo。每完成、阻塞、等待确认或需要复验一项,都必须逐项更新状态;任何等待确认若涉及人工审查点,仍必须先有 subagentPreReview 且材料可提交人工审查。

  1. 执行 inspect:同时执行目标仓库只读检查(preflight)和宿主工具只读检查(inspect)。
  2. 执行 plan:生成统一 setup plan,说明 target scopes、host scopes、默认动作和风险。
  3. 执行 approval --auto-defaults:由 setup 入口生成本轮默认确认事实;遇到冲突、路径风险或用户级配置风险时停住确认。
  4. 执行 apply:默认写入 AGENTS.md 受控规则区块、初始化 .ac 工作目录,并为缺失宿主工具生成安装和验证引导。
  5. 处理 apply 阻塞或安装引导:冲突、越界或用户级配置风险必须停住;宿主工具缺失时按 _shared/references/subagent-precheck-protocol.md 完成 subagentPreReview 并确认材料可提交人工审查,再进入安装确认。
  6. 执行 verify:统一验证目标仓库初始化状态和宿主工具真实状态。
  7. 执行 build-result:生成 .nucleus/runs/<workflowRunId>/setup-entry/result.jsonsummary.md
  8. 复核宿主工具状态:如果宿主工具仍缺失或未验证,读取安装会话 reference,按 _shared/references/subagent-precheck-protocol.md 完成 subagentPreReview 并确认材料可提交人工审查,再发起安装确认、执行安装 / 配置 / 激活 / 索引,并重新运行 verify 和 build-result。

Read the full file on GitHub · 76 lines

Files

What ships with it

6 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 12d ago First seen · 76 lines · 28 tokens per session scan A 7c483bdc17fc

Subscribe to this mod's changes

setup is a skill published in the GitHub repository protect-my-hair/nucleus-marketplace (162 stars, last pushed 1mo ago), licensed MIT. It adds 28 tokens to every session and 1,792 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

systematic-debugging

Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes.

obra/superpowers · 21 tokens

local-ai-agents

Build local-first AI agents that run entirely on a developer workstation with Microsoft Foundry Local and Qwen function-calling models. Covers Small Language Models (SLMs), the OpenAI-compatible local endpoint, sandboxed local tools, local RAG with Chroma, local MCP servers, hybrid cloud/local routing, and the…

microsoft/ai-agents-for-beginners · 200 tokens

next-cache-components-adoption

Turn on Cache Components in a Next.js app and resolve the blocking routes it surfaces. Use when the user wants to enable, adopt, or migrate to Cache Components, flip the cacheComponents flag, work through a flood of blocking-prerender / instant validation errors, run the cache-components-instant-false codemod, or…

vercel/next.js · 95 tokens

chat-pet-sprite-creation

Use when creating or changing VS Code chat pet sprite art, sprite sheets, state animations, eye treatments, Stable/Insiders variants, or pet transitions under src/vs/workbench/contrib/chat/browser/widget/media/chatPet.

microsoft/vscode · 53 tokens

cpu-profile-analysis

Analyze V8/Chrome CPU profiles (.cpuprofile) and DevTools trace files (Trace-.json). Use when: profiling performance, investigating slow functions, comparing code paths, finding bottlenecks, analyzing timeToRequest, understanding call trees from sampling profiler data, analyzing layout/paint/rendering, investigating…

microsoft/vscode · 71 tokens

insight-error-page

Write or audit an insight-kind error page for the Next.js dev overlay. Use when creating a new errors/ .mdx page, auditing an existing one, or checking that a page matches the framework fix cards. Covers page structure, title alignment, FixCard cards with Copy prompt button, code snippets, terminology verification…

vercel/next.js · 83 tokens