---
source: CrewKit documentation
url: https://crewkit.io/docs/skills.md
title: "Skills"
description: "Reusable task-specific capabilities for Claude Code."
---


Skills are focused, reusable capabilities that Claude Code can invoke for specific tasks. Unlike agents (which define a persistent persona), skills are task-specific — like "generate a migration" or "review a pull request."

---

## Create a skill

Create skills through the dashboard or by importing local files.

**Dashboard:**
1. Go to **Resources** > **New Resource** > **Skill**
2. Set the name, slug, and description
3. Write the skill prompt
4. Click **Create**

**Local file:**
Create a markdown file in `.claude/skills/`:

```markdown
---
name: db-migration
description: Generate database migrations with proper rollback support
---

Generate a Rails database migration for the requested change.

## Requirements

- Always include a reversible `change` method
- Add appropriate indexes for foreign keys
- Use `null: false` for required columns
- Add comments explaining non-obvious column choices
```

Then import it:

```bash
crewkit resources import
```

---

## Skill file format

Skills use the same format as agents — markdown with optional YAML frontmatter:

```markdown
---
name: review-pr
description: Review pull request for code quality and standards
---

Review the pull request changes for:
- Code quality and readability
- Test coverage
- Security concerns
- Performance implications
```

The `description` field is used for discovery — Claude Code shows it when listing available skills.

---

## Using skills

Skills are synced to `.claude/skills/` and available as slash commands in Claude Code. Invoke them by name:

```
/skill db-migration Add a tags column to the posts table
```

---

## Skill tiers

Like agents, skills can exist at platform, organization, or project level. See [Inheritance](/docs/inheritance) for details.

---

## Next steps

- [Rules](/docs/rules)
- [Commands](/docs/commands)
- [Inheritance](/docs/inheritance)