postReview

Publish multi-agent review findings from local JSON state to GitHub PR comments.

1|2|Updated Mar 19, 2026
One-click install
npx skills add https://github.com/joi-fairshare/agentic-workflow --skill postreview
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: postReview
Source: https://github.com/joi-fairshare/agentic-workflow/tree/main/skills/postReview
Command: npx skills add https://github.com/joi-fairshare/agentic-workflow --skill postreview

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the friction of manually copying multi-agent review findings into the GitHub UI by reading the saved ~/.agentic-workflow/<repo-slug>/reviews/<pr>.json state and publishing each agent’s comments in a single go.

Core Features & Use Cases

  • State file awareness: Loads the serialized review data generated by /review and guards against reposting already published reviews unless explicitly approved.
  • Batched GitHub submissions: Sends one review per agent, bundling inline comments plus top-level summaries to minimize API calls while capturing severity and focus metadata.
  • Audit trail updates: Stores posted review IDs and timestamps back into the same JSON file, ensuring the local state reflects what was sent to GitHub and enabling accurate follow ups.

Quick Start

Use /postReview to publish the saved review state for PR 42 after /review finishes generating the local JSON file.

Frequently Asked Questions about postReview

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

FAQPage Schema
How do I post multi-agent PR review comments to GitHub automatically?

Posting multi-agent PR review comments to GitHub automatically is done by reading serialized local state files and batching each agent's inline and top-level issues into single review submissions via the GitHub API. This minimizes API calls while publishing all findings.

Can I batch GitHub PR review submissions to reduce API calls?

Yes, you can batch GitHub PR review submissions by bundling inline comments and top-level summaries into a single review per agent. This minimizes API calls while ensuring severity and focus metadata are captured in the published output.

Does postReview work with local JSON state files?

Yes, postReview works by loading local JSON state files from the ~/.agentic-workflow/<repo>/reviews/<pr>.json path. It reads the stored multi-agent review findings and updates the same file with posted comment identifiers and timestamps for auditing.

What is the best way to sync local code review findings to GitHub?

The best way to sync local code review findings to GitHub is to use a state-sync tool that reads saved JSON files and pushes them as structured PR comments. This ensures the local state reflects what was sent to GitHub by storing posted review IDs.

How do I prevent reposting duplicate PR reviews to GitHub?

To prevent reposting duplicate PR reviews to GitHub, the publishing process guards against reposting already published reviews unless explicitly approved. It checks the local state file for existing comment identifiers before submitting new GitHub API requests.

Are there limitations when publishing multi-agent reviews to GitHub PR comments?

A limitation when publishing multi-agent reviews to GitHub PR comments is that it requires a pre-existing local state file generated by a prior review session. Without the ~/.agentic-workflow/<repo>/reviews/<pr>.json file, there is no data to publish.