How do I install the Searching Issues skill?

Run npx skillmds@latest add tomevault-io/searching-issues in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Searching Issues safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Searching Issues?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Searching Issues free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Searching Issues?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Searching Issues by tomevault-io — Agent Skill

Name: Searching Issues
Author: tomevault-io

File contents

Issue Search & Discovery

Capability: Native GitHub CLI issue and PR search with 30+ qualifiers

When to use: Searching GitHub Issues/PRs by content, metadata, or complex filters

Quick Commands

Basic Search

# Search across all repositories
gh search issues "authentication error" --repo=owner/repo

# Search in current repository
gh issue list --search "bug"

# Search in multiple fields
gh search issues "database" --match=title,body

Common Filters

# By state and labels
gh search issues --state=open --label=bug,priority:high

# By date range
gh search issues --created="2025-01-01..2025-01-31"

# By assignee or author
gh search issues --assignee=@me --author=username

# By engagement
gh search issues --sort=comments --order=desc

Advanced Qualifiers (30+ available)

Content: in:title, in:body, in:comments State: is:open, is:closed, is:merged, is:draft Labels: label:bug, -label:wontfix, no:label Dates: created:>=2025-01-01, updated:<2025-01-31, closed:2025-01..2025-02 Users: author:username, assignee:username, mentions:username, commenter:username Repos: repo:owner/name, org:orgname, user:username

Complete Syntax Reference: GITHUB_NATIVE_SEARCH_CAPABILITIES.md

Output & Automation

# JSON output for scripting
gh search issues "bug" --json number,title,url,labels --jq '.[] | {number, title}'

# Limit results
gh search issues "bug" --limit=50

# Export to file
gh search issues --label=feature-request --json number,title,body > features.json

Search Limitations

No regex - Use literal strings only
No wildcards - Exact match or phrase search
No context lines - Shows only matching issues, not surrounding context
For file/code search - Use gh grep extension (see file-searching skill)

Common Workflows

Find Your Assigned Issues

gh search issues --assignee=@me --state=open --repo=owner/repo

Find Recent Bugs

gh search issues --label=bug --created=">=2025-10-01" --state=open --sort=created

Search Knowledge Base

# Search Claude Code tips
gh search issues "plan mode" --repo=terrylica/claude-code-skills-github-issues --label=claude-code

Tool Selection Decision

Search Issues/PRs → Use gh search issues (this skill)
Search repository files → Use gh grep (see file-searching skill)
AI-powered operations → Use gh models (see ai-assisted-operations skill)

Empirical Testing: 200+ test cases, 100% coverage of search qualifiers

Full Operational Guide: AI_AGENT_OPERATIONAL_GUIDE.md

Converted and distributed by TomeVault — claim your Tome and manage your conversions.

---name: searching-issuesdescription: Search GitHub Issues and PRs with qualifiers. TRIGGERS - search issues, find issue, issue filter, gh issue list. Use when this capability is needed.---# Issue Search & Discovery**Capability:** Native GitHub CLI issue and PR search with 30+ qualifiers**When to use:** Searching GitHub Issues/PRs by content, metadata, or complex filters---## Quick Commands### Basic Search```bash# Search across all repositoriesgh search issues "authentication error" --repo=owner/repo# Search in current repositorygh issue list --search "bug"# Search in multiple fieldsgh search issues "database" --match=title,body```### Common Filters```bash# By state and labelsgh search issues --state=open --label=bug,priority:high# By date rangegh search issues --created="2025-01-01..2025-01-31"# By assignee or authorgh search issues --assignee=@me --author=username# By engagementgh search issues --sort=comments --order=desc```### Advanced Qualifiers (30+ available)**Content:** `in:title`, `in:body`, `in:comments`**State:** `is:open`, `is:closed`, `is:merged`, `is:draft`**Labels:** `label:bug`, `-label:wontfix`, `no:label`**Dates:** `created:>=2025-01-01`, `updated:<2025-01-31`, `closed:2025-01..2025-02`**Users:** `author:username`, `assignee:username`, `mentions:username`, `commenter:username`**Repos:** `repo:owner/name`, `org:orgname`, `user:username`**Complete Syntax Reference:** [GITHUB_NATIVE_SEARCH_CAPABILITIES.md](/docs/research/GITHUB_NATIVE_SEARCH_CAPABILITIES.md)---## Output & Automation```bash# JSON output for scriptinggh search issues "bug" --json number,title,url,labels --jq '.[] | {number, title}'# Limit resultsgh search issues "bug" --limit=50# Export to filegh search issues --label=feature-request --json number,title,body > features.json```---## Search Limitations- **No regex** - Use literal strings only- **No wildcards** - Exact match or phrase search- **No context lines** - Shows only matching issues, not surrounding context- **For file/code search** - Use `gh grep` extension (see file-searching skill)---## Common Workflows### Find Your Assigned Issues```bashgh search issues --assignee=@me --state=open --repo=owner/repo```### Find Recent Bugs```bashgh search issues --label=bug --created=">=2025-10-01" --state=open --sort=created```### Search Knowledge Base```bash# Search Claude Code tipsgh search issues "plan mode" --repo=terrylica/claude-code-skills-github-issues --label=claude-code```---## Tool Selection Decision- **Search Issues/PRs** → Use `gh search issues` (this skill)- **Search repository files** → Use `gh grep` (see file-searching skill)- **AI-powered operations** → Use `gh models` (see ai-assisted-operations skill)---**Empirical Testing:** 200+ test cases, 100% coverage of search qualifiers**Full Operational Guide:** [AI_AGENT_OPERATIONAL_GUIDE.md](/docs/guides/AI_AGENT_OPERATIONAL_GUIDE.md)---> Converted and distributed by [TomeVault](https://tomevault.io/claim/terrylica) — claim your Tome and manage your conversions.

Frequently asked questions

Searching Issues