Commentary
GitHub Copilot integration

Add document-first human review to Copilot workflows.

Use Commentary to review plans before coding and Markdown-heavy pull requests before merge, without replacing GitHub as the source of truth.

  • Repository marketplace plugin
  • GitHub source of truth
  • Rendered Markdown
  • Agent-ready comments
Install

Add Commentary Review to GitHub Copilot CLI

Repository marketplace

Run both commands in GitHub Copilot CLI. The first adds the public skills repository; the second installs the review plugin.

Recommended Copilot CLI plugin flow
copilot plugin marketplace add commentary-dev/commentary-skills
copilot plugin install commentary-review@commentary-skills

Source and setup details are maintained in commentary-dev/commentary-skills. This is a repository marketplace integration, not a vendor marketplace listing.

Reference workflow

Connect the agent to a human-owned review loop.

The artifact, feedback, revision, and approval state stay explicit from start to finish.

  1. 01

    Ask Copilot to produce an explicit plan or Markdown change.

    Start from an explicit artifact and named owner.

  2. 02

    Open pre-Git work as a Draft Review or paste the pull-request URL.

    Keep the current state and unresolved context visible.

  3. 03

    Review the rendered artifact and record blocking decisions.

    Keep the current state and unresolved context visible.

  4. 04

    Return structured feedback through the plugin, Git, API, or MCP.

    Keep the current state and unresolved context visible.

  5. 05

    Verify the revision before approving implementation or merge.

    The next stage begins only after verification.

Review before coding and before merge.

Plan review catches wrong assumptions early. Rendered pull-request review catches document quality and reader-impact problems after the source exists. Commentary supports both without changing GitHub ownership.

Keep GitHub authoritative.

Repository access stays tied to provider permissions. App-native threads remain the durable review record, while provider comments are synchronized representations around it.

Human review, made explicit

Connect the agent. Keep approval human-owned.

Review Copilot-generated plans, Markdown pull requests, and documentation as readable artifacts, then return structured feedback through skills, plugins, Git, API, or MCP.