Curated

Chapter 14 of 44

gh Address Comments

Help address review/issue comments on the open GitHub PR for the current branch using gh CLI; verify gh auth first and prompt the user to authenticate if not logged in.

1 minute · 143 words · 4 sections

PR Comment Handler

Guide to find the open PR for the current branch and address its comments with gh CLI. Run all gh commands with elevated network access.

Prereq: ensure gh is authenticated (for example, run gh auth login once), then run gh auth status with escalated permissions (include workflow/repo scopes) so gh commands succeed. If sandboxing blocks gh auth status, rerun it with sandbox_permissions=require_escalated.

1) Inspect comments needing attention

Run scripts/fetch_comments.py which will print out all the comments and review threads on the PR

2) Ask the user for clarification

Number all the review threads and comments and provide a short summary of what would be required to apply a fix for it
Ask the user which numbered comments should be addressed

3) If user chooses comments

Apply fixes for the selected comments

Notes:

If gh hits auth/rate issues mid-run, prompt the user to re-authenticate with gh auth login, then retry.

Install this repository

$ npx skills add openai/skills

Skills install per repository, not per chapter — the CLI has no documented per-skill form, so we do not print one.

Colophon for this issue

Colophon

How this issue was made

Source

github.com/openai/skills, branch main, last pushed 14 July 2026.

Licence

Discovery

44 chapters found by walking the repository tree for SKILL.md, not by matching a directory convention. 2 distinct layouts observed: skills/.curated/*/SKILL.md, skills/.system/*/SKILL.md.

Issue colours

Resolved from a curated brand profile — hue 170°, chroma 0.124. Two accent tones are generated per issue and each is proven against its own ground before it ships: a single accent that passes AA on both light and dark paper is arithmetically impossible.

Heading repairs

1 repair applied to this chapter so the document has one h1 and no skipped levels:

Shifted “4 headings” from h1 to h2 so the chapter title is the only h1.

Spec compliance

Every chapter satisfies the Agent Skills specification’s frontmatter rules.

Images

Images inside a chapter come from the upstream repository. Where the author gave no alternative text we mark the image decorative rather than inventing a description — a plausible caption we made up is worse than none for the reader who depends on it.

Signal

Install counts come from skills.sh. They measure downloads, not quality, and an unranked repository is not an unread one.

Agent surfaces

The whole issue is available as one markdown document at /openai/skills.md, and each chapter at its own .md URL.

Publication

Set by Skills Docs from the source repository. Body text is Literata at the reader’s chosen size and measure; code is Geist Mono. Nothing on this page was written by us except this paragraph.

PR Comment Handler

Guide to find the open PR for the current branch and address its comments with gh CLI. Run all gh commands with elevated network access.

1) Inspect comments needing attention

Run scripts/fetch_comments.py which will print out all the comments and review threads on the PR

2) Ask the user for clarification

Number all the review threads and comments and provide a short summary of what would be required to apply a fix for it
Ask the user which numbered comments should be addressed

3) If user chooses comments

Apply fixes for the selected comments

Notes:

If gh hits auth/rate issues mid-run, prompt the user to re-authenticate with gh auth login, then retry.

gh Address Comments

PR Comment Handler

1) Inspect comments needing attention

2) Ask the user for clarification

3) If user chooses comments

Colophon

gh Address Comments

PR Comment Handler

1) Inspect comments needing attention

2) Ask the user for clarification

3) If user chooses comments

Appendix 14.1–14.4

ScriptsPython · 1 file

Assets2 files

Also bundled2 files

Colophon

Appendix 14.1–14.4

ScriptsPython · 1 file

Assets2 files

Also bundled2 files