How to install Claude Code subagents and skills (beginner guide)
Claude Code can load subagents (helpers with one job) and skills (commands you type, like /sim). Both are plain text files in a folder on your computer. Installing one is just copying a file to the right place.
Where they live
| Thing | Folder | What it is |
|---|---|---|
| Subagents | ~/.claude/agents/ | One .md file per agent |
| Skills | ~/.claude/skills/<name>/SKILL.md | One folder per skill |
~ means your home folder. On Windows that is C:\Users\YourName.
Files in these folders work in every project. Files in a project's own .claude/ folder only work in that project.
Install on Mac or Linux
Open a terminal inside the unzipped kit folder and run:
mkdir -p ~/.claude/agents ~/.claude/skills
cp agents/*.md ~/.claude/agents/
cp -R skills/* ~/.claude/skills/
Install on Windows (PowerShell)
mkdir $HOME\.claude\agents, $HOME\.claude\skills -Force
copy agents\*.md $HOME\.claude\agents\
copy -Recurse skills\* $HOME\.claude\skills\
Check it worked
- Start Claude Code in any folder.
- Type
/agents. Your new agents should be in the list. - Type the skill's command (for example
/sim). Claude should answer in that skill's role.
Not showing? Restart Claude Code. Agents are read when it starts.
How to use an agent
Just ask: "Use the gate agent to check this script." Claude hands the job to that agent and shows you the result. Good agent teams also have a manager skill that routes jobs for you.
Safety tips
- Read an agent file before you install it. It's plain English; you'll see what it's allowed to do.
- Prefer agents that only draft: never post, send messages or spend money.
- Never install agents that ask for your passwords or keys.
Ready-made teams
Each AI Crew Kit installs in about 3 minutes and comes with a 2-minute quick start: Sim Your Decisions, Solo Creator Team and Restaurant Agency Crew.
More guides · AI Crew Kits for Claude Code. Not affiliated with Anthropic.