Skip to content
Skills Library
AI & agents · Automation

skill-builder

/skill-builder

[UDS] 把重复的手动流程转成范围界定得宜的 Skill,过程中拿捏恰当的流程分量。 Use when: 同一段多步骤流程已经手动做过三次以上、把临时凑出来的 Skill 正式化、决定某个 Skill 该放在哪一层。 Not for: 记录历史事实或项目状态——那属于记忆,不是 Skill;不会再发生的一次性任务。 Keywords: skill, skill builder, process knowledge, repeated process, automation, 技能建立, 流程知识, 自动化, 重复流程.

Licence
MIT
Last repository change
27.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 27.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

[UDS] 把重复的手动流程转成范围界定得宜的 Skill,过程中拿捏恰当的流程分量。 Use when: 同一段多步骤流程已经手动做过三次以上、把临时凑出来的 Skill 正式化、决定某个 Skill 该放在哪一层。 Not for: 记录历史事实或项目状态——那属于记忆,不是 Skill;不会再发生的一次性任务。 Keywords: skill, skill builder, process knowledge, repeated process, automation, 技能建立, 流程知识, 自动化, 重复流程.

Arguments

/skill-builder [process description | 流程描述]
Original author description

[UDS] 把重复的手动流程转成范围界定得宜的 Skill,过程中拿捏恰当的流程分量。 Use when: 同一段多步骤流程已经手动做过三次以上、把临时凑出来的 Skill 正式化、决定某个 Skill 该放在哪一层。 Not for: 记录历史事实或项目状态——那属于记忆,不是 Skill;不会再发生的一次性任务。 Keywords: skill, skill builder, process knowledge, repeated process, automation, 技能建立, 流程知识, 自动化, 重复流程.

How it works

  1. 何时使用
  2. 核心原则
  3. 决策树
  4. 摆放位置决策
  5. 工作流程
  6. 输出检查清单
  7. 参考
Original SKILL.md headings · 136 lines, 437 words
SKILL.md preview
---
name: skill-builder
source: ../../../../skills/skill-builder/SKILL.md
source_version: 1.0.0
translation_version: 1.1.0
last_synced: 2026-08-17
source_hash: 8eee581c49c4
status: current
scope: universal
description: |
  [UDS] 把重复的手动流程转成范围界定得宜的 Skill,过程中拿捏恰当的流程分量。
  Use when: 同一段多步骤流程已经手动做过三次以上、把临时凑出来的 Skill 正式化、决定某个 Skill 该放在哪一层。
  Not for: 记录历史事实或项目状态——那属于记忆,不是 Skill;不会再发生的一次性任务。
  Keywords: skill, skill builder, process knowledge, repeated process, automation, 技能建立, 流程知识, 自动化, 重复流程.
allowed-tools: Read, Glob, Grep, Write, Edit, Bash
argument-hint: "[process description | 流程描述]"
---

# 流程转 Skill 助手

> **语言**: [English](../../../../skills/skill-builder/SKILL.md) | 简体中文

引导你从「我一直在手动做这件事」走到「拥有一个正确构建的 Skill」,并在这一过程中保持适量的流程治理。

## 何时使用

- 你已经用同样的多步骤流程手动执行 ≥ 3 次
- 同事第 3 次问你「我们是怎么做 X 的?」
- 你临时建了一个 Skill,现在想把它正式化

## 核心原则

> Skill 记录的是**流程知识**。Memory 记录的是历史事实。
> 当你注意到自己重复执行相同的步骤时,那就是一个 Skill 候选。

## 决策树

```
New Skill needed?
├── Modifying existing Skill?
│     → Delta path: append ## MODIFIED / ## ADDED to existing SKILL.md
│                   update version field → done
│
├── Answer these 4 questions (any "yes" → Complex):
│     1. More than 7 steps?
│     2. Branching logic between steps (if/else)?
│     3. Requires knowledge from 3+ separate standards/decisions?
│     4. Output directly affects sub-project source code?
│
├── All "no" → Simple path
│     → Fill Skill Brief (templates/SKILL-BRIEF-TEMPLATE.md)
│     → Create SKILL.md directly (no XSPEC needed)
│
└── Any "yes" → Complex path
      → Create XSPEC first → run /sdd
      → Return here after XSPEC Approved

Deprecating a Skill?
  → Add to SKILL.md frontmatter:
      status: deprecated
      deprecated_at: YYYY-MM-DD
      deprecated_reason: "..."
      superseded_by: "/new-skill"   (if applicable)
  → Mark archived in SKILL-CANDIDATES.md
```

## 摆放位置决策

在创建 SKILL.md 前,先决定它应该放在哪里:

| 条件 | 摆放位置 |
|-----------|-----------|
| 步骤引用项目特定路径(如 TECH-RADAR.md、DEC-*.md) | 项目:`{project}/.claude/skills/` |
| 步骤为通用流程(无项目特定路径) | UDS:`skills/{name}/` + zh-TW locale |

