Agent skill

Wizard

by vinvcn in vinvcn/mattpocock-skills-zh-CN

生成一个交互式 bash wizard,逐步引导人完成只有他们能执行的手动流程。用于 provisioning 基础设施、设置 credentials 或 CI secrets、走查不熟悉的第三方 dashboard,或运行一次性 migration 或 cutover。对于 agent 自己就能执行的步骤,不要调用它。

MITAuto-check: notesDevelopment

Install Wizard

skills CLI
$ npx skills add vinvcn/mattpocock-skills-zh-CN --skill wizard -a claude-code

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

GitHub CLI
$ gh skill install vinvcn/mattpocock-skills-zh-CN wizard --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/vinvcn/mattpocock-skills-zh-CN.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/engineering/wizard .claude/skills/wizard && 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
wizard
GitHub stars
4.6k
Token cost
~572 tokens
SKILL.md length
176 words
Files
3
Skills in repo
33
Repo updated
First seen
Licence
MIT

At a glance

生成一个交互式 bash wizard,逐步引导人完成只有他们能执行的手动流程。用于 provisioning 基础设施、设置 credentials 或 CI secrets、走查不熟悉的第三方 dashboard,或运行一次性 migration 或 cutover。对于 agent 自己就能执行的步骤,不要调用它。

  • Works in 4 steps: Scope the procedure → Map each stage's journey → Author the wizard → …
  • Development work in your project
  • Runs Shell scripts from its folder; calls gh and bash

What it does

Wizard is an agent skill from vinvcn/mattpocock-skills-zh-CN. 生成一个交互式 bash wizard,逐步引导人完成只有他们能执行的手动流程。用于 provisioning 基础设施、设置 credentials 或 CI secrets、走查不熟悉的第三方 dashboard,或运行一次性 migration 或 cutover。对于 agent 自己就能执行的步骤,不要调用它。

Its SKILL.md is about 570 tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files (for example `agents/openai.yaml` and `template.sh`).

It sits in Development. It works with Bash. The repository describes itself as: 这是 mattpocock/skills 的简体中文本地化版本。 The licence is MIT.

When your agent uses it

  • Development work in your project

Example prompts

  • “/wizard”

Requirements

  • A Bash shell
  • Docker

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Scope the procedure
  2. Map each stage's journey
  3. Author the wizard
  4. Verify and hand off

What it can do on your machine

Read from SKILL.md and the folder at commit 3f92a83. 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 script files (Shell), which the agent can run.

    Shell commands in SKILL.md call:

    • gh
    • bash

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

  • Network

    No URLs in SKILL.md. Its commands use gh, which can reach the network depending on how they are called.

    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

