make-issue-commentlisted
Install: claude install-skill rvanbaalen/skills
Post (or update) a structured investigation comment on a GitHub PR. The comment captures what was debugged, what the root cause is, the proposed fix, verification, and a live progress checklist — so the user or the next engineer can reopen it later and rebuild context fast.
This is **not** `/make-issue` (which opens a new GitHub issue). This skill only creates/updates **comments on existing PRs**.
## 0. Decide whether to proceed — propose first if you weren't asked
The skill has two invocation paths, and they deserve different first steps:
- **Explicit invocation** — the user typed `/make-issue-comment`, or wrote something unambiguous like "post this on the PR", "file these findings as a PR comment", "update the comment", "mark the comment resolved". Skip to step 1.
- **Proactive invocation** — you loaded this skill because you noticed an investigation finished with a concrete root cause and fix plan, and the work is happening on a PR branch, but the user did not ask for a comment. In that case, *do not start drafting*. First confirm interest with `AskUserQuestion`:
> Question: `Looks like we've landed on a root cause and a fix plan for <one-line topic>. Want me to post a structured investigation comment on the PR so it's captured for later?`
> Options:
> - **Yes, post a comment** — continue to step 1.
> - **Not now** — acknowledge briefly and stop. Do not re-propose in the same conversation unless the user says something new that clearly revives the idea.
Use t