github-search-protocol

What problem does it solve?

This Skill streamlines the process of searching and discovering GitHub issues by constructing precise queries, managing pagination, and filtering by labels, milestones, or assignees.

Core Features & Use Cases

• Advanced Search Query Construction: Utilize a comprehensive set of qualifiers and boolean logic to build exact issue search queries.
• Artifact-Driven Discovery: Automatically find related issues based on the files a developer is currently modifying.
• Multi-Mode Discovery: Offers user-assigned, artifact-driven, and search-based modes for various discovery intents.
• Pagination Management: Implement efficient pagination strategies to handle large sets of search results.
• Result Ranking: Rank and prioritize search results based on relevance, including primary and secondary domain terms and recent activity.
• Integration with MCP Tools: Utilize mcp_github_search_issues and mcp_github_issue_write tools for seamless integration with GitHub's API.
• Use Case: When a developer is looking for all open issues related to the changes they're making to the eligibility domain within the past week, this Skill automatically extracts relevant files, builds a query, and presents the top-ranked issues.

Quick Start

To search for all open issues assigned to the current user and updated in the last month, run:

github-search-protocol --search "assignee:@me updated:>2026-04-01"