Building Advanced GitHub Issue Searches

Build and execute complex GitHub issue searches with nested boolean logic.

1|Updated Jun 4, 2025
One-click install
npx skills add https://github.com/kynoptic/markdownlint-trap --skill building-advanced-github-issue-searches
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Building Advanced GitHub Issue Searches
Source: https://github.com/kynoptic/markdownlint-trap/tree/main/.claude/skills/gh-issue-search-advanced
Command: npx skills add https://github.com/kynoptic/markdownlint-trap --skill building-advanced-github-issue-searches

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gh.

What problem does it solve?

Manually sifting through GitHub issues for specific criteria is time-consuming and complex, especially with intricate boolean logic or nested queries. This Skill automates the construction and execution of advanced searches, helping you quickly pinpoint the exact issues you need.

Core Features & Use Cases

  • Complex Query Builder: Constructs advanced GitHub issue queries with AND/OR operators and up to 5 levels of nested logic.
  • Multi-faceted Filtering: Searches across states, labels, assignees, authors, date ranges, issue types, milestones, and projects.
  • Flexible Output: Presents results via GraphQL, REST API, or web UI, with options for table, JSON, CSV, or Markdown formats.
  • Use Case: Quickly find all open, high-priority bugs assigned to your team that were updated in the last week, and export them to a CSV for a report.

Quick Start

Use the "Building Advanced GitHub Issue Searches" skill to find all open issues assigned to me with either a "bug" or "security" label, created after 2025-01-01.

Frequently Asked Questions about Building Advanced GitHub Issue Searches

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build complex GitHub issue searches with boolean logic?

Complex GitHub issue searches use AND, OR operators and nested parentheses up to five levels deep to filter by state, labels, assignees, authors, dates, milestones, and projects. This Skill constructs and executes these queries automatically, properly escaping syntax so results match your exact criteria across GraphQL, REST, and web UI pathways.

Can I filter GitHub issues by multiple criteria at once?

Yes. This Skill filters simultaneously across states, labels, assignees, authors, date ranges, issue types, milestones, and projects in a single query. You specify your criteria once and retrieve all matching issues without manual refinement across multiple searches.

What output formats does GitHub issue search support?

GitHub issue search results can be exported as table, JSON, CSV, or Markdown formats. This Skill presents structured results in your preferred format, making it easy to integrate findings into reports, data pipelines, or documentation systems.

How do I export GitHub issues to CSV for reporting?

After building your search query with filters like assignee, label, and date range, this Skill executes the search and exports results directly to CSV format. You get a structured file ready for spreadsheet analysis or stakeholder reports without manual data entry.

Can GitHub issue searches use nested queries?

Yes. This Skill supports nested queries up to five levels deep, letting you combine complex boolean logic with multiple filter types. Proper escaping ensures parentheses and operators parse correctly across GitHub's GraphQL, REST, and web interfaces.

Do I need the GitHub CLI to run advanced issue searches?

The GitHub CLI (gh) is a dependency for this Skill. It provides the foundation for executing queries and retrieving results, though this Skill also interoperates with GraphQL and REST API pathways to deliver the same results across different access methods.