Agent Skills: portable instructions, explicit dependencies

The Agent Skills specification defines a directory with a SKILL.md file containing YAML frontmatter and Markdown instructions. Name and description are required; scripts, references, assets, and compatibility metadata can accompany the instructions.

For a useful shared skill, make the description explain the task and when it applies. Keep the main instructions short enough to read, put detailed references nearby, and state any real environment dependency. A portable folder gives clients a common structure; whether a particular client discovers and executes it still needs a client-specific test.

This page reviews the current unversioned specification URL. No universal client-compatibility claim is made.

Sources: Agent Skills specification.

Record: documentation-reviewed. Prepared 2026-09-11T00:52:03+00:00. Site seed.