subagent-tweaker

name	subagent-tweaker
description	Fix, improve, or update existing Claude Code custom agents (subagents). Use when: (1) User reports an agent isn't working well, (2) User wants to adjust agent behavior, tools, or model, (3) User says 'fix agent', 'update agent', 'tweak agent', 'agent not working'. Edits agent frontmatter, tool restrictions, prompts.

Tweak Custom Agent

Workflow

Step 1: Identify the agent

Find agents at:

• $HOME/.claude/agents/*.md (personal)
• .claude/agents/*.md (project)

Read the agent file to understand current configuration.

Step 2: Diagnose the issue

Common problems and fixes:

Problem	Likely Cause	Fix
Agent not being used	Poor description	Rewrite with clear trigger keywords
Agent too slow	Wrong model	Switch to sonnet or haiku
Agent can't edit files	tools missing Write/Edit	Add needed tools to allowlist
Agent doing too much	No tool restrictions	Add tools: or disallowedTools:
Agent forgets context	No persistent memory	Add memory: user or memory: project
Agent runs too long	No turn limit	Add maxTurns: N

Step 3: Apply changes

Edit the agent's Markdown file. Preserve existing content that works well.