Anthropic 內部曝光:數百個 Skills 的實戰秘訣,Claude Code 效率直接起飛!
整理版優先睇
Anthropic內部曝光:數百個Skills實戰秘訣,Claude Code效率直接起飛
呢篇文章係由志輝寫嘅,佢本身係10年大數據架構,而家專注AI編程。佢用咗Claude Code一段時間,發現重複操作好多,每次新項目都要重新交代偏好設定。於是佢深入研究咗Skills呢個功能,仲參考咗Anthropic官方團隊公開嘅內部經驗,整理出呢篇實戰分享。文章想解決嘅問題係:點樣透過Skills令Claude Code由「識做」變成「做得專業」,將專家經驗封裝成可重用嘅能力模塊。整體結論係:Skills係Claude Code生態最被低估嘅功能,透過記錄「踩坑」經驗、善用文件夾結構、寫啱Description觸發條件,可以大幅提升效率。
文章詳細解釋咗Skills嘅本質——唔係一個Markdown文件,而係一個包含指令、腳本、資源、工具配置嘅文件夾,入面有SKILL.md做主入口。Anthropic內部將Skills分成9大類型,包括庫API參考、產品驗證、數據分析、業務流程自動化等。作者仲分享咗寫好Skills嘅6個秘訣,例如唔好寫廢話、一定要有Gotchas章節、用文件夾做漸進式信息披露等。
最後,文章提供咗實操例子(用Skills生成PPT)同分發方法,仲附送咗精選資源清單,涵蓋官方、社區、出海SaaS同內容創作等範疇。對想用好Claude Code嘅開發者嚟講,呢篇係好實用嘅指南。
- Skills係模塊化技能包,唔係一個文件而係一個文件夾,入面有SKILL.md做主入口,可以自動或手動觸發。
- Anthropic內部Skills分9大類型:庫API參考、產品驗證、數據分析、業務流程自動化、代碼腳手架、代碼質量審查、CI/CD部署、運維手冊、基礎設施運維。
- 寫好Skills嘅6個秘訣:唔好寫廢話、一定要有踩坑記錄(Gotchas章節)、善用文件夾分層信息、唔好管太死、Description要寫觸發條件(唔係摘要)、透過存儲數據俾記憶。
- Skills可透過項目.claude/skills/目錄或插件市場分享,企業可用managed settings推送畀全組織。
- Skills本質係SOP手冊,凡是能沉澱成SOP嘅工作都可以做成Skills,係將專家經驗封裝成可重用能力嘅新工作方式。
anthropics/skills — 官方Skills合集
Anthropic官方出品的Skills合集,最權威,必裝。
openai/skills — OpenAI Skills
OpenAI的Skills,跨平台借鑑意義大。
iamzhihuix/happy-claude-skills — 作者維護的Skills合集
作者自己維護的Skills合集,適合入門。
neondatabase/agent-skills — Neon Serverless數據庫
適合出海SaaS開發者,對標Neon Serverless數據庫。
Skills係乜?點解咁重要?
好多人都以為Skills只係Markdown文件,其實大錯特錯。Skills係封裝好「指令 + 腳本 + 資源 + 工具配置」嘅模塊化單元,簡單講就係俾Claude裝上專業技能包。而且Skills遵循Agent Skills開放標準,唔只Claude Code用得,Claude Desktop都支援,未來仲會有更多AI工具接入。
Skills 不是一個文件,而是一個文件夾。每個Skill嘅入口係SKILL.md文件,用YAML配置話俾Claude知幾時用、點用。
Skills有兩種使用方式:自動觸發(Claude發現相關Skill會主動加載)同手動調用(直接輸入 /skill-name)。Claude Code自身內置咗幾個Skill,例如 /batch 將大規模代碼修改拆成多個並行子任務,/simplify 審查代碼找出可優化位,/debug 排查當前會話問題,/loop 定時循環執行操作。
Anthropic內部9大Skills類型
Anthropic團隊將內部數百個Skills分成9個類型,呢度整理成中文方便大家對號入座:
- 1 庫與API參考類:教Claude正確使用某個庫或SDK,特別係容易搞錯嘅庫,將常見坑同正確用法打包。
- 2 產品驗證類:搭配Playwright等工具自動跑測試流程,例如自動完成註冊→驗證郵箱→引導流程。Anthropic話值得一個工程師花一週專門打磨驗證類Skills。
- 3 數據獲取與分析類:連接數據系統,話俾Claude去邊查數據、點查、常用查詢模式。
- 4 業務流程自動化類:一條命令搞定重複工作,例如自動聚合GitHub活動加工單系統生成站會彙報。
- 5 代碼腳手架類:自動生成項目模板,新建一個服務時認證、日誌、部署配置全部預配好。
- 6 代碼質量與審查類:自動代碼審查,最勁係adversarial-review——生成一個全新視角嘅子Agent嚟挑剔,反覆迭代到淨返無關痛癢嘅小問題。
- 7 CI/CD與部署類:監控PR、重試唔穩定CI、解決合併衝突、自動回滾,全自動化。
- 8 運維手冊類:俾一個告警或錯誤,自動行排查流程,輸出結構化報告。
睇到冇?Skills能覆蓋嘅場景遠比想像中多,唔止係生成PPT咁簡單。
寫好Skills嘅6個秘訣
呢度係Anthropic團隊總結嘅實戰經驗,最值錢嘅部分。
秘訣1:唔好寫廢話
Claude本身就好識編程,你嘅Skill應該聚焦喺嗰啲可以將Claude由常規思維推出來嘅資訊。例如官方frontend-design Skill,專門教Claude避免用Inter字體加紫色漸變呢啲AI味太濃嘅設計。
秘訣2:一定要有「踩坑記錄」——呢個係成個Skill資訊含量最高嘅部分
每次Claude犯錯,就將個錯誤記到Gotchas章節裏面。日積月累,你嘅Skill就會愈來愈穩。
秘訣3:善用文件夾做漸進式信息披露——唔好將所有嘢塞入一個Markdown文件,將詳細API簽名放references/api.md,模板放assets/目錄
Claude需要嘅時候會自己去讀,文件系統就係一種上下文工程手段。
秘訣4:唔好管Claude太死——Skills複用性強,指令太具體會令Claude喺唔同場景下變得好僵硬,俾資訊同靈活度就得
秘訣5:Description係俾模型睇嘅觸發器,唔係摘要——Claude Code啓動時會掃描所有Skills嘅description嚟判斷「呢個請求該唔該調用呢個Skill」,所以要寫「幾時觸發」而唔係「呢個Skill係乜」
順便提下,SKILL.md嘅frontmatter仲有幾個實用配置:disable-model-invocation: true 可以禁止Claude自動調用(部署、發佈呢類有副作用嘅操作建議一定要開),allowed-tools 限制Skill運行時能用嘅工具(例如只讀分析Skills只俾Read、Grep權限),context: fork 喺獨立子Agent中運行唔污染主對話上下文。
秘訣6:讓Skills擁有記憶——喺Skill目錄中存儲數據,Claude可以讀取自己嘅歷史
例如一個發站會彙報嘅Skill,維護一個standups.log,下次運行時Claude自動對比昨日記錄,只彙報有變化嘅部分。
實戰體驗:用Skills生成PPT同自定義Skills
作者用Skills做過一個直觀實驗——用pptx Skill生成PPT。安裝好插件後,直接話俾Claude想要一個關於Claude Skills功能嘅10頁PPT,Claude會自動調用pptx Skill,生成HTML再轉成pptx格式。中間有錯Claude Code會自動重試,斷咗輸入「繼續」就得。最後生成嘅PPT有內容有結構,流程可以複用。
能夠被抽象成Skills嘅特點:功能稍微複雜、獨立嘅小單元、有固定流程或難點。
點樣分發同管理Skills?
Skills有三層存儲結構:個人層級 (~/.claude/skills/,你所有項目都能用)、項目層級 (.claude/skills/,僅當前項目)、插件層級(通過插件市場安裝,按需啟用)。優先級從高到低:企業 > 個人 > 項目。同名Skill,高優先級會覆蓋低優先級。
分享Skills主要有兩種方式:提交到代碼倉庫(放.claude/skills/目錄下push去Git,團隊成員pull就用得)或者發佈到插件市場(創建marketplace.json定義插件列表,團隊用/plugin marketplace add添加市場然後按需安裝)
Anthropic做法係冇專門審核團隊,而係讓好嘅Skills自然浮現——先放沙盒俾人試用,有人用了有效果再正式上架。企業用戶可以透過managed settings將Skills推送畀全組織統一管理。
結語:Skills代表新嘅工作方式
Skills係Claude Code生態最被低估嘅功能。Anthropic內部數百個Skills經驗總結出:最好嘅Skills乾淨俐落地歸入一個類別;Gotchas章節係靈魂;Skills係文件夾唔係文件;Description係觸發器;由細開始,多數好Skills最初得幾行。
Skills本質上就係SOP手冊——專家經驗封裝成可複用嘅能力模塊,讓AI Agent喺專家肩膀上工作
判斷標準好簡單:凡是能沉澱成SOP手冊嘅工作,就可以做成Skills。代碼審查有SOP?做成Skill。文檔排版有SOP?做成Skill。部署上線有SOP?做成Skill。咁樣諗,身邊能做成Skills嘅嘢突然多咗好多!
自動觸發:你正常對話,Claude發現有相關Skill就會主動加載 手動調用:直接輸入 /skill-name,就好似斜槓命令咁
冇Skills → Claude "會做" PPT,但做出嚟可能好粗糙 有咗Skills → Claude "做得專業",因為Skills裏面裝住經過反覆測試嘅最佳方法


