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.
Agent Skills是Anthropic发布的能力封装标准，定义为一个包含Skill.md文件的目录，可包含说明、脚本和其他资源
Timeline (last 90 days)
SKILL.md is a plain-text-based form of capability description that is lightweight, readable, easy to version-control, and not bound to a specific runtime.
The MCode Stack repository contains 17 SKILL.md skill files and 5 checklists.
The same SKILL.md can be loaded by different runtimes, thereby achieving cross-platform reuse.
Claude-Red packages expert methodologies in offensive security domains such as penetration testing, exploitation, EDR evasion, and shellcode writing into structured SKILL.md files.
The SKILL.md file format and core specification remain unchanged after the transfer, and SKILL.md files in existing projects do not need to be modified immediately because of this transfer.
After the standard's transfer, developers may need to check version compatibility in SKILL.md, the validity of metadata fields (such as maintainer-related metadata), and whether referenced links have been redirected or migrated.
If the front matter format of SKILL.md is incorrect (such as a missing delimiter, wrong indentation, or no space after a colon), parsing may fail, manifesting as the Skill not being recognized at all rather than merely matching inaccurately.
When writing SKILL.md, name should be kept short, stable, and semantically clear, avoiding vague abbreviations; description is recommended to use a "verb + object + scenario" sentence pattern, covering applicable tasks and non-applicable boundaries, and listing typical trigger keywords when necessary.
SKILL.md typically consists of two parts: YAML front matter and a Markdown body.
The Skills folder may contain subdirectories such as scripts, references, and assets, and other custom folders can also be added, but they must be explicitly pointed to in SKILL.md, otherwise the agent cannot make basic judgments.
38 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%VerifiedAgent Skills是Anthropic发布的能力封装标准，定义为一个包含Skill.md文件的目录，可包含说明、脚本和其他资源
80%VerifiedSkills are essentially Markdown files stored in the project's .claude/ directory.
75%VerifiedSKILL.md typically consists of two parts: YAML front matter and a Markdown body.
70%VerifiedThe Skills folder may contain subdirectories such as scripts, references, and assets, and other custom folders can also be added, but they must be explicitly pointed to in SKILL.md, otherwise the agent cannot make basic judgments.
70%VerifiedAgent Runtime is the underlying infrastructure that supports AI agents in running continuously, calling tools, maintaining state, and executing multi-step tasks, including components such as sandbox environments, file system access control, command execution whitelists, and cross-session state persistence mechanisms.
65%VerifiedSkill's progressive loading mechanism has two levels: the first level exposes only name and description to form a minimal skill catalog; the second level reads the full SKILL.md and supporting files only after a hit.
65%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%UnverifiedThe MCode Stack repository contains 17 SKILL.md skill files and 5 checklists.
50%UnverifiedSKILL.md is a plain-text-based form of capability description that is lightweight, readable, easy to version-control, and not bound to a specific runtime.
50%UnverifiedThe same SKILL.md can be loaded by different runtimes, thereby achieving cross-platform reuse.
50%UnverifiedClaude-Red packages expert methodologies in offensive security domains such as penetration testing, exploitation, EDR evasion, and shellcode writing into structured SKILL.md files.
50%UnverifiedThe SKILL.md file format and core specification remain unchanged after the transfer, and SKILL.md files in existing projects do not need to be modified immediately because of this transfer.
50%UnverifiedAfter the standard's transfer, developers may need to check version compatibility in SKILL.md, the validity of metadata fields (such as maintainer-related metadata), and whether referenced links have been redirected or migrated.
50%