Skip to content

IvanCampos/agents / skills/github

Use the GitHub CLI (`gh`) to inspect and manage repositories, pull requests, issues, workflows, releases, and API calls from the terminal. Use when a user asks to use `gh`/GitHub CLI, run GitHub repo or PR workflows, automate GitHub Actions from shell, or troubleshoot `gh` authentication and configuration.

FileKindSize
SKILL.mdskill md3.5 KB
agents/openai.yamlconfig212 B
references/command-map.mdmarkdown2.2 KB
scripts/gh_preflight.shexecutablescript1.6 KB

scripts/gh_preflight.sh

View on GitHub
#!/usr/bin/env bash
set -euo pipefail

usage() {
  cat <<'USAGE'
Usage:
  gh_preflight.sh [--repo owner/repo] [--host github.com]

Options:
  --repo  Verify access to a specific repository.
  --host  GitHub host for auth checks (default: github.com).
USAGE
}

repo=""
host="github.com"

while [[ $# -gt 0 ]]; do
  case "$1" in
    --repo)
      repo="${2:-}"
      shift 2
      ;;
    --host)
      host="${2:-}"
      shift 2
      ;;
    -h|--help)
      usage
      exit 0
      ;;
    *)
      echo "Unknown argument: $1" >&2
      usage
      exit 2
      ;;
  esac
done

if ! command -v gh >/dev/null 2>&1; then
  echo "gh is not installed. Install from https://cli.github.com/" >&2
  exit 127
fi

echo "GitHub CLI:"
gh --version | head -n 2

echo
echo "Auth status (${host}):"
if ! gh auth status --hostname "$host"; then
  echo
  echo "Run: gh auth login --hostname $host" >&2
  exit 2
fi

print_repo() {
  local target="$1"
  gh repo view "$target" \
    --json nameWithOwner,url,defaultBranchRef,isPrivate \
    --template '{{.nameWithOwner}}{{"\n"}}{{.url}}{{"\n"}}default={{.defaultBranchRef.name}} private={{.isPrivate}}{{"\n"}}'
}

if [[ -n "$repo" ]]; then
  echo
  echo "Repository context (${repo}):"
  print_repo "$repo"
  exit 0
fi

if git rev-parse --is-inside-work-tree >/dev/null 2>&1; then
  if gh repo view >/dev/null 2>&1; then
    echo
    echo "Repository context (current directory):"
    gh repo view \
      --json nameWithOwner,url,defaultBranchRef,isPrivate \
      --template '{{.nameWithOwner}}{{"\n"}}{{.url}}{{"\n"}}default={{.defaultBranchRef.name}} private={{.isPrivate}}{{"\n"}}'
  fi
fi
receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementationStars: 319kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 319kUpdated Claude CodeCodexVerifiedInstall
using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallbackStars: 319kUpdated Claude CodeCodexVerifiedInstall
verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions alwaysStars: 319kUpdated Claude CodeCodexVerifiedInstall