Skip to main content

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.

ChapterYou doYou learn
0. PrerequisitesDo the Quick Start, and check what each chapter needs.What you need
1. Define the Agent in YAMLMove 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 YAMLSet the model, thinking and limits. Compare two runs.Model names, defaults, limits and good instructions
3. Add a SkillAdd a skill with your team's review rules and see the agent load it.Skills and instructions, and skills: references
4. Filter ToolsLet 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 TriggersStart the agent when someone opens a pull request.Triggers, event filters and with
6. Use Commits and BranchesAdd a teammate. Try a change on a branch.Projects, roles and branches
7. Use the Autoheal AssistantDescribe a second agent and review what the Assistant writes.Create with AI and approval cards
8. Use the Autoheal CLIBuild and run an agent from a terminal, then from Claude Code.The autoheal CLI and coding agent skills
9. Next StepsPick 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.