Reqmark: skill pack for Hermes Agent

Hermes skill that annotates HTML prototypes with numbered, hoverable requirement badges

What Reqmark does

You ask the agent to annotate a prototype file, a specific element such as a search box, or a page based on a PRD, and the skill writes a single self-contained HTML file with CSS and JS inlined. Badges show a number, hovering reveals the requirement, a click pins it and a double-click marks it done, turning the badge from red to green. Because it only adds data-am-target attributes, styles and layout stay untouched.

Version 1.1.0 moved badges to position:fixed overlays attached to the body, version 1.1.2 added scope isolation so tabs, drawers and dialogs show only their own badges with renumbering, and 1.1.7 added editing and deletion from the list panel. Version 1.1.8 adds a stable edit drawer and rescans dynamic targets, numbering badges continuously per current page. Badges follow scrolling in tables, drawers and modals using a MutationObserver, and tooltips flip direction at viewport edges. PRD-driven mode maps requirements in a document onto the HTML.

Key features

Zero-intrusion annotation through a data-am-target attribute only
Fixed overlay badges with hover tooltips and click-to-pin
Scope isolation for tabs, drawers and dialogs with renumbering
Edit and delete from a list panel
Red-to-green status toggled by double-click
PRD-driven mapping of requirements onto the HTML

When to use it

Marking up an HTML prototype with requirements for a product review
Annotating a login page and list page from a PRD
Tracking which annotated requirements have been completed

Who it is for: Product managers and designers who review HTML prototypes with the help of an agent.

How it fits with Hermes Agent

It is built as a Hermes skill, installed into ~/.hermes/skills/product/annotation-master.

How to install Reqmark

These commands are copied from the project's README. Check the repository for the latest steps before you run them.

git clone https://github.com/a916791360/Reqmark.git ~/.hermes/skills/product/annotation-master

FAQ

What is Reqmark?

Reqmark is a Hermes skill that annotates HTML prototypes with numbered requirement badges. Hover shows the requirement, a click pins it and a double-click marks it complete.

Does Reqmark work with Hermes Agent?

Yes. It is installed by cloning the repository into ~/.hermes/skills/product/annotation-master, and the README gives prompts such as asking the agent to annotate a prototype file.

Does Reqmark change my prototype's styles?

No. The README says it is zero-intrusion and only adds data-am-target attributes, leaving styles and layout untouched. The output is one HTML file with CSS and JS inlined.