create-skill

To create an Agent Skill for Cursor, you structure a skill directory and write a SKILL.md file defining its purpose, descriptions, and supporting reference materials. The process involves defining the skill's scope, choosing degrees of freedom, and documenting progressive disclosure.

The correct Agent Skill file structure requires a dedicated skill directory containing a SKILL.md file and supporting reference materials. This layout ensures the skill is properly recognized and documented within the Cursor environment.

Best practices for writing SKILL.md files include providing clear descriptions, choosing appropriate degrees of freedom for the agent, and using progressive disclosure to manage complexity. These guidelines ensure the skill remains effective and maintainable.

You add reference materials to an AI coding skill by incorporating supporting documents into the skill directory alongside the SKILL.md file. This provides the agent with necessary context and detailed instructions during execution.

Building Agent Skills requires familiarity with markdown and AI coding workflows to effectively structure directories and author SKILL.md files. The process focuses on documentation and structuring rather than complex programming.