Github

GitHub Agent

Drop this in ~/.claude/skills/github/SKILL.md and Claude Code becomes your GitHub assistant.

Bootstrap (ALWAYS Run First)

#!/bin/bash
set -e

# 1. Check if atris CLI is installed
if ! command -v atris &> /dev/null; then
  echo "Installing atris CLI..."
  npm install -g atris
fi

# 2. Check if logged in to AtrisOS
if [ ! -f ~/.atris/credentials.json ]; then
  echo "Not logged in. Run: atris login"
  exit 1
fi

# 3. Extract token
if command -v node &> /dev/null; then
  TOKEN=$(node -e "console.log(require('$HOME/.atris/credentials.json').token)")
elif command -v python3 &> /dev/null; then
  TOKEN=$(python3 -c "import json,os; print(json.load(open(os.path.expanduser('~/.atris/credentials.json')))['token'])")
else
  TOKEN=$(jq -r '.token' ~/.atris/credentials.json)
fi

# 4. Check GitHub connection
STATUS=$(curl -s "https://api.atris.ai/api/integrations/github/status" \
  -H "Authorization: Bearer $TOKEN")

CONNECTED=$(echo "$STATUS" | python3 -c "import sys,json; print(json.load(sys.stdin).get('connected', False))" 2>/dev/null || echo "false")

if [ "$CONNECTED" != "true" ] && [ "$CONNECTED" != "True" ]; then
  echo "GitHub not connected. Getting authorization URL..."
  AUTH=$(curl -s -X POST "https://api.atris.ai/api/integrations/github/start" \
    -H "Authorization: Bearer $TOKEN" \
    -H "Content-Type: application/json" \
    -d '{"return_url":"https://atris.ai/settings/integrations"}')

  URL=$(echo "$AUTH" | python3 -c "import sys,json; print(json.load(sys.stdin).get('auth_url', ''))")

  echo ""
  echo "Open this URL to connect GitHub:"
  echo "$URL"
  echo ""
  echo "After authorizing, run your command again."
  exit 0
fi

echo "Ready. GitHub is connected."
export ATRIS_TOKEN="$TOKEN"

Tool Actions

The GitHub tool is available to agents as github. All actions accept optional owner and repo params (defaults to configured repo).

Repos

Pull Requests

Issues

Branches

Commits

CI / Checks

Search

Files

Workflows

"Check open PRs"

1. Bootstrap
2. list_prs with state=open
3. For each PR: get_combined_status with the PR's head ref
4. Display: title, author, CI status, review count, age

"Review a PR"

1. get_pr with pr_number
2. list_pr_files to see what changed
3. get_file on key changed files to read content
4. create_pr_review with body and event (APPROVE/REQUEST_CHANGES/COMMENT)

"Triage new issues"

1. list_issues with state=open
2. For each: inspect title/body for keywords
3. add_labels based on content (bug, feature, docs)
4. create_issue_comment acknowledging triage

"Clean merged branches"

1. list_branches to see all branches
2. list_prs with state=closed to find merged PRs
3. For branches with merged PRs (not main/master/develop): delete_branch

"Get CI status"

1. get_combined_status with ref=main for overall status
2. list_check_runs for individual check details

"Weekly repo report"

1. list_prs with state=all + filter by date
2. list_issues with state=all + filter by date
3. list_commits for recent activity
4. Summarize: PRs merged, issues opened/closed, top contributors

Error Handling

Quick Reference

TOKEN=$(node -e "console.log(require('$HOME/.atris/credentials.json').token)")

# Check connection
curl -s "https://api.atris.ai/api/integrations/github/status" -H "Authorization: Bearer $TOKEN"

# List repos
curl -s "https://api.atris.ai/api/integrations/github/repos" -H "Authorization: Bearer $TOKEN"

# Configure default repo
curl -s -X PUT "https://api.atris.ai/api/integrations/github/config" \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{"owner":"atrislabs","repo":"atrisos-backend","default_branch":"master"}'

# Disconnect
curl -s -X DELETE "https://api.atris.ai/api/integrations/github" -H "Authorization: Bearer $TOKEN"