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
Skill

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.
All reasons and checks

paraschopra/make-pages-interactive

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add skills/make-pages-interactive

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Extended 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.

Skills

19 skills: Claude Code builds an HTML page, you work with it in the browser and the answer returns to the agent with no copying

PluginExtended access70Repository stars

cafe3310's personal skill collection: spec-driven project work, reviews, reports, browser, 3D and video in one repository

SkillExtended access256Repository stars

A skill that moves the design interview from the terminal to a browser page: option cards and one Send button.

SkillMinimal access330Repository stars
Official

A team wiki living in Git with a 51-tool MCP server: agents read and edit pages, tables and boards.

MCP serverExtended access87Repository stars

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

WorkflowExtended access1.5KRepository stars

An agent saves web pages, PDFs and scans into a local vault, builds linked concepts and answers from them with source references.

SkillExtended access127Repository stars

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.

README badge

Report a problem