Use My /Human-Review Skill to Edit HTML and Markdown Files Visually
Tired of giving AI feedback in chat? My new skill lets you edit files, leave comments, and send feedback directly to your agent using a beautiful visual interface
Dear subscribers,
My last open-source skill, /no-ai-slop, went viral with 4K GitHub stars. Today, I’m introducing /human-review, another free AI skill I think you’ll love.
Let’s face it — giving feedback to AI in chat is painful. Asking AI to ‘update the button text’ or ‘edit the headline’ is annoying when I often want to edit the text myself or comment on the exact parts that I want it to fix.
/human-review opens HTML and Markdown files in a visual editor where you can edit text directly, leave comments like a Google Doc, and send feedback to AI.
If you find it useful, please star the repository so more people can find it. You can also upgrade to paid to get 12+ more AI skills for personal advice, agent-ready specs, viral social posts, and more.
Watch the demo below, then keep reading to learn:
How to install and use /human-review
How /human-review works behind the scenes
I’m proud to partner with Oceans Talent
I hired Char through Oceans to help with podcast production. He quickly grew beyond the original role and now creates clips, learns tools like Claude Code and Codex on his own, and delivers more every week.
Oceans Talent finds vetted operators across marketing, operations, finance, and executive support. Their hires know how to work with AI and cost one-third to one-fifth as much as comparable US talent. If you need help, book a call at oceanstalent.com/peter.
How to install and use /human-review
To install the skill, paste this into Codex, Claude Code, or your favorite AI coding tool:
Install /human-review globally: https://github.com/petergyang/human-review
After you install it, you can open the visual editor by typing:
“/human-review (your file)” or “/human-review (localhost URL)”
In the visual editor, you’ll see a preview of your HTML or Markdown file on the left and a feedback panel on the right:
Now you can:
Edit text directly and tweak basic formatting (e.g., bold, italic).
Resize images by dragging their corner.
Give AI feedback by selecting text or a component and leaving a comment.
Send edits and comments in one batch by clicking the “Send X to agent” button.
Giving feedback directly inside an HTML or Markdown file instead of in a separate chat window is super useful. I use /human-review to:
Edit planning docs before building new features.
Edit and give feedback on landing pages.
Tweak product copy and remove AI slop from the UX.
You can also Command-click links in the visual editor to navigate between pages and leave feedback on each one.
How /human-review works behind the scenes
When you run /human-review, it starts a small local server that records your changes in the visual editor and passes them back to your AI agent.
Every edit, deletion, and comment is saved and grouped by page.
Your agent waits for feedback in 10-minute windows and receives everything immediately when you click Send.
Note: For HTML files, direct edits and resizes save automatically. For Markdown and localhost pages, click Send so your agent can apply them to the source.
Because the whole review loop runs locally, /human-review doesn’t require an account or API key and doesn’t upload your feedback to a separate cloud service.
Run /human-review to prevent AI from turning your project into slop
It’s easy to give AI feedback in chat and trust it to edit your documents without reviewing the actual files.
Over time, I’ve found that relying on AI to make edits can slop-ify your entire project if you’re not careful.
So the next time your agent creates an HTML or Markdown file:
Type “/human-review (your file)” to open it in the visual editor.
Make a direct edit, remove slop, or leave a comment for AI to fix.
Hit Send and let your agent update the source.
Get /human-review for free on GitHub and star the repo if you find it useful!
P.S. Credit to my friend Kun, whose tool Lavish inspired /human-review. I built my own version to add direct editing and Markdown support.
I'm testing it now, and am absolutely STUNNED at how beautiful and useful it is. I've run into only two issues so far: 1. sometimes it's hard to get CC to stop polling, when I want to jump out of the loop to make another change (e.g., to do some research), and 2. you can't submit a note for the content as a whole, with the textbox at the bottom, unless you have another change to submit.
But overall WOW. It's making changes so much easier for my Medium article writing that I'm getting to much cleaner results, and way faster. THANK YOU!
https://medium.com/@raymondpeck
@peter - I tested it, it looks cool