## 工作流程

### Step 1 — 描述流程

捕捉重复的步骤序列:
- 哪些步骤?按什么顺序?
- 目前手动执行过几次?
- 触及哪些工具或文件?

### Step 2 — 更新 SKILL-CANDIDATES.md

打开你项目的 `SKILL-CANDIDATES.md`(首次请从 `templates/SKILL-CANDIDATES.md` 复制):
- 尚未记录 → 新增一行,填入当前次数
- 已记录 → 增加次数
- 次数达到 3 → 标记 trigger ✅,继续执行

### Step 3 — 选择路径(Simple / Complex / Delta)

回答这 4 个判断问题。确定:Simple、Complex 或 Delta。

### Step 4a — Simple:填写 Skill Brief

使用 `templates/SKILL-BRIEF-TEMPLATE.md`:
- 触发情境(何时会用到?)
- 核心步骤(3 ~ 7 个,有顺序)
- 验收条件(2 ~ 3 条)
- 范围外(明确边界)

### Step 4b — Complex:创建 XSPEC

执行 `/sdd` 创建 XSPEC。XSPEC Approved 之后回到 Step 5。

### Step 4c — Delta:识别变更范围

识别现有 SKILL.md 中哪些区段需要变更。
在文件末尾加入 `## MODIFIED Requirements` 或 `## ADDED Requirements`。

### Step 5 — 创建 / 更新 SKILL.md

依据 Brief 或 XSPEC 生成 SKILL.md:
- 确认 frontmatter:`name`、`scope`、`description`、`allowed-tools`
- UDS 通用 Skill:同步创建 zh-TW locale 版本
- 项目 Skill:放在 `{project}/.claude/skills/{name}/SKILL.md`

### Step 6 — 更新 SKILL-CANDIDATES.md

将候选行标记为:trigger ✅、Skill 列填写完成。

### Step 7 — Commit

```
feat(skills): Add /{skill-name} skill. 新增 /{skill-name} Skill。

{English description, 1-2 lines}

{Chinese description, 1-2 lines}

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
```

## 输出检查清单

完成所有步骤后,请确认:

- [ ] `SKILL-CANDIDATES.md` 已更新(trigger ✅、Skill 名称已填)
- [ ] `SKILL.md` 已创建并具备完整 frontmatter(`name` / `scope` / `description` / `allowed-tools`)
- [ ] Simple 路径:Skill Brief 已引用或保留
- [ ] Complex 路径:XSPEC ID 已记录在 SKILL.md header comment 中
- [ ] UDS skill:已创建 zh-TW locale 文件
- [ ] 棄用(Deprecated):frontmatter 含 `status: deprecated`
- [ ] git commit 已完成

## 参考

- Skill Brief 模板:[templates/SKILL-BRIEF-TEMPLATE.md](../../../../templates/SKILL-BRIEF-TEMPLATE.md)
- 候选追踪:[templates/SKILL-CANDIDATES.md](../../../../templates/SKILL-CANDIDATES.md)(请复制到你的项目)
- ADR 标准:[core/adr-standards.md](../../core/adr-standards.md)

Versions

RepositoryScoreLicence
This page · AsiaOstrich/universal-dev-standards100MIT
x85446/claudecodetricks100MIT
boshu2/agentops100Apache-2.0
dreamlab-ai/agentbox100AGPL-3.0
AsiaOstrich/universal-dev-standards100MIT
AsiaOstrich/universal-dev-standards100MIT
amazon-quick/amazon-quick-official-catalog100MIT
AsiaOstrich/universal-dev-standards100MIT
agentflocks/flocks100Apache-2.0

Database snapshot: 13.11.2026 · package version 9ec1519bf5fc (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100skill-capture
    Turn a recurring in-session workflow into a reusable Claude Code skill. Load this the moment you notice you have run the SAME multi-step sequence (same ordered steps or commands, small variation allowed) about three times in the current session, or when open candidates are…
  • 100bm-skill-builder
    Build a new agent skill (or restructure an existing one) following Builder Methods conventions. Use when the user wants to create a skill, turn a repeatable process into a skill, or restructure a skill that has outgrown its shape — "create a skill", "make this a skill", "turn my…
  • 100skillify
    Turn a repeated multi-step workflow into a user skill for Claude Code and Codex; use when asked to make it a skill.
  • 100sam-template-builder
    Build sam template builder operations. Auto-activating skill for AWS Skills. Triggers on: sam template builder, sam template builder Part of the AWS Skills skill category. Use when working with sam template builder functionality. Trigger with phrases like "sam template builder",…
  • 100learning-to-rule-or-skill
    Use when a repeated learning, mistake, or successful pattern should be turned into a new rule or skill. Also use after completing a task to capture learnings from the work.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.