Wizard loads about 572 tokens when it runs. Until then it costs about 42 tokens; SKILL.md has 176 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~42
When it runs · the whole SKILL.md, loaded when a task matches
~572

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:8
    开每个 URL,准确说明该点什么、该复制什么,捕获这些值,把它们写到该去的地方(`.env`、GitHub secrets),在每个阶段确认,并显示还剩多少个阶段。它可能用于配置第三方服务、运行一次性 migration,或把项目从一种状态
  • NoteMentions a .env fileSKILL.md:10
    tes、跨平台 URL 打开(含 WSL)、隐藏的 secret 输入、幂等的 `.env` upserts、`gh secret`/`gh variable` 写入,以及收尾 summary。**你的工作只是确定流程范围并编写它的各个 s
  • NoteMentions a .env fileSKILL.md:20
    - 对于 setup:`.env`、`.env.example`、`.env.*`、`README`、`docker-compose*`、framework config,以及 `.github/workflows/*`(每一处 `secr
  • NoteMentions a .env fileSKILL.md:25
    命名,并且对于每个捕获的值,你知道 (a) 人从哪里获取它,(b) 它写到哪里(`.env`、一个 GitHub secret、两者,或都不写——有些 stage 是纯操作),以及 (c) 它是 secret(隐藏输入)还是 public。

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from vinvcn/mattpocock-skills-zh-CN at commit 3f92a83, republished under its MIT licence (© vinvcn). 176 words, ~572 tokens.

Download SKILL.mdSave it as .claude/skills/wizard/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
wizard
description
生成一个交互式 bash wizard,逐步引导人完成只有他们能执行的手动流程。用于 provisioning 基础设施、设置 credentials 或 CI secrets、走查不熟悉的第三方 dashboard,或运行一次性 migration 或 cutover。对于 agent 自己就能执行的步骤,不要调用它。

Wizard

wizard 是一个 bash 脚本,它一步一步引导人完成一项手动流程——这类流程手动做很繁琐,每次重新向 AI 解释一遍也很繁琐。它会打开每个 URL,准确说明该点什么、该复制什么,捕获这些值,把它们写到该去的地方(.env、GitHub secrets),在每个阶段确认,并显示还剩多少个阶段。它可能用于配置第三方服务、运行一次性 migration,或把项目从一种状态迁移到另一种状态。

出色的 UX 已经由 template.sh 解决——逐阶段的进度、confirmation gates、跨平台 URL 打开(含 WSL)、隐藏的 secret 输入、幂等的 .env upserts、gh secret/gh variable 写入,以及收尾 summary。你的工作只是确定流程范围并编写它的各个 stage。 STAGES 标记之上的 library 在每个 wizard 中都完全相同;这种一致性正是重点——永远不要手动编辑它。

Wizard 默认是临时的——为单次运行而构建,保存到 scratch 或 scripts/ 路径,任务完成后删除。只有当用户想要一条应留在 repo 中的可重复 setup 路径时,才 commit 它。

Process

1. Scope the procedure

梳理出人必须执行的每一个手动步骤,以及沿途捕获的每一个值。先读 repo——不要凭空发问:

  • 对于 setup:.env、.env.example、.env.*、README、docker-compose*、framework config,以及 .github/workflows/*(每一处 secrets.* / vars.* 引用都是 wizard 必须产出的一个值)。
  • 对于 migration 或 transition:当前状态、目标状态,以及两者之间不可逆的操作。

然后向用户展示有序的 stages 列表以及每个 stage 产出的值,并确认——他们可能增删或重新排序。

Done when: 每个 stage 都按顺序命名,并且对于每个捕获的值,你知道 (a) 人从哪里获取它,(b) 它写到哪里(.env、一个 GitHub secret、两者,或都不写——有些 stage 是纯操作),以及 (c) 它是 secret(隐藏输入)还是 public。

2. Map each stage's journey

对于每个 stage,写出人遵循的精确路径:打开哪个 URL、在那里做什么、值在哪里显示、它填充哪个变量——例如 "Dashboard → Developers → API keys → Reveal test key → copy"。在你确实不知道当前 UI 或确切命令的地方,如实说明并询问用户或查阅文档——永远不要编造可能不存在的步骤。

Done when: 每个 stage 都能追溯到陌生人也能照做的具体指令。

3. Author the wizard

把 template.sh 复制到目标路径。用每个步骤一个 stage 替换示例 stage,按依赖顺序排列。使用 library helpers——stage、say/step、open_url、ask/ask_secret、write_env、set_secret/set_var、pause/confirm——并把 TOTAL_STAGES 设为你编写的 stage 数量。

守住 template 设定的标准:在索取某个 URL 的值之前先打开它,对任何 secret 使用 ask_secret,对每个持久化的值使用 write_env,只对 CI 确实需要的值使用 set_secret,并在任何不可逆操作之前 confirm。每个 stage 都会清屏,因此只显示当前步骤——让一个 stage 只聚焦一项任务,这样人需要的内容就不会滚出视野。不要触碰标记之上的 library。

4. Verify and hand off
  • bash -n <script>;如果可用则运行 shellcheck。
  • chmod +x <script>。
  • 不要自己端到端运行它——它会打开浏览器并阻塞在人的输入上。改为静态追踪:step 1 中的每个值都被捕获并落到 step 1 所说的位置,并且每个 set_secret 名称都与 CI 中的某处 secrets.* 引用精确匹配。
  • 告诉用户如何运行它。如果它是一条可重复的 setup 路径,就 commit 它并从 README 链接过去,让下一个人运行脚本而不是询问 AI。

© vinvcn, 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 2 other files in skills/engineering/wizard of vinvcn/mattpocock-skills-zh-CN.

  • SKILL.md
  • agents/openai.yaml
  • template.sh

Open the folder on GitHubat commit 3f92a83

Compare with similar skills

Wizard 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.

Wizard compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Wizard this skillvinvcn/mattpocock-skills-zh-CN4.6k—~572Automated safety check: NotesMIT
Mole Bug Patternstw93/Mole69k—~2kAutomated safety check: PassGPL-3.0
CLI DeveloperJeffallan/claude-skills12k1 repos~1.2kAutomated safety check: PassMIT
JSON Processing with jqcharmbracelet/crush29k—~746Automated safety check: PassCustom licence
Segment CreateJanDeDobbeleer/oh-my-posh24k—~1.2kAutomated safety check: PassMIT
Coding AgentTermiX-official/cryptoclaw1008 repos~2.7kAutomated safety check: PassMIT

Similar skills

  • A catalog of recurring bug shapes in the Mole Mac cleaner, used to review safety-sensitive diffs for deletion safety, unbounded commands, shell traps and weak tests.

    69k GitHub stars~2k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • CLI Developer

    Jeffallan/claude-skills

    Walks through designing, building and polishing a command-line tool: user workflow and command hierarchy, implementation in commander, click, typer or cobra, completions and cross-platform testing.

    12k GitHub starsUsed in 1 repo~1.2k tokens
    DevelopmentAuto-check passed
  • JSON Processing with jq

    charmbracelet/crush

    Explains the jq command built into Crush for querying, filtering and reshaping JSON, including its supported flags and where it differs from standard jq.

    29k GitHub stars~746 tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Segment Create

    JanDeDobbeleer/oh-my-posh

    Full scaffolding workflow for creating a new Oh My Posh segment.

    24k GitHub stars~1.2k tokensUpdated today
    DevelopmentAuto-check passed
  • Coding Agent

    TermiX-official/cryptoclaw

    Delegate coding tasks to Codex, Claude Code, or Pi agents via background process.

    100 GitHub starsUsed in 8 repos~2.7k tokens
    DevelopmentAuto-check passed
  • Omm Push

    oh-my-mermaid/oh-my-mermaid

    Push architecture docs to oh-my-mermaid cloud. An agent skill from oh-my-mermaid/oh-my-mermaid.

    2.3k GitHub stars~441 tokensUpdated 6 mo ago
    DevelopmentAuto-check passed

More from vinvcn/mattpocock-skills-zh-CN

All 33 skills in this repo
  • Git Guardrails Claude Code

    vinvcn/mattpocock-skills-zh-CN

    设置 Claude Code hooks,在危险 git commands(push、reset --hard、clean、branch -D 等)执行前阻止它们。适用于用户想防止破坏性 git 操作、添加 git safety hooks,或在 Claude Code 中阻止 git push/reset 时。

    4.6k GitHub stars~474 tokensUpdated 9 days ago
    Auto-check passed
  • Codebase Design

    vinvcn/mattpocock-skills-zh-CN

    用于设计深模块的共享词汇。适用于用户想设计或改进模块接口、寻找深化机会、决定 seam 放在哪里、让代码更容易测试或更适合 AI 导航,或其他技能需要深模块词汇时。

    4.6k GitHub stars~1.1k tokensUpdated 9 days ago
    Auto-check passed
  • Diagnosing Bugs

    vinvcn/mattpocock-skills-zh-CN

    面向棘手缺陷和性能回退的诊断循环。适用于用户说 “diagnose” / “debug this”,或报告某些东西 broken、throwing、failing、slow 时。

    4.6k GitHub stars~1.4k tokensUpdated 9 days ago
    Auto-check passed
  • Domain Modeling

    vinvcn/mattpocock-skills-zh-CN

    构建并打磨项目的领域模型。适用于讨论 codebase 术语、编写或编辑 CONTEXT.md,或记录或编辑 ADR. An agent skill from vinvcn/mattpocock-skills-zh-CN.

    4.6k GitHub stars~505 tokensUpdated 9 days ago
    Auto-check passed
  • Migrate To Shoehorn

    vinvcn/mattpocock-skills-zh-CN

    将测试文件从 as 类型断言迁移到 @total-typescript/shoehorn。适用于用户提到 shoehorn、想替换测试中的 as,或需要局部测试数据时。

    4.6k GitHub stars~619 tokensUpdated 9 days ago
    Auto-check passed
  • PR

    vinvcn/mattpocock-skills-zh-CN

    用于撰写 PR 正文。适用于用户要求起草、改写或改进 PR 正文,或希望 PR 更便于审阅时. An agent skill from vinvcn/mattpocock-skills-zh-CN.

    4.6k GitHub stars~737 tokensUpdated 9 days ago
    Auto-check passed

Works with

Categories

Questions about Wizard

What does Wizard do?

生成一个交互式 bash wizard,逐步引导人完成只有他们能执行的手动流程。用于 provisioning 基础设施、设置 credentials 或 CI secrets、走查不熟悉的第三方 dashboard,或运行一次性 migration 或 cutover。对于 agent 自己就能执行的步骤,不要调用它。. Wizard is an agent skill from vinvcn/mattpocock-skills-zh-CN.

When should I use Wizard?

Wizard fits situations like: development work in your project.

How do I install Wizard in Claude Code?

Run `npx skills add vinvcn/mattpocock-skills-zh-CN --skill wizard -a claude-code`. Or copy the skill folder (skills/engineering/wizard in vinvcn/mattpocock-skills-zh-CN) into .claude/skills/wizard in your project. Claude Code loads it when a task matches its description.

How do I install Wizard in Codex?

Run `npx skills add vinvcn/mattpocock-skills-zh-CN --skill wizard -a codex`. Or copy the skill folder (skills/engineering/wizard in vinvcn/mattpocock-skills-zh-CN) into .agents/skills/wizard in your project. Codex loads it when a task matches its description.

Can I use Wizard 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 vinvcn/mattpocock-skills-zh-CN --skill wizard -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/wizard, .gemini/skills/wizard, .github/skills/wizard and .opencode/skills/wizard in your project.

What does Wizard need to run?

Going by SKILL.md and its folder, Wizard needs a shell for the scripts in its folder and the command-line tools its instructions call (gh and bash). Our summary lists: A Bash shell; Docker.

Does Wizard access the network?

SKILL.md contains no URLs. Its commands use gh, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Wizard safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Wizard use?

Wizard 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 Wizard use?

About 572 tokens (SKILL.md is roughly 2.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Wizard?

Skills that share tags, products or a category with Wizard: Mole Bug Patterns (tw93/Mole, 69k stars), CLI Developer (Jeffallan/claude-skills, 12k stars), JSON Processing with jq (charmbracelet/crush, 29k stars) and Segment Create (JanDeDobbeleer/oh-my-posh, 24k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Wizard?

vinvcn (a GitHub user) maintains it in vinvcn/mattpocock-skills-zh-CN, which has 4,635 GitHub stars. The repository holds 33 skills in this directory. The repository was last updated on September 28, 2026.

Source: vinvcn/mattpocock-skills-zh-CN on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.