Skip to content

docs(skills): clarify /search/issues returns issues and PRs - #2713

Merged
ilblackdragon merged 2 commits into
stagingfrom
docs/github-skill-search-issues-clarify
Apr 20, 2026
Merged

ilblackdragon merged 2 commits into
stagingfrom
docs/github-skill-search-issues-clarify

Conversation

@ilblackdragon

Copy link
Copy Markdown
Member

Summary

  • Add a clarifying bullet to skills/github/SKILL.md noting that the unified /search/issues endpoint returns BOTH issues and pull requests, and that there is no /search/pulls endpoint.
  • Doc-only; functional behavior is already enforced by the is:pr / is:issue filters used throughout the existing examples.

Test plan

  • Render the updated SKILL.md and confirm the new bullet appears in the Search section
  • No code changes — CI lint/test should pass unchanged

🤖 Generated with Claude Code

Add a bullet noting the unified /search/issues endpoint returns both
issues and pull requests and there is no /search/pulls endpoint.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings April 20, 2026 06:10
@github-actions github-actions Bot added the scope: docs Documentation label Apr 20, 2026
@github-actions github-actions Bot added size: XS < 10 changed lines (excluding docs) risk: low Changes to docs, tests, or low-risk modules contributor: core 20+ merged PRs labels Apr 20, 2026

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the GitHub skill documentation to clarify that the REST Search API uses a single /search/issues endpoint for both issues and pull requests, and that filtering is done via is:pr / is:issue.

Changes:

  • Add a bullet under the Search section clarifying /search/issues returns both issues and PRs and there is no /search/pulls.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request updates the GitHub skill documentation to clarify that the /search/issues endpoint handles both issues and pull requests. A review comment suggests simplifying this new note to avoid redundancy with existing headers while maintaining the key information about the lack of a dedicated /search/pulls endpoint.

Comment thread skills/github/SKILL.md Outdated
http(method="GET", url="https://api.github.com/search/issues?q=repo:{owner}/{repo}+is:pr+is:open+label:bug")
```

- The unified endpoint `/search/issues` returns BOTH issues and pull requests — there is no `/search/pulls` endpoint. Use `is:pr` or `is:issue` in the `q=` filter to narrow the results.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The added clarification is helpful, but it repeats information already present in the section header (line 139), specifically the instruction to use is:pr or is:issue. To improve conciseness and avoid redundancy, consider simplifying the note to focus on the absence of the /search/pulls endpoint.

Suggested change
- The unified endpoint `/search/issues` returns BOTH issues and pull requests — there is no `/search/pulls` endpoint. Use `is:pr` or `is:issue` in the `q=` filter to narrow the results.
- Note: There is no /search/pulls endpoint; /search/issues is the unified endpoint for both issues and PRs.

@ilblackdragon ilblackdragon Apr 20, 2026 •

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Simplified the bullet as suggested — dropped the redundant is:pr/is:issue guidance (already in the section header) and kept the note focused on the absence of /search/pulls. Fixed in d9fcba3.

Addresses gemini-code-assist review on PR #2713: trim redundancy with
the section header and focus the note on the absence of a
/search/pulls endpoint.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@ilblackdragon
ilblackdragon merged commit f2c4c25 into staging Apr 20, 2026
17 checks passed
@ilblackdragon
ilblackdragon deleted the docs/github-skill-search-issues-clarify branch April 20, 2026 06:22
This was referenced Apr 20, 2026
This was referenced Apr 22, 2026
theredspoon pushed a commit to theredspoon/ironclaw that referenced this pull request Jun 21, 2026
)

* docs(skills): clarify /search/issues returns issues and PRs

Add a bullet noting the unified /search/issues endpoint returns both
issues and pull requests and there is no /search/pulls endpoint.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* docs(skills): simplify /search/issues bullet per review

Addresses gemini-code-assist review on PR nearai#2713: trim redundancy with
the section header and focus the note on the absence of a
/search/pulls endpoint.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

contributor: core 20+ merged PRs risk: low Changes to docs, tests, or low-risk modules scope: docs Documentation size: XS < 10 changed lines (excluding docs)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants