Lists GitHub labels for any repository using controlled page sizes for efficient API requests.
Install
mkdir -p .claude/skills/github-labels-query && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/10134" && unzip -o skill.zip -d .claude/skills/github-labels-query && rm skill.zipInstalls to .claude/skills/github-labels-query
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.
List GitHub repository labels with per_page pagination support.Key capabilities
- →List repository labels
- →Paginate label results
- →Control page size
- →Retrieve label metadata
- →Query GitHub REST API
How it works
It queries the GitHub REST API to fetch labels with configurable pagination parameters.
Inputs & outputs
When to use github-labels-query
- →Listing all labels in a repository
- →Auditing labels across different projects
- →Fetching label data for programmatic use
About this skill
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
Filtering by name
# Only labels whose name contains "bug" (case-insensitive)
./query-labels.sh --owner github --repo gh-aw --name-filter bug
When --name-filter is set, all labels are fetched and filtered, then
--per-page/--page are applied to the filtered results.
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 |
--name-filter | No | - | Case-insensitive substring filter on the label name |
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}
When --name-filter is used, the script pages through all labels
(--paginate) before filtering and slicing locally.
When not to use it
- →When repository is private without access
- →When pagination is not required
Limitations
- →Max 100 results per page
How it compares
It provides a simplified command-line interface for paginated label retrieval compared to raw API calls.
Compared to similar skills
github-labels-query side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| github-labels-query (this skill) | 0 | 2mo | Review | Beginner |
| resolve-conflicts | 81 | 8mo | Review | Intermediate |
| openspec-onboard | 10 | 6mo | Review | Beginner |
| codex-cli-bridge | 9 | 9mo | Review | Intermediate |
Try saying
Example prompts that trigger this skill in your AI assistant.
More by github
View all by github →You might also like
resolve-conflicts
antinomyhq
Use this skill immediately when the user mentions merge conflicts that need to be resolved. Do not attempt to resolve conflicts directly - invoke this skill first. This skill specializes in providing a structured framework for merging imports, tests, lock files (regeneration), configuration files, and handling deleted-but-modified files with backup and analysis.
openspec-onboard
studyzy
Guided onboarding for OpenSpec - walk through a complete workflow cycle with narration and real codebase work.
codex-cli-bridge
alirezarezvani
Bridge between Claude Code and OpenAI Codex CLI - generates AGENTS.md from CLAUDE.md, provides Codex CLI execution helpers, and enables seamless interoperability between both tools
skill-sync
KyleKing
Syncs Claude Skills with other AI coding tools like Cursor, Copilot, and Codeium by creating cross-references and shared knowledge bases. Invoke when user wants to leverage skills across multiple tools or create unified AI context.
github-workflow-automation
ruvnet
Advanced GitHub Actions workflow automation with AI swarm coordination, intelligent CI/CD pipelines, and comprehensive repository management
git-advanced-workflows
wshobson
Master advanced Git workflows including rebasing, cherry-picking, bisect, worktrees, and reflog to maintain clean history and recover from any situation. Use when managing complex Git histories, collaborating on feature branches, or troubleshooting repository issues.