SKILL.md
A core configuration file for Agent Skills used to explicitly describe an AI Agent's workflow, reference document paths, and tool configurations. It constrains model behavior to predictable execution paths.
Core Facts
skill.md is written in Markdown format and contains metadata (skill name and description) as well as detailed execution instructions.
A complete Skill contains a Skill.md main document, a Reference folder, a Script folder, and an Assets folder.
Skills are essentially Markdown files stored in the project's .claude/ directory.
Timeline (last 90 days)
llms.txt 是一种新兴约定，用于向语言模型提供网站内容的精简或完整文本版本；SKILL.md 是面向代理的技能描述文件，用 Markdown 说明服务能做什么、如何调用及限制。
Sourcey 提供的面向代理的入口包括：llms.txt 和 llms-full.txt、SKILL.md、HTTP API 和托管的 MCP 服务器、companies.json、startup-credits.json、agent-readiness.json 以及只追加的变更订阅源。
Frontmatter的值内部不能包含Markdown语法，否则可能解析失败或被判定为格式不合规；description的第一句话需要回答「Agent什么时候应该加载这个技能」。
Agent Skill Publish Gate是一个包含7道门的静态审计工具，可以在提交到任何平台之前对SKILL.md进行预检。
提交前自检清单包含：权限声明覆盖文档中每一个能力关键词、声明所有运行时主机（排除纯文档域名）、权限备注解释为什么和不做什么、描述第一句回答Agent何时加载技能、Frontmatter只包含name和description且值内不含Markdown、正文结构完整、无硬编码密钥、破坏性操作显式选择加入、定价处于合理区间。
正文结构建议遵循「何时使用 → 做什么 → 怎么工作 → 示例输出 → 注意事项」的顺序。
SKILL.md是AI Agent技能包中的核心描述文件，通常采用带Frontmatter的Markdown格式，Frontmatter一般只包含name和description两个字段。
Gemini Skills are essentially a set of reusable, customized instructions stored in the open SKILL.md format, which users can invoke by typing @ plus the skill name in the Ask Gemini panel in Gmail, Docs, Slides, Drive, or Chat, and Workspace Studio flows can also use them.
In a natural experiment, 7 of 11 skill assessment scores changed between two runs, with a maximum fluctuation of 1 point.
diagram-design's SKILL.md is 30.5 KB in size, and CI limits it to within 40000 bytes because it is fully loaded into the context window on every call.
22 more timeline events
All Facts (20)
skill.md is written in Markdown format and contains metadata (skill name and description) as well as detailed execution instructions.
80%VerifiedA complete Skill contains a Skill.md main document, a Reference folder, a Script folder, and an Assets folder.
80%VerifiedSkills are essentially Markdown files stored in the project's .claude/ directory.
75%VerifiedThe SKILL.md metadata must include at minimum two fields: name and description.
65%VerifiedThe SKILL.md file begins with a metadata section (Frontmatter) enclosed by three dashes, which is the key to the Skill being recognized by AI tools.
65%VerifiedIn the Skill directory structure, the development process corresponds to the SKILL.md file, reference documentation corresponds to the references directory, development tools correspond to the scripts directory, and static assets correspond to the assets directory.
65%VerifiedA Skill is essentially a natural-language Prompt, placed in a special file called skill.md.
65%UnverifiedA Skill only needs to contain a single SKILL.md file to run, and all other components (scripts, references, resources, etc.) are optional.
60%UnverifiedSKILL.md is written in Markdown format, with the top of the file carrying metadata via YAML Front Matter or a header block, containing fields such as name, description, and trigger.
60%Unverifiedllms.txt 是一种新兴约定，用于向语言模型提供网站内容的精简或完整文本版本；SKILL.md 是面向代理的技能描述文件，用 Markdown 说明服务能做什么、如何调用及限制。
50%UnverifiedSourcey 提供的面向代理的入口包括：llms.txt 和 llms-full.txt、SKILL.md、HTTP API 和托管的 MCP 服务器、companies.json、startup-credits.json、agent-readiness.json 以及只追加的变更订阅源。
50%UnverifiedFrontmatter的值内部不能包含Markdown语法，否则可能解析失败或被判定为格式不合规；description的第一句话需要回答「Agent什么时候应该加载这个技能」。
50%Unverified提交前自检清单包含：权限声明覆盖文档中每一个能力关键词、声明所有运行时主机（排除纯文档域名）、权限备注解释为什么和不做什么、描述第一句回答Agent何时加载技能、Frontmatter只包含name和description且值内不含Markdown、正文结构完整、无硬编码密钥、破坏性操作显式选择加入、定价处于合理区间。
50%UnverifiedSKILL.md是AI Agent技能包中的核心描述文件，通常采用带Frontmatter的Markdown格式，Frontmatter一般只包含name和description两个字段。
50%Unverified正文结构建议遵循「何时使用 → 做什么 → 怎么工作 → 示例输出 → 注意事项」的顺序。
50%UnverifiedAgent Skill Publish Gate是一个包含7道门的静态审计工具，可以在提交到任何平台之前对SKILL.md进行预检。
50%UnverifiedGemini Skills are essentially a set of reusable, customized instructions stored in the open SKILL.md format, which users can invoke by typing @ plus the skill name in the Ask Gemini panel in Gmail, Docs, Slides, Drive, or Chat, and Workspace Studio flows can also use them.
50%UnverifiedIn a natural experiment, 7 of 11 skill assessment scores changed between two runs, with a maximum fluctuation of 1 point.
50%Unverifieddiagram-design's SKILL.md is 30.5 KB in size, and CI limits it to within 40000 bytes because it is fully loaded into the context window on every call.
50%UnverifiedSkill Constellations (2026-10-09) traced the copy-paste supply chain of agents' SKILL.md files across 2.19 million GitHub adoptions, finding that security fixes rarely propagate to downstream copies, and that star counts are a poor proxy for trustworthy provenance.
50%