make-pages-interactive skill
Turns any folder of HTML pages into a commenting surface: highlight text, leave a note, and the agent edits the page.
- 485 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- The skill edits HTML files and starts a local HTTP server.
- Comments are saved in files next to the pages.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/make-pages-interactiveDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The skill edits HTML files and starts a local HTTP server.
- Comments are saved in files next to the pages.
This is third-party code. Review the repository files before installing.
What it does
The skill injects a small client library into every HTML page of a folder. The user highlights text or clicks an element and writes a note. The comment lands in the `feedback/inbox.jsonl` inbox the agent reads. The agent edits the page, appends an explanation to `feedback/history.json`, and the page reloads with a walkthrough of what changed. A local server built on the Python standard library starts on a free port, 5050 by default, and shuts down when idle.
Who it is for. Researchers and analysts who iterate on long HTML reports with plots and tables together with an agent.
Good fit when
- An agent produced an HTML report and edits are easier to give on the page itself.
- HTML design mocks should be discussed with a colleague without opening the agent chat.
- A few paragraphs inside a long article with plots need targeted rewrites.
- After review a clean static copy without the comment layer must be restored.
Not a fit when
- Pages are built by a framework and regenerated on every run.
- A server cannot run on the machine, even on a local port.
- Several people will comment over the network at the same time.
Example request
Make these pages interactive, start the comment server and tell me which address to open the report at.Limitations
The skill edits page files and adds tags to every `*.html` in the folder, so keep the directory under git first. Codex has no file watching, so the skill runs in wait mode: the session must stay open, and after a stop you have to say "check feedback". The server listens on a local port and shuts down after 10 idle minutes. Updates run `git pull --ff-only` in the skill folder. Comments are stored as plain files next to the pages, so keep them out of public repositories if the notes are private.
How to disable. Ask the agent to remove the comment layer and the skill will restore clean pages. Then delete the `~/.claude/skills/make-pages-interactive` folder and the `feedback/` directory.
FAQ
What runs on my machine?
A local `lib/server.py` on the Python standard library, about 250 lines. It serves the pages, accepts comments and exits when the parent dies or after 10 idle minutes.
Where are the comments stored?
New notes are in `feedback/inbox.jsonl`; the agent replies and change descriptions are in `feedback/history.json`, which the page shows after reload.
How do I get plain HTML back?
Ask the agent to remove the feedback layer. `scripts/inject.py` idempotently removes the two `<link>` and `<script>` tags from every file.
Does it work in Codex?
Yes, clone into `~/.codex/skills/make-pages-interactive`. The skill starts the server detached via `scripts/start_server.py` and waits for comments with `wait_for_feedback.py`.
How do I update the skill?
Run `python ~/.claude/skills/make-pages-interactive/scripts/update.py` or ask the agent to update the skill. The script runs `git pull --ff-only` in the skill folder.
Discussion
No questions or reviews yet.
Related
Skills19 skills: Claude Code builds an HTML page, you work with it in the browser and the answer returns to the agent with no copying
cafe3310's personal skill collection: spec-driven project work, reviews, reports, browser, 3D and video in one repository
A skill that moves the design interview from the terminal to a browser page: option cards and one Send button.
A team wiki living in Git with a 51-tool MCP server: agents read and edit pages, tables and boards.
Human Review
human-review
Visual editing of HTML and Markdown with Google Docs-style comments: the whole edit goes to the agent at once. All local, no account or keys
An agent saves web pages, PDFs and scans into a local vault, builds linked concepts and answers from them with source references.
README in short
The skill consists of a client library, a small server and injection scripts. The agent reads the inbox file and answers by editing the page.