Tutorials
skill.md
create skill
tutorial
How to Create Your Own SKILL.md File from Scratch
Turn any repeatable workflow into a skill. This step-by-step tutorial walks you through creating a SKILL.md file from scratch, testing it, and sharing it.
Frequently Asked Questions
A SKILL.md file defines automated workflows for tasks like writing boilerplate, scaffolding components, or reviewing PRs, which can be used by compatible agents such as Claude Code.
To create a SKILL.md file, you only need a text editor. No build tools or compilation steps are required as skills are simple markdown files.
Developers should select a task they perform at least once a week, especially if it is repetitive but requires accurate, pattern-specific output.
Frontmatter configures a SKILL.md with a 'name' for the slash command and a 'description' that helps the agent decide when to automatically load the skill.
Skill instructions should be structured as clear, numbered steps below the frontmatter, providing specific details about expected output, checks, and formatting.
To test a skill, manually invoke it with its slash command in a Claude Code session, then test automatic invocation by asking the agent a question matching the skill's description.
Skills can be published on GitHub, submitted to Agensi for marketplace listing, or shared with a team by placing them in the project's .claude/skills/ directory.