stevenmburns/add-issue-handler

Add Claude Code Issue Handler

Create a GitHub Actions workflow that triggers when a bug or enhancement issue is opened or labeled, and invokes Claude Code to fix or implement it using the project's /fix-issue and /build-issue skills.

Steps

1. Get the dot-claude-files URL

The project's Claude skills live in ~/.claude. The workflow must clone that repo in CI so the skills are available at runtime.

git -C ~/.claude remote get-url origin

Convert the result from SSH to HTTPS format:

• [email protected]:user/repo.git → https://github.com/user/repo

2. Create a new branch

git checkout -b ci/add-claude-issue-handler

3. Create .github/workflows/claude-issue-handler.yml

Create the directory if needed: mkdir -p .github/workflows

Write the file, substituting the actual HTTPS dot-claude-files URL for <DOT_CLAUDE_URL>:

name: Claude Issue Handler

on:
  issues:
    types: [opened, labeled]

jobs:
  fix-bug:
    if: contains(github.event.issue.labels.*.name, 'bug')
    runs-on: ubuntu-latest
    permissions:
      contents: write
      issues: write
      pull-requests: write
      id-token: write
    steps:
      - uses: actions/checkout@v4
      - name: Set up Claude config
        run: git clone <DOT_CLAUDE_URL> ~/.claude
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          prompt: "/fix-issue ${{ github.event.issue.number }}"

  build-feature:
    if: contains(github.event.issue.labels.*.name, 'enhancement')
    runs-on: ubuntu-latest
    permissions:
      contents: write
      issues: write
      pull-requests: write
      id-token: write
    steps:
      - uses: actions/checkout@v4
      - name: Set up Claude config
        run: git clone <DOT_CLAUDE_URL> ~/.claude
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          prompt: "/build-issue ${{ github.event.issue.number }}"

4. Commit

git add .github/workflows/claude-issue-handler.yml
git commit -m "ci: add Claude Code issue handler workflow"

5. Report to the user

• The path to the workflow file created
• Remind them to add ANTHROPIC_API_KEY to repo secrets: Settings → Secrets and variables → Actions → New repository secret
• Remind them to install the Claude Code GitHub App on the repo: https://github.com/apps/claude → Install → select the repo. Without this the action will fail with a 401 error.
• The dot-claude-files repo must be public (or cloned with a token) — the CI runner cannot authenticate to clone a private repo over HTTPS without credentials.
• The workflow fires when a bug or enhancement label is present at issue open time, or added later via labeling
• Run /create-pr when ready to merge