How to Write Your First Agent Skill

Описание и применение

Создание навыка агента в виде файла SKILL.md сохраняет правила и устраняет дрейф поведения, обеспечивая стабильный и повторяемый процесс генерации сообщений коммитов и других задач.

Задача

Agents drift from user‑defined house rules because the rules are pasted into the chat each session instead of being stored in a reusable file.

Результат

Storing agent rules in a skill file eliminates drift, reduces repetitive pasting, and provides a clear, reusable workflow for generating commit messages and other tasks.

Рабочий процесс

• Create a folder for the skill and add a file named SKILL.md.
• Add YAML frontmatter with a name and a description that serves as a trigger.
• Write the description as "does X. Use when the user asks for Y.".
• Write the body in plain markdown: the workflow, rules, example, and anti‑patterns.
• Drop the folder into the agent’s skills directory so the agent loads it automatically.
• Use the skill by invoking the agent; it matches the description to trigger the workflow.

Доказательства

A skill is a folder containing one file: SKILL.md. It has two parts.

Источник

The description is the trigger: the agent scans the descriptions of its skills to decide which ones apply to your request.

Источник

Drop the folder into your agent's skills directory, and the agent picks it up by matching the description — no further configuration.

Источник