atrislabs/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

| Action | Params | Description | |--------|--------|-------------| | list_repos | per_page | List your accessible repos | | get_repo | owner, repo | Get repo details |

Pull Requests

| Action | Params | Description | |--------|--------|-------------| | list_prs | state (open/closed/all), per_page | List PRs | | get_pr | pr_number | Get PR details + merge status | | create_pr | title, head, base, body | Open a PR | | list_pr_files | pr_number | Files changed in PR | | list_pr_reviews | pr_number | Reviews on PR | | create_pr_review | pr_number, body, event | Add review (APPROVE/REQUEST_CHANGES/COMMENT) | | create_pr_comment | pr_number, body | Comment on PR | | merge_pr | pr_number, merge_method | Merge PR (squash/merge/rebase) |

Issues

| Action | Params | Description | |--------|--------|-------------| | list_issues | state, labels, per_page | List issues | | get_issue | issue_number | Get issue details | | create_issue | title, body, labels | Open issue | | update_issue | issue_number, title/body/state/labels | Update issue | | list_issue_comments | issue_number | Get issue comments | | create_issue_comment | issue_number, body | Comment on issue | | add_labels | issue_number/pr_number, labels | Add labels |

Branches

| Action | Params | Description | |--------|--------|-------------| | list_branches | per_page | List branches | | create_branch | branch, from_ref | Create branch from ref | | delete_branch | branch | Delete branch |

Commits

| Action | Params | Description | |--------|--------|-------------| | list_commits | sha/branch, per_page | Recent commits | | get_commit | ref | Commit details | | compare_commits | base, head | Diff between refs |

CI / Checks

| Action | Params | Description | |--------|--------|-------------| | get_combined_status | ref/branch | CI status for ref | | list_check_runs | ref/branch | Check runs (Actions) |

Search

| Action | Params | Description | |--------|--------|-------------| | search_issues | query | Search issues/PRs across repos | | search_code | query | Search code across repos |

Files

| Action | Params | Description | |--------|--------|-------------| | list_contents | path | List directory | | get_file | path, ref | Read file (returns decoded_content) | | put_file | path, message, content, sha, branch | Create/update file |

---

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

| Error | Meaning | Solution | |-------|---------|----------| | GitHub not connected | No OAuth token | Run bootstrap | | GitHub API error (401) | Token expired | Reconnect GitHub in settings | | GitHub API error (403) | Rate limited or no permission | Wait or check repo access | | GitHub API error (404) | Repo/resource not found | Check owner/repo/number | | GitHub API error (422) | Invalid request | Check required params | | No repo specified | No default repo configured | Set default in Settings > Integrations > GitHub |

---

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"