| name | update-agent |
| description | Create, update, or manage universal-ai-config agent templates. Handles finding existing agents, deciding whether to create or modify, and writing the template. Use when this capability is needed. |
| metadata | {"author":"fabis94"} |
Manage Agent Templates
Agents are specialized AI personas with scoped tools and permissions that run in isolated contexts.
Important: Agents are supported by Claude and Copilot only. Cursor does not support agents — consider using a skill with forkContext: true as an alternative for Cursor.
Finding Existing Agents
List files in <%= agentTemplatePath() %>/ to discover existing agent templates. Read their frontmatter to understand each agent's purpose and capabilities.
Deciding What to Do
- Create new: when you need a new specialized persona with distinct capabilities
- Update existing: when an agent needs adjusted tools, permissions, or system prompt
- Delete: when an agent is no longer needed
Creating a New Agent
- Create a
.md file in <%= agentTemplatePath() %>/ with a descriptive name (e.g. code-reviewer.md)
- Add YAML frontmatter with at minimum
name and description
- Write the agent's system prompt as the body
Frontmatter Fields
See the Agents section in <%= instructionPath('uac-template-guide') %> for the complete field reference and per-target override syntax. Key fields: name, description, model, tools, permissionMode, hooks.
Example
---
name: security-reviewer
description: Reviews code for security vulnerabilities and best practices. Use proactively after code changes.
tools: ["Read", "Grep", "Glob", "Bash"]
model: sonnet
---
You are a security-focused code reviewer. When invoked:
1. Identify the changed files
2. Check for common vulnerabilities (injection, XSS, auth issues)
3. Review dependency usage for known CVEs
4. Report findings by severity (critical, warning, info)
Converted and distributed by TomeVault — claim your Tome and manage your conversions.
