Skip to content
Skills Library
AI & agents · Automation

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, 技能建立, 流程知識, 自動化.

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] 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

  1. When to Use
  2. Core Principle
  3. Decision Tree
  4. Placement Decision
  5. Workflow
  6. Output Checklist
  7. References
Original SKILL.md headings · 137 lines, 624 words
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

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

Feedback and reports

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