skill-builder
/skill-builder
[UDS] Turn a repeated manual process into a properly scoped Skill, with the right amount of process along the way. Use when: the same multi-step sequence has been done manually three or more times, formalising an ad-hoc Skill, deciding where a Skill belongs. Not for: recording historical facts or project state — that belongs in memory, not a Skill; one-off tasks that will not recur. Keywords: skill, skill builder, process knowledge, repeated process, automation, 技能建立, 流程知識, 自動化.
- Author
- AsiaOstrich ↗
- Repository
- universal-dev-standards ↗
- Licence
- MIT
- Last repository change
- 27.10.2026
Assessment and security
- Files in this package
- 1
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 27.10.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
[UDS] Turn a repeated manual process into a properly scoped Skill, with the right amount of process along the way. Use when: the same multi-step sequence has been done manually three or more times, formalising an ad-hoc Skill, deciding where a Skill belongs. Not for: recording historical facts or project state — that belongs in memory, not a Skill; one-off tasks that will not recur. Keywords: skill, skill builder, process knowledge, repeated process, automation, 技能建立, 流程知識, 自動化.
Arguments
/skill-builder [process description | 流程描述]
Original author description
[UDS] Turn a repeated manual process into a properly scoped Skill, with the right amount of process along the way. Use when: the same multi-step sequence has been done manually three or more times, formalising an ad-hoc Skill, deciding where a Skill belongs. Not for: recording historical facts or project state — that belongs in memory, not a Skill; one-off tasks that will not recur. Keywords: skill, skill builder, process knowledge, repeated process, automation, 技能建立, 流程知識, 自動化.
How it works
- When to Use
- Core Principle
- Decision Tree
- Placement Decision
- Workflow
- Output Checklist
- References
SKILL.md preview
---
name: skill-builder
scope: universal
description: |
[UDS] Turn a repeated manual process into a properly scoped Skill, with the right amount of process along the way.
Use when: the same multi-step sequence has been done manually three or more times, formalising an ad-hoc Skill, deciding where a Skill belongs.
Not for: recording historical facts or project state — that belongs in memory, not a Skill; one-off tasks that will not recur.
Keywords: skill, skill builder, process knowledge, repeated process, automation, 技能建立, 流程知識, 自動化.
allowed-tools: Read, Glob, Grep, Write, Edit, Bash
argument-hint: "[process description | 流程描述]"
---
# Process-to-Skill Assistant
> **Language**: English | [繁體中文](../../locales/zh-TW/skills/skill-builder/SKILL.md) | [简体中文](../../locales/zh-CN/skills/skill-builder/SKILL.md)
Guides you from "I keep doing this manually" to a properly built Skill,
with the right amount of process along the way.
## When to Use
- You've done the same multi-step sequence ≥ 3 times manually
- A teammate asks "how do we do X again?" for the 3rd time
- You built a Skill ad-hoc and want to formalize it
## Core Principle
> A Skill records **process knowledge**. Memory records historical facts.
> When you notice yourself executing the same steps repeatedly, that's a Skill candidate.
## Decision Tree
```
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
```
## Placement Decision
Before creating SKILL.md, decide where it belongs:
| Condition | Placement |
|-----------|-----------|
| Steps reference project-specific paths (e.g. TECH-RADAR.md, DEC-*.md) | Project: `{project}/.claude/skills/` |
| Steps are universal (no project-specific paths) | UDS: `skills/{name}/` + zh-TW locale |
## Workflow
### Step 1 — Describe the Process
Capture the repeated sequence:
- What steps, in what order?
- How many times done manually so far?
- What tools or files does it touch?
### Step 2 — Update SKILL-CANDIDATES.md
Open your project's `SKILL-CANDIDATES.md` (copy from `templates/SKILL-CANDIDATES.md` if first time):
- Not yet recorded → add row, fill current count
- Already recorded → increment count
- Count reached 3 → mark trigger ✅, proceed
### Step 3 — Choose Path (Simple / Complex / Delta)
Answer the 4 judgment questions. Determine: Simple, Complex, or Delta.
### Step 4a — Simple: Fill Skill Brief
Use `templates/SKILL-BRIEF-TEMPLATE.md`:
- Trigger context (when would you use this?)
- Core steps (3–7, ordered)
- Acceptance Criteria (2–3 items)
- Out of scope (explicit boundaries)
### Step 4b — Complex: Create XSPEC
Run `/sdd` to create XSPEC. Return to Step 5 after XSPEC is Approved.
### Step 4c — Delta: Identify Change Scope
Identify which sections of the existing SKILL.md change.
Add `## MODIFIED Requirements` or `## ADDED Requirements` at the end.
### Step 5 — Create / Update SKILL.md
Generate SKILL.md from the Brief or XSPEC:
- Verify frontmatter: `name`, `scope`, `description`, `allowed-tools`
- For UDS skills: create zh-TW locale version too
- For project skills: place in `{project}/.claude/skills/{name}/SKILL.md`
### Step 6 — Update SKILL-CANDIDATES.md
Mark the candidate row: trigger ✅, Skill column filled.
### 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>
```
## Output Checklist
After completing all steps, verify:
- [ ] `SKILL-CANDIDATES.md` updated (trigger ✅, Skill name filled)
- [ ] `SKILL.md` created with complete frontmatter (`name`/`scope`/`description`/`allowed-tools`)
- [ ] Simple path: Skill Brief referenced or preserved
- [ ] Complex path: XSPEC ID noted in SKILL.md header comment
- [ ] UDS skill: zh-TW locale file created
- [ ] Deprecated: `status: deprecated` in frontmatter
- [ ] git commit completed
## References
- Skill Brief template: [templates/SKILL-BRIEF-TEMPLATE.md](../../templates/SKILL-BRIEF-TEMPLATE.md)
- Candidate tracking: [templates/SKILL-CANDIDATES.md](../../templates/SKILL-CANDIDATES.md) (copy to your project)
- ADR standards: [core/adr-standards.md](../../core/adr-standards.md)
Versions
| Repository | Score | Licence |
|---|---|---|
| This page · AsiaOstrich/universal-dev-standards | 100 | MIT |
| x85446/claudecodetricks | 100 | MIT |
| boshu2/agentops | 100 | Apache-2.0 |
| dreamlab-ai/agentbox | 100 | AGPL-3.0 |
| AsiaOstrich/universal-dev-standards | 100 | MIT |
| AsiaOstrich/universal-dev-standards | 100 | MIT |
| amazon-quick/amazon-quick-official-catalog | 100 | MIT |
| AsiaOstrich/universal-dev-standards | 100 | MIT |
| agentflocks/flocks | 100 | Apache-2.0 |
Database snapshot: 13.11.2026 · package version e20c048656b3 (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. - 100skill-creator
Create, improve, and evaluate agent skills (SKILL.md plus reference files). Use this skill whenever the user wants to build, scaffold, or design a new skill, improve or fix an existing skill that isn't working well, score or benchmark a skill's quality or run evals on it, or… - 100skill-from-practice
Turn a way of working proven in practice into a new skill. Use when a procedure no skill covers has worked at least three times, confirmed by results or the user.