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

ThingFolderWhat it is
Subagents~/.claude/agents/One .md file per agent
Skills~/.claude/skills/<name>/SKILL.mdOne 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

  1. Start Claude Code in any folder.
  2. Type /agents. Your new agents should be in the list.
  3. 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

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.

Get the ready-made kitSee all AI Crew Kits →Sim Your Decisions · $79 →Solo Creator Team · $79 →Restaurant Agency Crew · $79 →One-time purchase · installs in 3 minutes · 30-day refund

More guides · AI Crew Kits for Claude Code. Not affiliated with Anthropic.