---
title: "Guides"
description: "Step-by-step guides for building GitHub agents that review pull requests, triage issues, fix CI, draft release notes and answer in chat."
canonical_url: "https://github-tools.com/guides"
---
# Guides

> Step-by-step guides for building GitHub agents that review pull requests, triage issues, fix CI, draft release notes and answer in chat.

Each guide builds one working GitHub agent for one job, from install to the command that runs it, with the [preset](https://github-tools.com/presets) and [approval](https://github-tools.com/approval) policy that job needs.

<table>
<thead>
  <tr>
    <th>
      Guide
    </th>
    
    <th>
      Integration
    </th>
    
    <th>
      Preset
    </th>
    
    <th>
      Level
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <a href="https://github-tools.com/guides/review-pull-requests">
        Review pull requests
      </a>
    </td>
    
    <td>
      <a href="https://github-tools.com/integrations/chat-sdk">
        Chat SDK
      </a>
      
      , <a href="https://github-tools.com/integrations/workflow">
        Vercel Workflow
      </a>
    </td>
    
    <td>
      <code>
        code-review
      </code>
    </td>
    
    <td>
      Beginner
    </td>
  </tr>
  
  <tr>
    <td>
      <a href="https://github-tools.com/guides/triage-issues">
        Triage issues
      </a>
    </td>
    
    <td>
      <a href="https://github-tools.com/integrations/eve">
        eve
      </a>
    </td>
    
    <td>
      <code>
        issue-triage
      </code>
    </td>
    
    <td>
      Beginner
    </td>
  </tr>
  
  <tr>
    <td>
      <a href="https://github-tools.com/guides/fix-failing-ci">
        Fix failing CI
      </a>
    </td>
    
    <td>
      <a href="https://github-tools.com/integrations/workflow">
        Vercel Workflow
      </a>
    </td>
    
    <td>
      <code>
        ci-ops
      </code>
    </td>
    
    <td>
      Beginner
    </td>
  </tr>
  
  <tr>
    <td>
      <a href="https://github-tools.com/guides/release-notes">
        Release notes
      </a>
    </td>
    
    <td>
      <a href="https://github-tools.com/integrations/ai-sdk">
        AI SDK
      </a>
    </td>
    
    <td>
      <code>
        release-manager
      </code>
    </td>
    
    <td>
      Beginner
    </td>
  </tr>
  
  <tr>
    <td>
      <a href="https://github-tools.com/guides/chat-bot">
        Chat bot
      </a>
    </td>
    
    <td>
      <a href="https://github-tools.com/integrations/chat-sdk">
        Chat SDK
      </a>
      
      , <a href="https://github-tools.com/integrations/workflow">
        Vercel Workflow
      </a>
    </td>
    
    <td>
      <code>
        issue-triage
      </code>
    </td>
    
    <td>
      Beginner
    </td>
  </tr>
  
  <tr>
    <td>
      <a href="https://github-tools.com/guides/multi-agent">
        Multi-agent
      </a>
    </td>
    
    <td>
      <a href="https://github-tools.com/integrations/eve">
        eve
      </a>
      
      , <a href="https://github-tools.com/integrations/ai-sdk">
        AI SDK
      </a>
    </td>
    
    <td>
      <code>
        code-review
      </code>
      
      , <code>
        issue-triage
      </code>
      
      , <code>
        release-manager
      </code>
    </td>
    
    <td>
      Advanced
    </td>
  </tr>
</tbody>
</table>

New to agents? Start with [Your first agent](https://github-tools.com/learn/first-agent), which builds an issue-triage agent in a terminal and explains each part.

## Runnable projects

Two guides come from projects in the repository's [`examples/`](https://github.com/vercel-labs/github-tools/tree/main/examples) folder:

- [`examples/pr-review-agent`](https://github.com/vercel-labs/github-tools/tree/main/examples/pr-review-agent) is the bot in [Review pull requests](https://github-tools.com/guides/review-pull-requests), and the starting point for [Chat bot](https://github-tools.com/guides/chat-bot).
- [`examples/eve`](https://github.com/vercel-labs/github-tools/tree/main/examples/eve) is an eve agent you can clone and deploy as is, with `preset: 'auto'` and `requireApproval: 'auto'`, reachable from Slack and from GitHub mentions.

## Production templates

[Software Factory](https://github.com/vercel-labs/eve-software-factory-template) ([deploy](https://vercel.com/templates/eve/eve-software-factory)) takes work from GitHub and Linear through a classifier, an analyst, an implementer and a reviewer, and ends with a reviewed draft pull request for a person to merge. [Incident Response](https://github.com/vercel-labs/eve-sre-agent-template) ([deploy](https://vercel.com/templates/eve/eve-incident-response-agent)) investigates production alerts with live Datadog, GitHub and Vercel data, read-only by default. Both are eve agents that mount `@github-tools/eve-extension` with a Vercel Connect connector.


## Sitemap

See the full [sitemap](https://github-tools.com/sitemap.md) for all pages.