Instructions for setting up Claude Code custom agents

claude-agents-setup-prompt.md

Claude Code Custom Agents Setup Instructions

Prompt for LLM Assistant

I need help setting up custom agents for Claude Code. Please help me install the agents from this GitHub gist: https://gist.github.com/Danm72/7cdd172f818505b221988916ebdc9371

Here's what needs to be done:

1. Create the agents directory (if it doesn't exist):

   mkdir -p ~/.claude/agents

2. Extract and create individual agent files from the gist. Each agent should be saved as a separate markdown file in ~/.claude/agents/. The agents to create are:

   • backend-architect.md
   • business-analyst-researcher.md
   • code-quality-reviewer.md
   • prd-to-tdd-architect.md
   • project-memory-keeper.md
   • react-tailwind-developer.md
   • test-automation-specialist.md

3. File format: Each agent file must follow this YAML frontmatter format:

   ---
   name: agent-name
   description: Description text here
   color: color-name
   ---
   
   [Agent instructions content goes here]

4. Important notes:

   • The filename must match the agent name (e.g., backend-architect.md for the backend-architect agent)
   • Each file should contain ONLY that specific agent's frontmatter and instructions
   • The frontmatter must be valid YAML between --- markers
   • The description in the frontmatter should be the full description including examples
   • Colors for each agent are specified in the gist

Please fetch the gist content, parse it to extract each agent's information, and create the individual files in the correct location. After creating the files, verify they were created successfully by listing the contents of ~/.claude/agents/.

---

Alternative: Direct Copy-Paste Instructions

If you prefer to set up the agents manually:

1. Visit the gist: https://gist.github.com/Danm72/7cdd172f818505b221988916ebdc9371
2. Create the directory: mkdir -p ~/.claude/agents
3. For each agent section in the gist:
   • Create a new file named [agent-name].md in ~/.claude/agents/
   • Copy the YAML frontmatter (including name, description, and color)
   • Copy the agent instructions
   • Save the file

Example for one agent:

cat > ~/.claude/agents/backend-architect.md << 'EOF'
---
name: backend-architect
description: Use this agent when you need to design, review, or implement backend systems...
color: cyan
---

You are an expert backend architect...
[rest of instructions]
EOF

After setup, you can use any agent by invoking it through Claude Code's Task tool.