Writing Agents

Overview

Agents are specialized AI assistants with custom prompts, models, and tool access. Configure via markdown files or JSON.

When to Use

• Creating a new agent for specific tasks
• Editing agent prompts, permissions, or tool access
• Choosing between primary vs subagent mode
• Setting up task permissions for orchestration
• Reviewing agent configuration quality

Don't use for: skill files (use writing-skills), system prompts without agent context, or MCP server config.

File Locations