update-agent

Update Claude Code agent files while preserving YAML frontmatter.

Updated Dec 9, 2025
One-click install
npx skills add https://github.com/blueif16/amazing-claude-code-plugins --skill update-agent
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: update-agent
Source: https://github.com/blueif16/amazing-claude-code-plugins/tree/main/skillforge/skills/update-agent
Command: npx skills add https://github.com/blueif16/amazing-claude-code-plugins --skill update-agent

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the error-prone process of manually updating agent files while maintaining proper YAML structure.

Core Features & Use Cases

  • Agent Refinement: Update agent descriptions, models, tools, or instructions with precision.
  • Validation: Ensures model selections and YAML formatting remain correct during updates.
  • Use Case: When you need to upgrade your code review agent from sonnet to opus for better performance.

Quick Start

Run the update-agent skill to modify your existing Claude Code subagents.

Frequently Asked Questions about update-agent

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

FAQPage Schema
How do I update an existing Claude Code agent's configuration?▼

Update agent content by running the update-agent skill, which lists agents in your .claude/agents directory, lets you select a target agent, and applies precise edits to description, model, tool list, and instructions while preserving YAML frontmatter structure.

Can I change an agent's model from sonnet to opus without breaking the YAML format?▼

Yes. The update-agent skill validates model selections against allowed values (sonnet, opus, haiku, inherit) and enforces YAML frontmatter integrity, so structural changes remain valid after updates.

What happens if I try to update an agent in a missing directory or without write permissions?▼

The skill includes concrete validation and error handling for missing directories and permission issues, preventing corrupted agent files and providing clear feedback about what went wrong.

How do I refine my code review agent's instructions and tools at the same time?▼

Select the agent, then use the Edit tool to modify description, model, tool list, and instructions in a single operation while the skill preserves all required YAML fields.

When should I use agent updates versus creating a new agent?▼

Update an existing agent when you're adapting its behavior, upgrading its model tier, or adjusting its tool configuration for changing needs; create a new one when building a fundamentally different agent.