disable-model-invocation: true → 禁止Claude自動調用,只能手動 /skill-name 觸發。部署、發佈呢類有副作用嘅操作,建議一定要開呢個 allowed-tools → 限制Skill運行時可以用嘅工具。例如做個唯讀分析嘅Skill,只俾Read、Grep權限 context: fork → 喺獨立嘅子Agent中運行,唔污染主對話上下文

/plugin marketplace add anthropics/skills創建一個關於 Claude Skills 功能的 PPT,大概 10 頁,
包含背景介紹、使用場景、安裝方法、自定義創建和未來趨勢令Claude Code分析你嘅Word樣本,提取排版樣式 用 skill-creator 將呢啲樣式封裝成一個Skill 以後只要講"按XX格式生成文檔",Claude就會自動套用
提交到代碼倉庫:將Skills放喺項目嘅 .claude/skills/ 目錄下,push到Git,團隊成員pull落嚟就可以用 發佈到插件市場:創建一個 marketplace.json,定義你嘅插件列表同來源,團隊成員用 /plugin marketplace add 添加市場,然後按需安裝
最好嘅Skills乾淨利落地歸入一個類別,唔好貪多 Gotchas章節係靈魂,不斷累積Claude嘅犯錯經驗 Skills係文件夾,唔係文件,善用目錄結構做資訊分層 Description係觸發器,唔係摘要 由細開始,大多數好用嘅Skills最初得幾行,後來不斷補充先變得強大
anthropics/skills — Anthropic官方出品,最權威嘅Skills合集,一定要裝 openai/skills — OpenAI嘅Skills,跨平台借鑑意義好大 iamzhihuix/happy-claude-skills — 我自己維護嘅Skills合集,歡迎大家Star ⭐
neondatabase/agent-skills — Neon Serverless數據庫 supabase/agent-skills — Supabase全棧後端 stripe/ai/skills — Stripe支付集成 cloudflare — Cloudflare生態相關
JimLiu/baoyu-skills — 首推! 寶玉老師嘅Skills,覆蓋公眾號、小紅書、封面圖、翻譯等內容創作全流程 typefully/agent-skills — Twitter/X發帖相關 remotion-dev/skills — Remotion影片製作
VoltAgent/awesome-agent-skills — 社區優質Agent Skills合集,按類別整理,持續更新。收藏呢一個,等於收藏咗成個Skills生態。
Thariq: Lessons from Building Claude Code: How We Use Skills Anthropic官方Skills博客 Claude Code Skills官方文檔 插件市場官方文檔 Agent Skills入門課程(Skilljar) Skills案例倉庫
自動觸發:你正常對話,Claude 發現有相關 Skill 就會主動加載 手動調用:直接輸入 /skill-name,就像斜槓命令一樣
沒有 Skills → Claude "會做" PPT,但做出來可能很粗糙 有了 Skills → Claude "做得專業",因為 Skills 裏裝着經過反覆測試的最佳方法


