What is a SKILL.md file used for?

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.

What is needed to create a SKILL.md file?

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.

How do developers select a task for a new skill?

Developers should select a task they perform at least once a week, especially if it is repetitive but requires accurate, pattern-specific output.

How does frontmatter configure a SKILL.md?

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.

How should skill instructions be structured?

Skill instructions should be structured as clear, numbered steps below the frontmatter, providing specific details about expected output, checks, and formatting.

How can one test a newly created skill?

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.

What are options for sharing a skill?

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.

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.

March 15, 20268 min read

Frequently Asked Questions