Commentary Review plugin
Use the Review plugin to bring people into the point where an agent-generated artifact needs judgment. It combines skills for opening and operating reviews with a practice skill that checks whether a plan has enough evidence and clear tradeoffs to execute.
When to use it
Section titled “When to use it”You have a proposed implementation plan, a local Markdown draft, a pull request, or a running web app. You want reviewers to comment on the artifact itself, then have the agent revise it with that feedback. The bundle helps choose the right review surface and keeps the revision loop explicit.
Before you start
Section titled “Before you start”Start with an artifact you are allowed to review. Draft Review needs the installed Commentary CLI and local files; PR Review needs the appropriate repository access; Live Preview Review needs an app you own and its review SDK setup. Authorize the transport used by that workflow.
A complete workflow
Section titled “A complete workflow”- Use
review-agentic-plansto surface missing evidence, risks, and unresolved decisions before execution. For open-ended ideation, usecommentary-brainstorm-review. - Choose
commentary-draft-reviewfor local text,commentary-pr-reviewfor a pull request, orcommentary-live-preview-reviewfor a running web app. - Create or open the review, confirm the target and revision, and share it with people only when authorized.
- Read reviewer comments in context, make the requested changes, and publish or sync the next revision using the selected workflow.
- Report what changed and what was checked. Resolve threads according to the workflow and reviewer authority.
Try this request after installation:
Use the Review plugin to critique my release plan, create a Draft Review from ./docs/release-plan.md, and return its link. After reviewer feedback, revise the local source and sync a new revision. Ask before sharing it with anyone.Expected result: A reviewable artifact with a clear revision history and a feedback loop tied to the source. Reviewers can see the proposal and changes rather than reconstructing them from agent messages.
Included skills
Section titled “Included skills”The published v0.6.2 catalog contains 5 skills in this bundle (plugin version 0.4.2). Technical skills operate Commentary; practice skills improve the quality of the work. Each linked page has its own invocation, workflow, and limits.
| Skill | What it contributes |
|---|---|
| Brainstorm Review | Create and operate a structured Brainstorming Review for a proposal. |
| Draft Review with the CLI | Use the Commentary CLI for live collaborative review of local text artifacts. |
| Live Preview Review | Set up Commentary Live Preview Reviews and address live web app comments. |
| PR Review with an agent | Operate rendered GitHub PR reviews with explicit provider and revision boundaries. |
| Review an agent-generated plan | Review agent-generated plans for intent, evidence, risk, and decision completeness. |
Recovery and limits
Section titled “Recovery and limits”If a review target is inaccessible, verify provider access and transport authentication before retrying. For a missing live preview, check the SDK and preview URL. A review link or resolved thread does not itself mean the artifact has human approval. Local CLI and localhost workflows require an agent environment that can reach those resources.
Install this plugin
Section titled “Install this plugin”Choose a native plugin install for the bundle and its Commentary MCP configuration. Complete the host’s connection flow separately; installation does not grant account or workspace access.
Claude Code
Section titled “Claude Code”Run these commands inside Claude Code:
/plugin marketplace add commentary-dev/commentary-skills/plugin install commentary-review@commentary-skillsGitHub Copilot CLI
Section titled “GitHub Copilot CLI”Run these commands in your terminal:
copilot plugin marketplace add commentary-dev/commentary-skillscopilot plugin install commentary-review@commentary-skillsThese marketplace commands use the repository’s current default branch, which can be newer than the v0.6.2 contents described here. For the documented release, use the pinned individual-skill commands below or the v0.6.2 plugin ZIP in Microsoft Copilot Cowork. See installation choices for setup and version details.
Other agents: install the skills with npx
Section titled “Other agents: install the skills with npx”Use Node.js 22.20 or newer and run a command for each skill you want. The installer lets you choose your supported agent and installation scope; it downloads the complete skill folder without a manual clone. These commands are pinned to v0.6.2:
npx skills add https://github.com/commentary-dev/commentary-skills/tree/v0.6.2/skills/commentary-brainstorm-reviewnpx skills add https://github.com/commentary-dev/commentary-skills/tree/v0.6.2/skills/commentary-draft-reviewnpx skills add https://github.com/commentary-dev/commentary-skills/tree/v0.6.2/skills/commentary-live-preview-reviewnpx skills add https://github.com/commentary-dev/commentary-skills/tree/v0.6.2/skills/commentary-pr-reviewnpx skills add https://github.com/commentary-dev/commentary-skills/tree/v0.6.2/skills/review-agentic-plansThis installs standalone skills, not the native plugin wrapper or MCP configuration. Connect MCP or install and authenticate the CLI when the selected workflow requires it. See all installation methods, including GitHub CLI and Microsoft Copilot Cowork.