Github Labels Query
Apps & Automationgithub-labels-queryGithub 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.
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- 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
| Parameter | Required | Default | Description |
|---|---|---|---|
--owner | Yes | - | Repository owner (username or organization) |
--repo | Yes | - | Repository name |
--per-page | No | 10 | Results per page (1–100) |
--page | No | 1 | Page 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}