GI

github-issue-retrieve

Allows searching and fetching GitHub issue data with simple prompts.

Install

mkdir -p .claude/skills/github-issue-retrieve && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/15310" && unzip -o skill.zip -d .claude/skills/github-issue-retrieve && rm skill.zip

Installs to .claude/skills/github-issue-retrieve

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

Retrieve GitHub issues from the upuli2 repository. Use when: fetching issue details by number, searching issues by title/labels, or listing recent issues. Supports both GitHub CLI and direct API.
195 chars✓ has a “when” trigger
Beginner

Key capabilities

  • Retrieve GitHub issues by number
  • Search GitHub issues by title or labels
  • List recent GitHub issues
  • Use `gh` CLI for issue retrieval
  • Fall back to `curl` API for issue retrieval
  • Handle GitHub authentication

How it works

The skill uses a helper script that first attempts to retrieve GitHub issues from the `ikaem/upuli2` repository using the `gh` CLI, falling back to the GitHub API via `curl` if the CLI is unavailable.

Inputs & outputs

You give it
Issue number, search query, number of recent issues
You get back
Full issue details, list of matching issues, or summary table of recent issues

When to use github-issue-retrieve

  • Searching for bugs by label
  • Fetching issue details by number
  • Listing recent project issues

About this skill

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)

When not to use it

  • When the repository is not `ikaem/upuli2`
  • When only unauthenticated requests are allowed
  • When the user wants to update issues

Limitations

  • The skill operates on the `ikaem/upuli2` repository.
  • Rate limits apply to GitHub API requests.
  • The skill does not support updating issues.

How it compares

This skill provides a unified interface for retrieving GitHub issues with built-in fallbacks and authentication handling, simplifying issue access compared to manually interacting with the CLI or API.

Compared to similar skills

github-issue-retrieve side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
github-issue-retrieve (this skill)04moCautionBeginner
flow-next-work12moReviewAdvanced
work-on-issue06moReviewIntermediate
issues03moReviewBeginner

Try saying

Example prompts that trigger this skill in your AI assistant.

Search skills

Search the agent skills registry