---
name: skill-new
description: Create a new skill in the jsc skill set. Ask skill details via decision tree, generate the skill under the right jsc-{domain} per guidelines.md (create the domain from the template repo if missing), then open a PR via jsc-git pr. Use when the user wants to add a skill; not for editing an existing one (use skill-update).
---

# skill-new — 新建技能

準則單一來源：[`../../references/guidelines.md`](../../references/guidelines.md)。

## 流程

1. 依 `jsc-ask:ask` 決策樹詢問技能細節，直到沒有疑慮：
   - 目標（單一、與既有技能不重複——先掃 `jsc-*/skills/*/SKILL.md` 列出相近技能供比對，選項需標明「複用既有」與「新建」的影響範圍）
   - 觸發時機（何時用、何時不用、觸發關鍵字）
   - 輸入與輸出（是否有標準輸入輸出可下放 `tools/`；是否需要 gitea 操作——需要就讓技能使用 `jsc-gitea/tools/gitea.sh` + token）
   - 所屬 domain（列出現有 `jsc-*` 供選擇）
2. 若 domain 不存在：
   1. 為其想一個簡短的英文代表詞（一個單字為佳），與使用者確認。
   2. 請使用者建立存取庫 `plugins/{domain}`，clone 後依 `https://gitea.jsc.idv.tw/plugins/template` 的結構建立內容：三份 plugin manifest（plugin 名 `jsc-{domain}`）、自身的 `.claude-plugin/marketplace.json` 與 `.agents/plugins/marketplace.json`（marketplace 名 = `{domain}`）、`skills/`、README.md、AGENTS.md。
3. 依 guidelines.md 產生技能（此步驟**必須以 sub agent 執行**）：
   - `skills/{name}/SKILL.md`：英文 description（≤ 5 句、含觸發時機）、STE100 繁中內文
   - 可 hook 的規則放 `jsc-hooks`（不可散落本 domain）；標準輸入輸出流程放 `tools/`
   - 同步該 domain README 的「Skills 目錄」、三份 manifest 的 version bump
4. 依 guidelines.md「審核檢查清單」逐項自檢，不符就修正。
5. 呼叫 `jsc-git:pr` 建立 Push Request。