skills.rest
SebastienDegodez
SebastienDegodezCOMMUNITY
Explore all skills by this author →
GitHub

github-search-protocol

Construct GitHub issue search queries with qualifiers and pagination.

8|2|Updated Apr 16, 2026
Search Tags:#github#search#pagination#mcp tools#issue discovery
One-click install
npx skills add https://github.com/SebastienDegodez/skraft-plugin --skill github-search-protocol
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: github-search-protocol
Source: https://github.com/SebastienDegodez/skraft-plugin/tree/main/plugins/skills/github-search-protocol
Command: npx skills add https://github.com/SebastienDegodez/skraft-plugin --skill github-search-protocol

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, yaml, and includes scripts (resource) and references (resource) components.

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"

Frequently Asked Questions about github-search-protocol

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

FAQPage Schema
How do I build precise GitHub search queries to find specific issues?▼

Build precise GitHub search queries by utilizing a comprehensive set of qualifiers and boolean logic to construct exact issue search queries. This approach filters results by labels, milestones, or assignees for accurate issue discovery.

How can I automatically discover GitHub issues related to the files I am currently modifying?▼

Automatically discover related GitHub issues through artifact-driven discovery. This mode extracts relevant files you are currently modifying, builds a targeted query, and presents top-ranked issues based on domain relevance.

What is the best way to handle GitHub search pagination for large sets of results?▼

Handle GitHub search pagination efficiently by implementing dedicated pagination management strategies. This approach processes and retrieves large sets of search results without hitting API limitations or losing data.

Can I use MCP tools to search and write GitHub issues?▼

Yes, you can use MCP tools to search and write GitHub issues. The protocol integrates directly with mcp_github_search_issues and mcp_github_issue_write tools for seamless GitHub API interaction and management.

How are GitHub search results ranked and prioritized?▼

GitHub search results are ranked and prioritized based on relevance. The ranking considers primary and secondary domain terms, as well as recent activity, to surface the most pertinent issues first.

Related Skills

Explore More Software Engineering Skills→
codenamevcodenamev
74

pragmatic-guard

Configure pragmatic mode with intensity levels, triggers, exemptions, and deferrals.

Community
Basic
PiklarPiklar

speckit-taskstoissues

Convert project tasks into dependency-ordered GitHub issues.

Community
Advanced
OKHP3OKHP3
2

okhp3-foundry-repo-creator

Convert AI-driven assets and ideas into standardized GitHub repositories.

Community
Advanced
bravebrave
164

web-search

Perform web searches with ranked results, snippets, URLs, and filters.

Official
Intermediate