SkillPedia Skills Encyclopedia
中文 EN
Today's updates 2026-11-17 UTC

No new commits yet today

Open the update feed

AI & LLMs · Beginner

SKILL.md(技能说明文件)

一个技能包里的核心说明书,用大白话写清这个技能干什么、什么时候用、按什么步骤做。模型读到它,就照着上面说的执行。

AI & LLMs Beginner Appears 107 times across the site, in 54 entries 446 characters about 1 min read 46 views

Some fields on this page have no English version yet — they are shown in the original Chinese.

TL;DRIn 30 seconds

  1. 一个技能包里那份用大白话写的说明书,讲清它干什么、什么时候该用。
  2. AI 读到它,就照着上面写的步骤和规矩去干活。
  3. 它是文档不是程序,写得含糊也不会报错,只会被理解歪。

OverviewIn detail

SKILL.md 是一个文件名,通常放在技能包的最外层,充当整包的主说明。里面不是代码,而是用自然语言写的:这个技能解决什么问题、什么情况下该用它、具体分成哪几步。模型读到这份文件,就按上面的说法干活。它是纯文本,用任何编辑器都能打开和修改。

它的价值在于可移植。各家工具有自己的私有格式,模型换一个就跑不起来;而一份按通用写法组织、结构清楚的说明,多个 AI 工具都能读、都能照做。换句话说,写得好的说明可以在工具之间搬来搬去。这也是它用普通文字而不是某种专用语言来写的原因。

拿它和提示词比:提示词是一次性的,说完就过去了;SKILL.md 是留在技能包里的常驻说明,每次调用都被重新读一遍。拿它和程序比:程序写错会报错,说明书含糊却不会有任何提示,模型只会按自己的理解做偏,等到结果出来才知道不对。

所以它的效果几乎全看写得清不清楚。步骤含混、适用边界没交代、该说什么时候不要用它却漏了,最后都会体现成模型乱来。写的时候可以假设读者第一次接触这个技能,把判断条件和例外情况一并写进去,比单纯把步骤列得多更管用。

MythsCommon misunderstandings

  • 以为它是另一种更高级的提示词 提示词说完就过去了,这份说明长期留在包里,每次调用都被重新读
  • 以为写错了会像程序一样报错 文档不会报错,它只会按自己的理解做偏,等结果出来才发现不对
  • 以为步骤列得越多越好 关键是写清用它的条件和不该用的时候,光堆步骤照样跑偏

In practiceWhere you will meet it

  • 给一个批量处理表格的技能写说明,把适用场景和例外都写上
  • 把这个技能包换到另一个 AI 工具里,它能照读照做
  • 发现 AI 用技能时乱来,回去检查说明是不是没交代边界

SummaryThe key points

  • 技能包里负责说明的核心文件
  • 用普通文字写清用途、时机和步骤
  • 写法通用,多种 AI 工具都能读
  • 它是文档不是程序,写不清楚效果就差

FAQ

What does SKILL.md(技能说明文件) mean?

一个技能包里那份用大白话写的说明书,讲清它干什么、什么时候该用。AI 读到它,就照着上面写的步骤和规矩去干活。它是文档不是程序,写得含糊也不会报错,只会被理解歪。

Where will I run into SKILL.md(技能说明文件)?

给一个批量处理表格的技能写说明,把适用场景和例外都写上;把这个技能包换到另一个 AI 工具里,它能照读照做;发现 AI 用技能时乱来,回去检查说明是不是没交代边界。

What do people most often get wrong about SKILL.md(技能说明文件)?

以为它是另一种更高级的提示词 — but 提示词说完就过去了,这份说明长期留在包里,每次调用都被重新读;以为写错了会像程序一样报错 — but 文档不会报错,它只会按自己的理解做偏,等结果出来才发现不对。

What are the key points about SKILL.md(技能说明文件)?

技能包里负责说明的核心文件;用普通文字写清用途、时机和步骤;写法通用,多种 AI 工具都能读;它是文档不是程序,写不清楚效果就差。

Common pitfalls 说明书含糊时模型不会报错,只会自己猜着做,所以能用的边界和禁忌都要写进去。

Entry 21 of 186 · All entries

Keep readingRelated reading

Where to go nextExplore more

Back to the skills themselves

Most of the concepts covered here come from skills that install into your AI client with a single command.