Agent Skill
2/7/2026skill-creator
引導式建立新 Skill 的完整工作流
M
miles990
0GitHub Stars
1Views
npx skills add miles990/evolve-plugin
SKILL.md
| Name | skill-creator |
| Description | 引導式建立新 Skill 的完整工作流 |
name: skill-creator version: 1.0.0 description: 引導式建立新 Skill 的完整工作流 triggers: [new-skill, create-skill, 建立skill, 新增skill]
Skill Creator
完整工作流:引導式訪談 → 分析生成 → 驗證 → Token 優化 → 發布到 GitHub
使用方式
/evolve --new-skill "skill 名稱"
五階段流程
Stage 1: 引導式訪談
向使用者提問,收集需求:
- 問題定義:這個 skill 要解決什麼問題?
- 目標使用者:新手 / 進階 / 專家?
- 前置需求:需要什麼 MCP servers 或 CLI tools?
- 參考來源:有沒有類似的 skill 可以參考?
輸出:內部需求文件
Stage 2: 分析 + 生成
搜尋順序:
- 優先搜尋官方 Skill Repos:
- claude-domain-skills — 領域知識 skills
- claude-software-skills — 軟體開發 skills
- 如無適合,搜尋 GitHub 上其他 skills
- 如都無適合參考,使用 4C 方法自行研究:
- 載入
methodology/knowledge-acquisition-4cskill(from claude-domain-skills) - Collect:WebSearch / WebFetch 收集官方文檔、最佳實踐
- Curate:篩選高品質來源,去除噪音
- Contextualize:分析領域核心概念和常見流程
- Codify:整理成 skill 可用的知識結構
- 載入
生成流程:
- 選擇適合的範本(basic / advanced)
- 生成 SKILL.md 初稿
- 建立目錄結構(如需要 scripts/templates)
輸出:完整的 skill 目錄
Stage 3: 驗證
檢查清單:
- SKILL.md frontmatter 格式正確
- 必要欄位存在(name, description, version)
- 模擬使用情境,確認指令清楚
- 如有 scripts,確認可執行
輸出:驗證報告
Stage 3.5: Token 優化
使用 skill-optimizer 優化新建立的 skill:
-
分析 token 效率:
- 檢查總行數(目標 < 300 行)
- 計算核心內容佔比(目標 > 70%)
- 識別可外連的內容(大型範例、ASCII 圖表、模板)
-
執行優化:
- 大型 ASCII 圖表 → 簡化為單行描述
- 完整範例(> 20 行)→ 外連至
extended/examples.md - 模板(> 10 行)→ 外連至
extended/templates.md - 配置範例 → 外連至擴展檔案
-
建立分層結構(如需要):
skill-name/ ├── SKILL.md # 核心層 (< 300 行) └── extended/ # 擴展層 (按需載入) ├── examples.md └── templates.md -
驗證優化結果:
- 優化前後行數比較
- 確認功能完整性未受影響
輸出:優化報告(節省 X% tokens)
Stage 4: 發布到 GitHub
- 詢問:建立新 repo 或加入現有 repo?
- 生成 README.md
- git init + commit + push
- 輸出安裝指令
輸出:
✅ Skill 已發布!
GitHub: https://github.com/<user>/<repo>
安裝: /plugin install <user>/<repo>
範本選擇指南
| 情況 | 範本 |
|---|---|
| 簡單指令、無依賴 | basic-skill.md |
| 需要 MCP、有複雜流程 | advanced-skill.md |
驗證腳本
./scripts/validate-skill.sh <skill-directory>
發布腳本
./scripts/publish-skill.sh <skill-directory> [--new-repo]
Plugin 格式轉換
將 Skills 倉庫轉換為 Claude Code Plugin Marketplace 格式:
./scripts/convert-to-plugin.sh <skills-repo-path> [--marketplace|--category]
模式:
--marketplace:建立 marketplace.json,頂層目錄成為 plugin(推薦)--category:為每個頂層分類建立獨立的 plugin.json
範例:
# 轉換整個 Skills 倉庫為 marketplace
./scripts/convert-to-plugin.sh ~/Workspace/my-skills --marketplace
# 輸出:
# ✅ marketplace.json 已建立
# ✅ 各分類 plugin.json 已建立
#
# 安裝指令:
# /plugin marketplace add <user>/my-skills
# /plugin install <plugin-name>@my-skills
Skills Info
Original Name:skill-creatorAuthor:miles990
Download