القائمة
建立符合官方規格的 Claude Code skill：蒐集需求、產出正確格式的 SKILL.md、驗證命名與描述規則、套用 Progressive Disclosure 結構。適合在新增 skill 或 slash command 時使用。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
分析 claude.com/blog 的新文章，提取可操作洞察並更新 workspace 設定。手動調用。
分析當前專案的 Claude Code session 資料，產出 context 效率報告（模型用量、工具效率、委派比例、TodoWrite 使用率）。搭配 context-management.md 使用。
冷啟新 session：掃描 codebase 結構並讀取 README，快速建立專案 context。適合在陌生 repo 或新 session 開始時使用。
追蹤並計算當前 session 的 Token 使用量和花費（USD）。產出前後對比報告，幫助使用者了解 workspace 優化的實際效益。
研究外部 Claude Code best practice 來源（GitHub repos、官方 docs、blog），對比現有 workspace 做 gap analysis，產出可操作建議清單。
大型功能開發前，讓 Claude 用 AskUserQuestionTool 深度訪問你（技術、UI/UX、風險、取捨），產出完整 spec，再開新 session 執行。適合在複雜功能實作前、需求模糊時、或開始新專案架構設計時使用。
استنادا إلى تصنيف SOC المهني
| name | add-skill |
| description | 建立符合官方規格的 Claude Code skill：蒐集需求、產出正確格式的 SKILL.md、驗證命名與描述規則、套用 Progressive Disclosure 結構。適合在新增 skill 或 slash command 時使用。 |
| disable-model-invocation | true |
| context | fork |
優先抓取官方文件，確保符合目前規格：
WebFetch: https://docs.anthropic.com/en/claude-code/skills
若失敗，用 WebSearch：Claude Code skills SKILL.md format site:docs.anthropic.com
從使用者取得（或直接從 prompt 解析）：
~/.claude/skills/{skill-name}/（所有專案可用）.claude/skills/{skill-name}/（僅此 repo，git 版控）processing-pdfs、testing-code）{base-path}/skills/{skill-name}/
├── SKILL.md # 必要：主指令（<500 行）
├── config.json # 可選：使用者設定（首次啟動時填寫）
├── scripts/ # 可選：給 Claude 組合用的腳本與函式庫
│ └── main.py
└── references/ # 可選：詳細文件（只能一層）
└── examples.md
Thariq 原則（T3）：Skill 是資料夾，不只是 markdown 檔案。SKILL.md 告訴 Claude「這個資料夾裡有什麼」，Claude 會在適當時機讀取子檔案。把 API 參考、範例、腳本放進資料夾，讓 SKILL.md 保持精簡 — 這就是 Progressive Disclosure。
Thariq 原則（T8）：在
scripts/放好腳本讓 Claude 組合使用，Claude 的每個 turn 就能專注在「該做什麼」，不必從頭重寫 boilerplate。
Thariq 原則（T7）：需要跨 session 儲存 skill 資料時，用
${CLAUDE_PLUGIN_DATA}路徑，而非 skill 目錄本身（skill 升級時目錄可能被覆蓋）。
必要 frontmatter（與本 workspace 慣例一致）：
---
name: {skill-name}
description: {第三人稱說明，包含「做什麼」和「何時用」}
disable-model-invocation: true
context: fork
---
正文結構：
# {Skill 標題}
## 觸發條件
...
## 執行步驟
...
## 輸出格式
...
## Gotcha（注意事項）
...
草稿完成後計算行數，若超過 500 行：
references/{topic}.md（只能一層，不能再嵌套）ls -la .claude/skills/{skill-name}/
processing-pdfs、testing-code- 開頭/結尾、連續 --、保留字（anthropic、claude）helper、utils、tools）好的範例：
description: 從 PDF 提取文字和表格、填寫表單、合併文件。適合在處理 PDF 檔案或使用者提到 PDF、表單、文件提取時使用。
差的範例：「幫助處理文件」、「處理資料」
Thariq 原則（T6）：description 欄位是給模型看的，不是給人看的說明文字。Claude Code 啟動時掃描所有 skill 的 description 來決定「現在要用哪個 skill？」— 寫觸發條件，不要寫功能摘要。
| 自由度 | 適用時機 | 範例 |
|---|---|---|
| 高（文字指引） | 多種有效做法都可接受 | Code review 指引 |
| 中（虛擬碼/參數） | 有偏好模式但有彈性 | 報告產出模板 |
| 低（精確腳本） | 操作脆弱、需一致性 | 資料庫遷移 |
Skill 可以在 SKILL.md 中宣告 hook，這些 hook 只在 skill 被呼叫時啟用，session 結束後自動移除。適合「只在特定情境需要的強烈限制」：
範例：
## Hooks（本 Skill 啟動時自動生效）
- PreToolUse(Bash): 阻擋 rm -rf、DROP TABLE、force push、kubectl delete
→ 保護性模式，適合生產環境操作
- PreToolUse(Edit): 只允許修改 /docs/** 目錄
→ 文件限制模式，防止誤改程式碼
這讓你可以有 /careful、/freeze 等「安全模式 skill」，平時不影響日常工作，呼叫時才啟用防護。
<details> 折疊disable-model-invocation: true 和 context: fork.claude/skills/deep-review/SKILL.md、.claude/skills/research-best-practices/SKILL.md