Skip to content
cccskills
FreePublished on GitHub

github-labels-query

Retrieve labels from a GitHub repository, filter their names by partial matches, and choose page sizes and page numbers. Results arrive as JSON, including label names, colors, descriptions, and pagination details.

OriginalShow the original description

List GitHub repository labels with per_page pagination and name filtering support.

Works withGitHub
See how to install

Good for

  • Check the labels available in a repository
  • Find labels whose names contain a specific word
  • Retrieve label lists in pages of a chosen size

Files included (2)

  • SKILL.md1.9 KB
  • query-labels.sh2.9 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

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

ParameterRequiredDefaultDescription
--ownerYes-Repository owner (username or organization)
--repoYes-Repository name
--per-pageNo10Results per page (1–100)
--pageNo1Page number
--name-filterNo-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.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Coordinate work across AI agents with shared rules for locating team files, recording decisions and their reasons, and requesting help. It also defines who owns revisions after a reviewer rejects an artifact.

  • Locate team files across separate working directories
  • Record decisions that affect other agents
  • Request input from another specialist
github/gh-aw5.4KUpdated Oct 19, 2026

agent-conduct

FreeSummary

Set shared development rules for an agent team: keep specific agent names out of product code, tests, and CI configuration, verify affected tests before finishing, and record lessons learned from mistakes.

  • Share development rules across multiple agents
  • Keep team-specific agent names out of code and tests
  • Check affected tests before declaring work complete
github/gh-aw5.4KUpdated Oct 19, 2026

Routes requests to design, create, update, debug, or upgrade GitHub Agentic Workflows to the appropriate instructions. It helps the agent select a workflow-specific procedure and apply any additional rules defined for the repository.

  • Designing a new workflow through questions
  • Investigating failed runs and recurring errors
  • Upgrading workflows and addressing deprecations
github/gh-aw5.4KUpdated Oct 19, 2026

Prepare architecture proposals before implementation so the team can agree on a direction. Organize evidence, technical choices, effects on existing work, risks, and the first release’s scope into a document with clear recommendations and decision owners.

  • Proposing a major architecture change
  • Replanning milestones after a foundation change
  • Comparing technical options before seeking approval
github/gh-aw5.4KUpdated Oct 19, 2026

Update the gh-aw-firewall version used by gh-aw, rebuild generated files, and review release notes and configuration schemas, which define valid settings. It guides related code and test updates while identifying follow-up work that remains.

  • Updating the firewall version used by gh-aw
  • Reviewing release notes for integration changes
  • Checking configuration schema differences
github/gh-aw5.4KUpdated Oct 19, 2026

Review git and gh operations in gh-aw workflows to check credential availability for each repository. Identify missing token handoffs, risky expansions of limited checkouts, and error handling needed where credentials are intentionally unavailable.

  • Reviewing git operations after repository checkout
  • Checking tokens for private cross-repository access
  • Reviewing sparse and shallow checkout changes
github/gh-aw5.4KUpdated Oct 19, 2026

See all skills by github

Report a problem with this skill