$npx -y skills add adityahimaone/hermes-agent-rtk-caveman --skill github-issuesCreate, manage, triage, and close GitHub issues. Search existing issues, add labels, assign people, and link to PRs. Works with gh CLI or falls back to git + GitHub REST API via curl.
| 1 | # GitHub Issues Management |
| 2 | |
| 3 | Create, search, triage, and manage GitHub issues. Each section shows `gh` first, then the `curl` fallback. |
| 4 | |
| 5 | ## Prerequisites |
| 6 | |
| 7 | - Authenticated with GitHub (see `github-auth` skill) |
| 8 | - Inside a git repo with a GitHub remote, or specify the repo explicitly |
| 9 | |
| 10 | ### Setup |
| 11 | |
| 12 | ```bash |
| 13 | if command -v gh &>/dev/null && gh auth status &>/dev/null; then |
| 14 | AUTH="gh" |
| 15 | else |
| 16 | AUTH="git" |
| 17 | if [ -z "$GITHUB_TOKEN" ]; then |
| 18 | if [ -f ~/.hermes/.env ] && grep -q "^GITHUB_TOKEN=" ~/.hermes/.env; then |
| 19 | GITHUB_TOKEN=$(grep "^GITHUB_TOKEN=" ~/.hermes/.env | head -1 | cut -d= -f2 | tr -d '\n\r') |
| 20 | elif grep -q "github.com" ~/.git-credentials 2>/dev/null; then |
| 21 | GITHUB_TOKEN=$(grep "github.com" ~/.git-credentials 2>/dev/null | head -1 | sed 's|https://[^:]*:\([^@]*\)@.*|\1|') |
| 22 | fi |
| 23 | fi |
| 24 | fi |
| 25 | |
| 26 | REMOTE_URL=$(git remote get-url origin) |
| 27 | OWNER_REPO=$(echo "$REMOTE_URL" | sed -E 's|.*github\.com[:/]||; s|\.git$||') |
| 28 | OWNER=$(echo "$OWNER_REPO" | cut -d/ -f1) |
| 29 | REPO=$(echo "$OWNER_REPO" | cut -d/ -f2) |
| 30 | ``` |
| 31 | |
| 32 | --- |
| 33 | |
| 34 | ## 1. Viewing Issues |
| 35 | |
| 36 | **With gh:** |
| 37 | |
| 38 | ```bash |
| 39 | gh issue list |
| 40 | gh issue list --state open --label "bug" |
| 41 | gh issue list --assignee @me |
| 42 | gh issue list --search "authentication error" --state all |
| 43 | gh issue view 42 |
| 44 | ``` |
| 45 | |
| 46 | **With curl:** |
| 47 | |
| 48 | ```bash |
| 49 | # List open issues |
| 50 | curl -s \ |
| 51 | -H "Authorization: token $GITHUB_TOKEN" \ |
| 52 | "https://api.github.com/repos/$OWNER/$REPO/issues?state=open&per_page=20" \ |
| 53 | | python3 -c " |
| 54 | import sys, json |
| 55 | for i in json.load(sys.stdin): |
| 56 | if 'pull_request' not in i: # GitHub API returns PRs in /issues too |
| 57 | labels = ', '.join(l['name'] for l in i['labels']) |
| 58 | print(f\"#{i['number']:5} {i['state']:6} {labels:30} {i['title']}\")" |
| 59 | |
| 60 | # Filter by label |
| 61 | curl -s \ |
| 62 | -H "Authorization: token $GITHUB_TOKEN" \ |
| 63 | "https://api.github.com/repos/$OWNER/$REPO/issues?state=open&labels=bug&per_page=20" \ |
| 64 | | python3 -c " |
| 65 | import sys, json |
| 66 | for i in json.load(sys.stdin): |
| 67 | if 'pull_request' not in i: |
| 68 | print(f\"#{i['number']} {i['title']}\")" |
| 69 | |
| 70 | # View a specific issue |
| 71 | curl -s \ |
| 72 | -H "Authorization: token $GITHUB_TOKEN" \ |
| 73 | https://api.github.com/repos/$OWNER/$REPO/issues/42 \ |
| 74 | | python3 -c " |
| 75 | import sys, json |
| 76 | i = json.load(sys.stdin) |
| 77 | labels = ', '.join(l['name'] for l in i['labels']) |
| 78 | assignees = ', '.join(a['login'] for a in i['assignees']) |
| 79 | print(f\"#{i['number']}: {i['title']}\") |
| 80 | print(f\"State: {i['state']} Labels: {labels} Assignees: {assignees}\") |
| 81 | print(f\"Author: {i['user']['login']} Created: {i['created_at']}\") |
| 82 | print(f\"\n{i['body']}\")" |
| 83 | |
| 84 | # Search issues |
| 85 | curl -s \ |
| 86 | -H "Authorization: token $GITHUB_TOKEN" \ |
| 87 | "https://api.github.com/search/issues?q=authentication+error+repo:$OWNER/$REPO" \ |
| 88 | | python3 -c " |
| 89 | import sys, json |
| 90 | for i in json.load(sys.stdin)['items']: |
| 91 | print(f\"#{i['number']} {i['state']:6} {i['title']}\")" |
| 92 | ``` |
| 93 | |
| 94 | ## 2. Creating Issues |
| 95 | |
| 96 | **With gh:** |
| 97 | |
| 98 | ```bash |
| 99 | gh issue create \ |
| 100 | --title "Login redirect ignores ?next= parameter" \ |
| 101 | --body "## Description |
| 102 | After logging in, users always land on /dashboard. |
| 103 | |
| 104 | ## Steps to Reproduce |
| 105 | 1. Navigate to /settings while logged out |
| 106 | 2. Get redirected to /login?next=/settings |
| 107 | 3. Log in |
| 108 | 4. Actual: redirected to /dashboard (should go to /settings) |
| 109 | |
| 110 | ## Expected Behavior |
| 111 | Respect the ?next= query parameter." \ |
| 112 | --label "bug,backend" \ |
| 113 | --assignee "username" |
| 114 | ``` |
| 115 | |
| 116 | **With curl:** |
| 117 | |
| 118 | ```bash |
| 119 | curl -s -X POST \ |
| 120 | -H "Authorization: token $GITHUB_TOKEN" \ |
| 121 | https://api.github.com/repos/$OWNER/$REPO/issues \ |
| 122 | -d '{ |
| 123 | "title": "Login redirect ignores ?next= parameter", |
| 124 | "body": "## Description\nAfter logging in, users always land on /dashboard.\n\n## Steps to Reproduce\n1. Navigate to /settings while logged out\n2. Get redirected to /login?next=/settings\n3. Log in\n4. Actual: redirected to /dashboard\n\n## Expected Behavior\nRespect the ?next= query parameter.", |
| 125 | "labels": ["bug", "backend"], |
| 126 | "assignees": ["username"] |
| 127 | }' |
| 128 | ``` |
| 129 | |
| 130 | ### Bug Report Template |
| 131 | |
| 132 | ``` |
| 133 | ## Bug Description |
| 134 | <What's happening> |
| 135 | |
| 136 | ## Steps to Reproduce |
| 137 | 1. <step> |
| 138 | 2. <step> |
| 139 | |
| 140 | ## Expected Behavior |
| 141 | <What should happen> |
| 142 | |
| 143 | ## Actual Behavior |
| 144 | <What actually happens> |
| 145 | |
| 146 | ## Environment |
| 147 | - OS: <os> |
| 148 | - Version: <version> |
| 149 | ``` |
| 150 | |
| 151 | ### Feature Request Template |
| 152 | |
| 153 | ``` |
| 154 | ## Feature Description |
| 155 | <What you want> |
| 156 | |
| 157 | ## Motivation |
| 158 | <Why this would be useful> |
| 159 | |
| 160 | ## Proposed Solution |
| 161 | <How it could work> |
| 162 | |
| 163 | ## Alternatives Considered |
| 164 | <Other approaches> |
| 165 | ``` |
| 166 | |
| 167 | ## 3. Managing Issues |
| 168 | |
| 169 | ### Add/Remove Labels |
| 170 | |
| 171 | **With gh:** |
| 172 | |
| 173 | ```bash |
| 174 | gh issue edit 42 --add-label "priority:high,bug" |
| 175 | gh issue edit 42 --remove-label "needs-triage" |
| 176 | ``` |
| 177 | |
| 178 | **With curl:** |
| 179 | |
| 180 | ```bash |
| 181 | # Add labels |
| 182 | curl -s -X POST \ |
| 183 | -H "Authorization: token $G |