github-issue-retrieve

GitHub Issue Retrieval

Skill for fetching and viewing GitHub issues in the upuli2 repository with flexible retrieval methods.

Use Cases

• Retrieve a specific issue by number: "Get me issue #42"
• Search issues by title or label: "Find issues labeled 'bug'"
• List recent issues: "Show me the latest 5 issues"
• Get full issue details for review or updates

Methods

Method 1: By Issue Number (Fastest)

Retrieve a specific issue when you know the number.

Input:

./get-issue.sh --number 42

Output: Full issue details (title, description, state, assignee, labels, comments count)

Method 2: Search by Title/Labels

Find issues matching a query string.

Input:

./get-issue.sh --search "auth"
./get-issue.sh --search "label:bug"
./get-issue.sh --search "state:open assignee:ikaem"

Output: List of matching issues with preview

Method 3: List Recent

Display the N most recent issues.

Input:

./get-issue.sh --recent 5

Output: Summary table of recent issues

Implementation

The skill includes a helper script (get-issue.sh) that:

1. Tries gh CLI first — Fast, formatted output
2. Falls back to curl API — If gh unavailable, uses GitHub token for authentication
3. Handles errors gracefully — Clear messages if issue not found or auth fails

Configuration

Requires GitHub authentication. Supports:

• gh CLI with authentication (checked via gh auth token)
• Personal access token via GITHUB_TOKEN env var
• SSH key for [email protected] (uses ssh-add for key management)

Examples

Get issue #5 (SETUP-004):

./get-issue.sh --number 5

Find all open bugs:

./get-issue.sh --search "state:open label:bug"

Show last 10 issues:

./get-issue.sh --recent 10

Files

• get-issue.sh — Main retrieval script
• parse-issue.sh — Helper to format issue output (called by get-issue.sh)

Notes

• Repository: ikaem/upuli2
• API endpoint: https://api.github.com/repos/ikaem/upuli2/issues
• Rate limit: 60 requests/hour (unauthenticated), 5000/hour (authenticated)