skills.rest
Takazudo
TakazudoCOMMUNITY
Explore all skills by this author →
Website𝕏@TakazudoGitHub

subagent-tweaker

Edit Claude Code subagent frontmatter, tool restrictions, and prompts.

11|1|Updated Feb 10, 2026
Search Tags:#debugging#agents#memory#subagent#prompts#claude-code#tools
One-click install
npx skills add https://github.com/Takazudo/claude-resources --skill subagent-tweaker
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: subagent-tweaker
Source: https://github.com/Takazudo/claude-resources/tree/main/skills/subagent-tweaker
Command: npx skills add https://github.com/Takazudo/claude-resources --skill subagent-tweaker

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

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'. Handles: editing agent frontmatter, adjusting tool restrictions, updating prompts, debugging issues.

Core Features & Use Cases

  • Identify and understand the current subagent configuration across personal and project scopes.
  • Diagnose common causes of subagent misbehavior and apply targeted changes to prompts, tools, or memory.
  • Verify changes and maintain a clean frontmatter and prompt structure to prevent regressions.
  • Use Case: A user reports a subagent is not using the correct tools; adjust the allowed tools and prompts.

Quick Start

Edit the subagent's Markdown file to adjust tools, prompts, or memory and verify the frontmatter.

Frequently Asked Questions about subagent-tweaker

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
Why does my Claude Code subagent keep using the wrong tools or ignoring instructions?▼

Subagent misbehavior often stems from overly permissive tool restrictions or ambiguous prompts. Diagnosing the agent configuration involves checking the frontmatter and adjusting the allowed tools list to enforce correct behavior.

How do I update a Claude Code subagent prompt to change its behavior?▼

To update a Claude Code subagent, edit the subagent's Markdown file to refine the prompt text. Adjusting the instructions within the prompt structure directly modifies how the agent interprets and executes tasks.

Can I adjust tool restrictions for a specific Claude Code agent without affecting others?▼

Yes, you can adjust tool restrictions by editing the frontmatter of the specific subagent's Markdown file. This targeted modification limits or expands the agent's available tools without impacting other personal or project agents.

What is the best way to fix a Claude Code agent that stopped working after an update?▼

Fixing a broken Claude Code agent requires checking the subagent's Markdown file for frontmatter syntax errors or invalid tool references. Correcting the configuration structure and verifying the prompt prevents regressions.

How do I debug issues across both personal and project Claude Code agent configurations?▼

Debugging Claude Code agent configurations involves identifying the active scope of the subagent, reviewing its frontmatter, and applying targeted changes to the prompts or tools to resolve inconsistencies across personal and project files.

Related Skills

Explore More Software Engineering Skills→
hamzaPixlhamzaPixl
2

agent-development

Create and validate Claude Code plugin subagent definitions with frontmatter and system prompts.

Community
Intermediate
unclehowellunclehowell

test-driven-development

Enforce a test-first workflow requiring failing tests before production code.

Community
Intermediate
jpoutrinjpoutrin
14

create-agent

Create Claude Code agent markdown files with required YAML frontmatter fields.

Community
Basic
SDiamante13SDiamante13
7

skill-builder

Create, edit, or convert Claude Code Skills with structured files.

Community
Advanced