如何設計一個好的 AI Skill ？ 整理 6 條共同規律

⏱ 章節 00:00 開場：7 行的檔案，21 萬顆星 00:57 什麼是 Agent Skill：一個資料夾，三層載入 03:57 先給答案：五種類型，六條規律 06:04 規律一：description 決定它會不會被叫出來 09:04 規律二：正文寫短，細節和腳本放外面 12:42 規律三：先寫清楚不做什麼，再堵住捷徑 14:58 行為型 skill 怎麼寫（grill-me、TDD） 20:11 品味型 skill：用角色和反例教審美 21:17 實測統計：38 支知名 skill 量出來的結果 23:24 趨勢：這一年 skill 的寫法怎麼變 24:38 怎麼測一支 skill 到底有沒有用 大家好，我是 Jim，這裡是 AI Notebook。今天這支影片只回答一個問題，一支好的 skill 到底要怎麼設計。你電腦裡的 AI，其實是可以被你教的。教的方法不是打一長串指令，是給它一個資料夾，資料夾裡放一份說明書，AI 覺得這件事用得上，才自己翻開來看。這種資料夾有一個名字，叫 skill。現在全世界最紅的一支 skill，整份檔案只有七行。七行，收到了二十一萬顆星星。那是 GitHub 上的收藏數。同一時間，另一種做法叫 MCP，做同一件事，花掉的字數是它的三十二倍，而字數在這裡是要付錢的。所以問題來了，同樣是教 AI 做事，為什麼有人七行就成，有人寫了五百行還是沒被理睬。為了回答 📎 資料來源 • Agent Skills overview — Claude Docs https://platform.claude.com/docs/en/a... • Skill authoring best practices — Claude Docs https://platform.claude.com/docs/en/a... • Equipping agents for the real world with Agent Skills — Anthropic Engineering https://www.anthropic.com/engineering... • anthropics/skills — the official skill repository (pdf, skill-creator, webapp-testing, frontend-design) https://github.com/anthropics/skills • Agent Skills — the open specification https://agentskills.io • Simon Willison — Claude Skills are awesome, maybe a bigger deal than MCP https://simonwillison.net/2025/Oct/16... • Jesse Vincent — Superpowers (announcement post) https://blog.fsck.com/2025/10/09/supe... • obra/superpowers — TDD, systematic-debugging, verification-before-completion https://github.com/obra/superpowers • mattpocock/skills — grill-me and grilling https://github.com/mattpocock/skills • kepano/obsidian-skills — obsidian-markdown and obsidian-bases https://github.com/kepano/obsidian-sk... • andrej-karpathy-skills — the behavioural guidelines file https://github.com/multica-ai/andrej-... • OthmanAdi/planning-with-files — hook-enforced planning skill https://github.com/OthmanAdi/planning... • SkillsBench — benchmarking agent skills (arXiv) https://arxiv.org/pdf/2606.11435 • Evaluating Agent Skills with MLflow https://mlflow.org/blog/evaluating-sk... • anthropics/skills #1447 — the 2026-07-16 rewrite of the docx / pptx / xlsx skills https://github.com/anthropics/skills/... • obra/superpowers 9c9547c (2025-10-16) — 「Now that skills are a first-class thing in Claude Code, restore them to the primary plugin」 https://github.com/obra/superpowers/c... --- Jim AI Notebook | Note the Future 每日深度解析 AI 最新進展 #AI #AISkill #AgentSkills #ClaudeCode #MCP #提示詞工程 #AINotebook