StackMap
Subscribe
Explore / human-review
petergyang

human-review

Skill + local tool to review HTML and Markdown like a Google Doc: edit text, drag blocks, comment on elements, then send every change to your coding agent in one batch.

1,382 118 JavaScript MITupdated 24 days ago
skillscoding
View on GitHubDispute this mapping →
Curator's take

Use it whenever an agent produces pages, plans or docs you'd otherwise critique by typing 'in the third paragraph, change X to Y' — direct edits and anchored comments go back as one batch and the page refreshes for another pass. Local only, no account or API key; Claude Code picks feedback up in the background, other agents wait within their turn. Not for code review — it handles HTML, Markdown and localhost pages, not diffs.

Mapped by ShipWithAI editors · links verified

Continue your stack

What teams reach for next — and why each earns a place beside human-review. Ranked by curator confidence.

pairs wellhtml-anythinghuman-review
pairs wellalternativebuilt withpick a node for the why · open it from the panel
Weekly digest
README.md3 min read

Human Review

Edit HTML and Markdown files directly, leave comments like a Google Doc, and send all your feedback to your AI agent at once.

Read the full launch post

https://github.com/user-attachments/assets/7cab09c9-eaa0-4e8b-984d-2925e810b5c2

Problem

Giving AI feedback on files in chat is painful.

Sometimes you want to change one sentence yourself. Instead, you end up typing:

In the third paragraph, change X to Y. Cut the third card because it repeats the first one. Also rewrite the CTA.

Then the agent changes the file and you have to check whether it understood every instruction. This gets even harder when you’re reviewing a long plan, Markdown document, landing page, or multi-page website.

How to install /human-review

The easiest way to install the skill is to paste this into ChatGPT, Claude Code, Codex, or your favorite coding agent:

Install the /human-review skill globally from https://github.com/petergyang/human-review

You can also install it with npx:

npx -y human-review setup --global

How to use /human-review

Human Review visual editor

Open an HTML or Markdown file:

/human-review (your file)

Review a page running on localhost:

/human-review (localhost URL)

Human Review opens the file in your browser. Make direct edits, leave comments, and click Send. Your agent receives all your feedback in one batch, updates the source, and refreshes the page for another review.

In Claude Code, the agent waits in the background and picks up your feedback the moment you hit Send. In Codex and other agents, it waits during its turn; if the turn already ended, send a message and it picks the feedback up. Closing the tab or clicking End review releases the agent either way. Feedback you never sent is kept, and the next time you open that page you can restore or discard it.

Note: For HTML files, direct edits and resizes save automatically, so closing the tab doesn't undo them — Discard on your next open, or Revert all during the review, puts the file back. For Markdown and localhost pages, click Send so your agent can apply them to the source.

What this skill lets you do

  • Edit text directly and tweak basic formatting (e.g., bold, italic).
  • Make bulleted and numbered lists — type - or 1. at the start of a line, or press ⌘⇧8 / ⌘⇧7. Tab and Shift+Tab indent and outdent.
  • Add links — select text and press ⌘K. ⌘K inside an existing link edits or removes it.
  • Resize images by dragging their corner, and move images by dragging them to a new spot.
  • Rearrange the page — hover any block and drag the handle on its left edge to move the whole block somewhere else.
  • Paste images from your clipboard — file reviews save them beside the document; localhost reviews stage them for the agent to place in the app source.
  • Select a phrase and leave a comment anchored to the exact text.
  • Comment on an image, chart, or section by clicking the element.
  • Remove elements without explaining the deletion in chat. Deletes and moves come with an Undo.
  • Edit a comment after writing it, even one already sent — a reworded comment reaches the agent with the next Send.
  • Command-click links to review multiple pages without losing your feedback.
  • Send every edit and comment at once instead of writing a long chat message.

I use Human Review to edit AI-generated plans, update landing pages, review localhost apps, and remove the extra copy AI likes to add to UX.

What’s inside

  • cli.js contains the human-review, poll, status, and setup commands.
  • server.js runs the local review session.
  • sdk.js handles editing, comments, highlights, and feedback.
  • chrome-client.js contains the visual review interface.
  • [markdown.js]