OpenParable
Skip to content
← Back to skills

Github Labels Query

Apps & Automation
github-labels-query

Github Labels Query is an Agent Skill for apps & automation published in the github/gh-aw repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

List GitHub repository labels with per_page pagination support.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/github/gh-aw/blob/HEAD/.github/skills/github-labels-query/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/github-labels-query, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

GitHub Labels Query Skill

List GitHub repository labels with efficient pagination using the --per-page flag.

Usage

Use this script to list labels from any repository with controlled page sizes.

Basic Usage

./query-labels.sh --owner github --repo gh-aw
# Returns 10 labels (default per_page=10)

Pagination

# Get the first label only
./query-labels.sh --owner github --repo gh-aw --per-page 1

# Get 25 labels starting from page 2
./query-labels.sh --owner github --repo gh-aw --per-page 25 --page 2

Parameters

ParameterRequiredDefaultDescription
--ownerYes-Repository owner (username or organization)
--repoYes-Repository name
--per-pageNo10Results per page (1–100)
--pageNo1Page number

Output

Returns JSON with the following fields:

{
  "labels": [
    {
      "id": 12345,
      "node_id": "LA_...",
      "url": "https://api.github.com/repos/owner/repo/labels/bug",
      "name": "bug",
      "color": "d73a4a",
      "default": true,
      "description": "Something isn't working"
    }
  ],
  "item_count": 10,
  "per_page": 10,
  "page": 1
}

Source

Calls the GitHub REST API: GET /repos/{owner}/{repo}/labels?per_page={n}&page={n}