Scout Repo Agent — Git skill for Claude Code

Scout 🦉

Scout is a GitHub Action that triages new issues using Anthropic. When an issue is opened, Scout:

1. Searches for similar issues and existing workarounds
2. Explores the source code to find where the problem lives
3. Posts a structured comment with a solution, code investigation, and next steps
4. Escalates complex design issues by applying a configurable label

Activity is traced to [Opik](https://opik.com) for observability. Viewers can rate each response with a 👍/👎 reaction, which is synced back to Opik as human feedback — see [Response feedback](#response-feedback).

Setup

1. Configure secrets and variables

In your repository settings, add:

**Secrets** (`Settings → Secrets and variables → Actions → Secrets`):

Secret	Description
ANTHROPIC_API_KEY	Anthropic API key
OPIK_API_KEY	Opik API key

The `github.token` built-in is used for GitHub access — no personal access token or GitHub App required. Comments will appear as `github-actions[bot]`.

**Variables** (`Settings → Secrets and variables → Actions → Variables`):

Variable	Description
SCOUT_GITHUB_REPO_OWNER	Repository owner (e.g. comet-ml)
SCOUT_GITHUB_REPO_NAME	Repository name (e.g. opik)
SCOUT_ESCALATION_TAG	Label name for escalated issues (e.g. Escalated-request)
OPIK_WORKSPACE	Opik workspace name

2. Add the workflow

Create `.github/workflows/scout.yml` in your target repository:

name: Scout Issue Triage

on:
  issues:
    types: [opened]
  workflow_dispatch:
    inputs:
      issue_number:
        description: Issue number to triage
        required: true
        type: number

# One Scout run per issue at a time
concurrency:
  group: scout-issue-${{ github.event.issue.number || github.event.inputs.issue_number }}
  cancel-in-progress: false

jobs:
  triage:
    runs-on: ubuntu-latest
    timeout-minutes: 15
    permissions:
      issues: write
      contents: read

    steps:
      -