publish-review

Publish a GitHub PR review with inline comments and thread replies.

4|1|Updated May 31, 2015
One-click install
npx skills add https://github.com/samcdavid/dotfiles --skill publish-review-samcdavid
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: publish-review
Source: https://github.com/samcdavid/dotfiles/tree/main/claude/skills/publish-review
Command: npx skills add https://github.com/samcdavid/dotfiles --skill publish-review-samcdavid

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enables posting a PR review that exists in the current conversation to GitHub, including inline comments, thread replies, and a top-level review body.

Core Features & Use Cases

  • Determine the target PR from a number or URL, or by inspecting gh pr status.
  • Parse and format review components (inline comments, thread replies, and a summary) for GitHub reviews.
  • Validate line-number mappings and post via gh api with appropriate error handling.

Quick Start

Invoke publish-review to post the current conversation's PR review to GitHub.

Frequently Asked Questions about publish-review

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

FAQPage Schema
How do I publish a PR review from my chat conversation to GitHub?

To publish a PR review from chat to GitHub, the Skill parses inline comments, thread replies, and the top-level body from the current conversation, then posts them via the gh api. It determines the target PR from an explicit number, URL, or gh pr status.

How are inline comments and thread replies formatted when posting a GitHub PR review?

When posting a GitHub PR review, the Skill parses inline comments and thread replies, formats them for GitHub's review structure, and maps line numbers correctly. It ensures validation and error handling during the gh api post.

Can I target a specific pull request by URL or number when submitting a review?

Yes, you can target a specific pull request by providing an explicit PR number or URL. If neither is provided, the Skill determines the target PR automatically by inspecting gh pr status.

Does this approach require the GitHub CLI to post PR reviews?

Yes, posting PR reviews requires the GitHub CLI, as the Skill formats the review components and posts them directly using gh api with appropriate validation and error handling.

What happens if line numbers are incorrect when publishing inline comments to GitHub?

The Skill validates line-number mappings before publishing inline comments to GitHub. If mappings are incorrect, error handling built into the gh api post process will trigger to prevent misaligned review comments.