GitHub Conversation

Use this skill when

You need to read a PR/issue before replying.
You need to reply to comments or review threads.
You need to submit a review.
You need to post a status update that closes loops.

Tool split

Use gh-llm for reading context (timeline, collapsed items, review threads, checks).
Use gh for simple write actions (comment, labels, assignees, reviewers, close/reopen, merge).
If context is incomplete, do not reply yet; expand first.

Install gh-llm

Prerequisites:

gh is installed and authenticated (gh auth status).
Python 3.14+ is available if installing via uv.

Install option A (recommended for CLI tool use):

uv tool install gh-llm
gh-llm --version

Install option B (GitHub CLI extension):

gh extension install ShigureLab/gh-llm
gh llm --version

Command prefix mapping:

If installed via uv tool, use gh-llm ....
If installed as gh extension, use gh llm ....

Fast start

Read a PR

gh-llm pr view <pr> --repo <owner/repo>
gh-llm pr timeline-expand <page> --pr <pr> --repo <owner/repo>
gh-llm pr review-expand <PRR_id[,PRR_id...]> --pr <pr> --repo <owner/repo>
gh-llm pr checks --pr <pr> --repo <owner/repo>

Read an issue

gh-llm issue view <issue> --repo <owner/repo>
gh-llm issue timeline-expand <page> --issue <issue> --repo <owner/repo>

Write simple updates

gh pr comment <pr> --repo <owner/repo> --body '<comment>'
gh issue comment <issue> --repo <owner/repo> --body '<comment>'
gh pr edit <pr> --repo <owner/repo> --add-label '<label1>,<label2>'
gh pr edit <pr> --repo <owner/repo> --remove-label '<label1>,<label2>'
gh pr edit <pr> --repo <owner/repo> --add-reviewer '<reviewer1>,<reviewer2>'
gh pr edit <pr> --repo <owner/repo> --add-assignee '<assignee1>,<assignee2>'

Reading workflow (required before replying)

1) Build context map

Identify:

Current goal of this PR/issue.
Open requests not yet addressed.
Decisions already made.
Linked PRs/issues that affect this thread.

2) Expand hidden context

Expand collapsed timeline pages and relevant review threads before replying.

3) Check delivery state

For PRs, check:

CI/check failures.
Mergeability/conflicts.
Unresolved review threads.

Reply workflow

1) Reply to one thread with one intent

A single reply should answer the target point only. Do not mix unrelated updates.

2) Be verifiable

When making technical claims, include at least one concrete reference:

path:line
commit hash
check/log link
reproduction command

3) Quote only when needed

Use > when:

the original comment has multiple points
the thread is long and reference is ambiguous
you are answering a specific sentence fragment

For short one-to-one replies, no quote is needed.

4) State status clearly

Use plain status language:

fixed
partially fixed
not fixed yet
intentionally unchanged

If partially fixed or unchanged, include reason and next step.

Review workflow

As reviewer

Separate blocking vs non-blocking points.
Give actionable suggestions.
Point to exact location when possible.
Avoid generic criticism without concrete evidence.

As PR author

Expand and read all relevant review content.
Address items one by one.
Reply to each addressed thread.
Resolve a thread only after fix/decision is actually complete.
Post one concise round-up after a batch of fixes.

Issue workflow

Opening an issue

Include:

Problem statement.
Minimal reproduction.
Expected vs actual behavior.
Environment details.
Logs/traceback/screenshots.
Related links.

Maintaining a busy issue

Ask for missing repro info instead of guessing.
Link duplicates to the canonical thread.
Keep one canonical status update comment.

Quality gates before posting

Is context complete (including expanded hidden/collapsed content)?
Does the message move the thread forward?
Are key claims backed by verifiable evidence?
Does tone and granularity match this repository?

Co-author and credit

When a reviewer's concrete code change is substantially adopted, add:

Co-authored-by: <Reviewer Name> <reviewer_email>

Use GitHub-linked email if attribution on GitHub is desired.