# AI use cases for Human Review (petergyang/human-review)

Repo: [petergyang/human-review](https://github.com/petergyang/human-review) | Use cases: 3 | Page: https://dedupedai.com/use-cases/petergyang-human-review/

A local visual review tool that lets you edit HTML and Markdown files and localhost pages in your browser, leave comments, and send all feedback to your AI coding agent in one batch.

This file holds every use case of this repo. Each one starts with a "## " heading and ends with its URL.

- Edit an AI-written Markdown plan and send feedback in one batch: https://dedupedai.com/use-cases/petergyang-human-review/review-ai-plan-markdown-visually/
- Mark up a localhost page and send fixes back to the app source: https://dedupedai.com/use-cases/petergyang-human-review/review-localhost-page-before-agent-edits/
- Cut extra copy and rewrite CTAs across several pages: https://dedupedai.com/use-cases/petergyang-human-review/tighten-website-copy-across-pages/

## How to edit an AI-written Markdown plan and send feedback in one batch with Human Review

Repo: [petergyang/human-review](https://github.com/petergyang/human-review) | Difficulty: Intermediate | Time: 15 minutes | Basis: From the README

Mark up a Markdown plan in the browser and send all edits and comments to your agent at once.

**Who it is for:** A founder or team lead who asked an AI agent for a project plan or doc and wants to fix wording and structure without typing a long chat message.

**The problem:** Chat feedback like 'change X to Y in the third paragraph' is slow, and you cannot be sure the agent applied every instruction.

**The outcome:** The agent updates the Markdown source with every edit and comment you sent, and the page refreshes for another review.

### Steps

1. Paste this into Claude Code or Codex: Install the /human-review skill globally from https://github.com/petergyang/human-review
2. Or run `npx -y human-review setup --global` in your terminal
3. Ask your agent to open your file with /human-review (your file)
4. Edit text directly, add comments on selected phrases, and reorder blocks by dragging their handles
5. Click Send so the agent receives all feedback in one batch and updates the source

### Prompt to paste into your agent

```text
Install the human-review skill from the petergyang/human-review repo, then open <path-to-markdown-file> with /human-review. After I click Send, confirm the agent applied every edit and comment to the Markdown source and report any change it could not make.
```

### Caveat

For Markdown files you must click Send for changes to reach the source, since only HTML file edits save automatically.

Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/

URL: https://dedupedai.com/use-cases/petergyang-human-review/review-ai-plan-markdown-visually/

## How to mark up a localhost page and send fixes back to the app source with Human Review

Repo: [petergyang/human-review](https://github.com/petergyang/human-review) | Difficulty: Intermediate | Time: 30 minutes | Basis: From the README

Review a running local page in the browser and have your agent apply the changes to the code.

**Who it is for:** A developer or designer building a landing page or small app locally who wants to point at exact spots instead of describing them in chat.

**The problem:** Describing visual fixes in chat, such as which card repeats or which button text to change, loses detail and needs several rounds.

**The outcome:** Your agent receives comments anchored to exact text and elements, plus your direct edits, and applies them to the app source.

### Steps

1. Install the skill by pasting this into Claude Code or Codex: Install the /human-review skill globally from https://github.com/petergyang/human-review
2. Start your local page so it runs on a localhost URL
3. Ask your agent to run /human-review with the localhost URL
4. Click an image, chart, or section to comment on it, or select a phrase to comment on that text
5. Click Send, then let the agent update the source and refresh the page

### Prompt to paste into your agent

```text
Using the petergyang/human-review skill, open the localhost page at <localhost-url> with /human-review. After I click Send, check that the agent changed the app source for each comment and report which files were edited.
```

### Caveat

On localhost pages, pasted images are staged for the agent to place in the app source rather than saved beside a document, and changes only reach the source after you click Send.

Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/

URL: https://dedupedai.com/use-cases/petergyang-human-review/review-localhost-page-before-agent-edits/

## How to cut extra copy and rewrite CTAs across several pages with Human Review

Repo: [petergyang/human-review](https://github.com/petergyang/human-review) | Difficulty: Intermediate | Time: 30 minutes | Basis: From the README

Click through linked pages in the review tool and trim copy without losing feedback between them.

**Who it is for:** A marketer or content editor with a multi-page HTML site who wants to remove repeated copy and rewrite calls to action in one pass.

**The problem:** Reviewing many pages in chat means repeating context for each page and risking missed edits.

**The outcome:** Feedback from each page is collected and sent to the agent together, and the agent updates the HTML files.

### Steps

1. Install the skill with the paste-in prompt or run `npx -y human-review setup --global`
2. Ask your agent to open the start page with /human-review (your file)
3. Command-click links to open other pages in the review without losing your feedback
4. Delete repeated copy, edit the call to action text, and leave comments on anything unclear
5. Click Send so the agent applies all edits and comments; review the refreshed pages before you close the tab

### Prompt to paste into your agent

```text
Use the petergyang/human-review skill to open <path-to-start-html-file> and review the linked pages. After I click Send, verify that the agent removed the repeated copy and updated each call to action in the HTML files, and list the files changed.
```

### Caveat

HTML edits save automatically, so closing the tab does not undo them; use Revert all during the review or Discard on your next open to restore the file.

Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/

URL: https://dedupedai.com/use-cases/petergyang-human-review/tighten-website-copy-across-pages/
