# Agent Development

> This skill should be used when the user asks to "create an agent", "write an agent", "build an agent", or wants to add new agent capabilities to Claude Code.

- Skill: `diegosouzapw/agent-development` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add diegosouzapw/agent-development`
- Raw SKILL.md: https://api.skillmd.com/api/skills/diegosouzapw/agent-development/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: diegosouzapw (https://skillmd.com/u/diegosouzapw)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/diegosouzapw/agent-development

---


# Agent Development

Create effective Claude Code agents.

## Agent Colors

Agents support color assignments for visual distinction. Set in YAML frontmatter:

```yaml
---
name: explore
description: Explores codebases
color: purple
---
```

### Color Conventions

| Color | Agent Type | Purpose |
|-------|------------|---------|
| Purple | Explore | Codebase exploration, documentation |
| Blue | Plan | Analysis, planning, architecture |
| Green | Create | Testing, creation, validation |
| Orange | Debug | Debugging, refactoring |
| Yellow | Clean | Optimization, cleanup |
| Red | Reflect | Security, critical review |
| Pink | - | Available |
| Cyan | - | Orchestration, coordination |

## Agent Behavior

### Permission Denial Resilience

Subagents continue after permission denial rather than stopping entirely. When a subagent hits a permissions wall, it tries alternative approaches automatically. This makes autonomous workflows more resilient and reduces the need for human intervention.

## Important

After creating or modifying agents, inform the user:

> **No restart needed.** Agent changes take effect immediately - agents are hot-reloaded.