Build Your First Agent
In this tutorial, you grow the PR Review agent from the Quick Start into an agent that a team can use. Each chapter adds one thing and takes about 10 minutes. You can stop after any chapter and keep a working agent.
| Chapter | You do | You learn |
|---|---|---|
| 0. Prerequisites | Do the Quick Start, and check what each chapter needs. | What you need |
| 1. Define the Agent in YAML | Move the instructions to a Markdown file. Add a description, an icon and an input. | The agent.yaml fields, drafts, commits and validation |
| 2. Customize the Agent YAML | Set the model, thinking and limits. Compare two runs. | Model names, defaults, limits and good instructions |
| 3. Add a Skill | Add a skill with your team's review rules and see the agent load it. | Skills and instructions, and skills: references |
| 4. Filter Tools | Let the agent read the repository. Connect GitHub, and let the agent post its review as a comment. | System tools, integration tools, the shell, and tool filters |
| 5. Set Up Triggers | Start the agent when someone opens a pull request. | Triggers, event filters and with |
| 6. Use Commits and Branches | Add a teammate. Try a change on a branch. | Projects, roles and branches |
| 7. Use the Autoheal Assistant | Describe a second agent and review what the Assistant writes. | Create with AI and approval cards |
| 8. Use the Autoheal CLI | Build and run an agent from a terminal, then from Claude Code. | The autoheal CLI and coding agent skills |
| 9. Next Steps | Pick a track. | Seven 30 to 60 minute tracks, from ready-made agents to alerts |
Before you start
Do the Quick Start first. 0. Prerequisites lists what else each chapter needs.