How to Use Agent Skills

Learn how to create, manage, and share Skills to extend Agent's capabilities.

Agent Skills

Skills are tools that extend Claude's capabilities in Claude Code. They allow you to automate repetitive tasks, enforce best practices, and share standard workflows across your team.

Create Your First Skill

Skills are defined in a `SKILL.md` file located in a `.claude/skills` directory.

  1. Create a `.claude/skills` directory in your project root.
  2. Create a subdirectory for your skill (e.g., `.claude/skills/my-skill`).
  3. Create a `SKILL.md` file inside that directory.
---
title: My Skill
description: A brief description of what this skill does.
---

# My Skill

Detailed instructions for Claude on how to perform this skill.

How Skills Work

When you ask Claude designed to do something, it looks for relevant Skills in your project. If a Skill matches your request, Claude will follow the instructions defined in the `SKILL.md` file.

Configure Skills

You can configure Skills by adding metadata to the `SKILL.md` file frontmatter, such as `title`, `description`, and `filters` to control when the skill is applied.