disable-model-invocation: true → 禁止 Claude 自動調用,只能手動 /skill-name 觸發。部署、發佈這類有副作用的操作,建議必須開這個 allowed-tools → 限制 Skill 運行時能用的工具。比如做個只讀分析的 Skill,只給 Read、Grep 權限 context: fork → 在獨立的子 Agent 中運行,不污染主對話上下文

/plugin marketplace add anthropics/skills創建一個關於 Claude Skills 功能的 PPT,大概 10 頁,
包含背景介紹、使用場景、安裝方法、自定義創建和未來趨勢讓 Claude Code 分析你的 Word 樣本,提取排版樣式 用 skill-creator 把這些樣式封裝成一個 Skill 以後只要說"按 XX 格式生成文檔",Claude 就自動套用
提交到代碼倉庫:把 Skills 放在項目的 .claude/skills/ 目錄下,push 到 Git,團隊成員 pull 下來就能用 發佈到插件市場:創建一個 marketplace.json,定義你的插件列表和來源,團隊成員用 /plugin marketplace add 添加市場,然後按需安裝
最好的 Skills 乾淨利落地歸入一個類別,別貪多 Gotchas 章節是靈魂,不斷積累 Claude 的犯錯經驗 Skills 是文件夾,不是文件,善用目錄結構做信息分層 Description 是觸發器,不是摘要 從小開始,大多數好用的 Skills 最初只有幾行,後來不斷補充才變得強大
anthropics/skills — Anthropic 官方出品,最權威的 Skills 合集,必裝 openai/skills — OpenAI 的 Skills,跨平台借鑑意義很大 iamzhihuix/happy-claude-skills — 我自己維護的 Skills 合集,歡迎大家 Star ⭐
neondatabase/agent-skills — Neon Serverless 數據庫 supabase/agent-skills — Supabase 全棧後端 stripe/ai/skills — Stripe 支付集成 cloudflare — Cloudflare 生態相關
JimLiu/baoyu-skills — 首推! 寶玉老師的 Skills,覆蓋公眾號、小紅書、封面圖、翻譯等內容創作全流程 typefully/agent-skills — Twitter/X 發帖相關 remotion-dev/skills — Remotion 視頻製作
VoltAgent/awesome-agent-skills — 社區優質 Agent Skills 合集,按類別整理,持續更新。收藏這一個,等於收藏了整個 Skills 生態。
Thariq: Lessons from Building Claude Code: How We Use Skills Anthropic 官方 Skills 博客 Claude Code Skills 官方文檔 插件市場官方文檔 Agent Skills 入門課程(Skilljar) Skills 案例倉庫