Organize PR Topics

This agent skill organizes the current GitHub PR into agent-proposed topics and launches a local review GUI.

Repository: https://github.com/SBakolis/review-topics

Requirements

• Node.js 20 or newer
• npm
• GitHub CLI (gh)
• An authenticated GitHub CLI session (gh auth login)

For Users

Install the global CLI, then run the skill installer with npx:

npm install -g @sbakolis/organize-pr-topics
npx @sbakolis/organize-pr-topics install-skill

The direct organize-pr-topics ... command also works when npm's global bin directory is on your PATH. The npx form avoids shell command not found errors when that directory is not configured.

By default, install-skill detects available agent config directories and asks where to install the skill and /review-topics command:

• Claude Code: ~/.claude/skills/organize-pr-topics/SKILL.md and ~/.claude/commands/review-topics.md
• opencode: ~/.config/opencode/skills/organize-pr-topics/SKILL.md and ~/.config/opencode/commands/review-topics.md

If both ~/.claude and ~/.config/opencode exist, the interactive installer lets you choose Claude Code, opencode, or both. If only one is detected, it asks for confirmation before installing into that agent. In non-interactive shells, pass --agent explicitly.

To install a specific target without prompting, pass --agent explicitly:

npx @sbakolis/organize-pr-topics install-skill --agent claude
npx @sbakolis/organize-pr-topics install-skill --agent opencode
npx @sbakolis/organize-pr-topics install-skill --agent both

Restart the relevant agent after installing the skill. Then ask the agent to organize a GitHub PR into review topics, or invoke the installed skill naturally from a PR branch.

The installed skill uses these package commands:

npx @sbakolis/organize-pr-topics check-gh
npx @sbakolis/organize-pr-topics prepare-session .pr-topic-review-session.json
npx @sbakolis/organize-pr-topics start-review .pr-topic-review-session.json

Usage

Preferred command:

/review-topics

With no arguments, the command asks which PR to review. It offers the most recent open PR for the checked-out branch when one exists. If no checked-out branch PR exists, it asks for a PR number or offers recent open PRs.

Direct PR number fast path:

/review-topics <pr-number>

Natural-language invocation remains supported: ask the agent to organize a GitHub PR into review topics and launch the review GUI.

For Development

Contributor setup from this package directory:

npm install
npm run dev
npm run build
npm test

npm run dev starts the TypeScript server with Vite middleware for local development only. Published users run the prebuilt production server through npx @sbakolis/organize-pr-topics start-review.

Useful contributor commands:

npm run check-gh
npm run prepare-session -- .pr-topic-review-session.json
PR_TOPIC_SESSION_PATH=.pr-topic-review-session.json npm run dev

Troubleshooting

• Missing gh: install GitHub CLI. On macOS, run brew install gh.
• Unauthenticated gh: run gh auth login.
• No PR found: checkout a branch that has an open PR, or use gh pr checkout <number>.
• Comment anchoring failed: the GUI posts a PR-level fallback comment instead of risking a wrong inline anchor.