Short answer
Claude Code now treats a custom slash command as a skill. Old command files still work. For a new reusable task, create a SKILL.md file in the .claude/skills folder. You can start a skill with a slash command, or Claude can choose it when it matches your task.
Words used in this guide
- AIPM: a tool that installs and updates reusable AI instructions.
- Workflow: a set of steps used to finish a task.
- Repository or repo: a project folder whose changes are saved and tracked.
What this means
The old formats now work together
A command file and a skill can both create a slash command. You do not need to change old command files now. Use the skill format for new tasks.
Skills can hold more than one file
A skill starts with a SKILL.md file. It can also include examples, small programs, and helpful documents. Claude reads these files only when it needs the skill.
Package skills when teams reuse them
Keep a one-repo skill in that repo. When several repos need it, use AIPM to give it a name, version, and repeatable install command.
Simple steps to create and AI agent
- Keep working custom command files if they still do the job.
- Create new workflows in .claude/skills with a SKILL.md file.
- Write a clear name and description so Claude knows when to use the skill.
- Test both direct slash use and automatic use.
- Publish shared skills with AIPM.
Where to go next
If you want to try this in a real project, start with the install guide, then read how to use AIPM. If you want to share your own workflow, read the publishing guide.
FAQ
Do old Claude Code custom commands still work?
Yes. Files in .claude/commands still work. Claude Code has merged custom commands into the Skills model.
Can a skill be called with a slash command?
Yes. A skill can be called directly with its slash name, and Claude can also choose it when the task matches.