Skills
Skill 13 of 54
Query GitHub discussions with jq filtering and reusable selectors.
1 minute · 198 words · 11 sections
Install
npx skills add github/gh-aw --skill github-discussion-querynpx skills add github/gh-awThe first command installs just this skill, by the name in its SKILL.md; the second installs the whole repository.
The --jq parameter is optional. Without --jq, this skill returns schema and data size information instead of full data.
Use this to avoid oversized responses and inspect structure before targeted queries.
Use --jq '.' to get all data, or use a more specific filter for targeted results.
Use this skill to query discussions from the current repository or any specified repository.
To list discussions from the current repository:
./query-discussions.sh
# Returns schema and data size, not full dataTo get all discussion data:
./query-discussions.sh --jq '.'To query a specific repository:
./query-discussions.sh --repo owner/repoUse the --jq argument to filter and transform the output:
# Get discussion numbers and titles
./query-discussions.sh --jq '.[] | {number, title}'
# Get discussions by a specific author
./query-discussions.sh --jq '.[] | select(.author.login == "username")'
# Get discussions in a specific category
./query-discussions.sh --jq '.[] | select(.category.name == "Ideas")'
# Get answered discussions
./query-discussions.sh --jq '.[] | select(.answer != null)'
# Count discussions by category
./query-discussions.sh --jq 'group_by(.category.name) | map({category: .[0].category.name, count: length})'--limit: Maximum number of discussions to fetch. Default: 30--repo: Repository in owner/repo format. Default: current repo--jq: (Optional) jq expression for filtering/transforming output. If omitted, returns schema infoFind discussions with many comments:
./query-discussions.sh --jq '.[] | select(.comments.totalCount > 5) | {number, title, comments: .comments.totalCount}'Get unanswered discussions:
./query-discussions.sh --jq '.[] | select(.answer == null) | {number, title, category: .category.name}'List discussions with their labels:
./query-discussions.sh --jq '.[] | {number, title, labels: [.labels[].name]}'Find discussions by category:
./query-discussions.sh --jq '.[] | select(.category.name == "Q&A") | {number, title, author: .author.login}'Get recently updated discussions:
./query-discussions.sh --jq 'sort_by(.updatedAt) | reverse | .[0:10] | .[] | {number, title, updatedAt}'The script outputs JSON by default, making it easy to pipe through jq for additional processing.
gh) authenticatedjq for filtering (installed by default on most systems)main, last pushed 24 September 2026.SKILL.md, not by matching a directory convention. 4 distinct layouts observed: .claude/skills/*/SKILL.md, .github/skills/*/SKILL.md, .squad/*/skill.md, SKILL.md (repo root).h1 and no skipped levels:/github/gh-aw.md, and each skill at its own .md URL.2 files · 8 KB
Everything this skill ships beside its prose. All of it is set here, as subchapters of skill 13.
Everything else published alongside the skill.