comment-modelisted
Install: claude install-skill shipshitdev/skills
# Comment Mode
Generate highlighted HTML with click-to-reveal comments for granular feedback on text. Alternative to rewrites—user keeps their voice, reviews feedback incrementally.
## Contract
Inputs:
- The draft text to comment on (pasted inline or as a file path)
- Optional lens: editor feedback, POV simulation (e.g. "as brian would react"), or focused angle (e.g. "word choice only")
Outputs:
- An HTML file at `_private/views/{name}-comments-temp.html` with highlighted spans and click-to-reveal comment overlays
Creates/Modifies:
- Writes `_private/views/{name}-comments-temp.html`
External Side Effects:
- Runs `open _private/views/{name}-comments-temp.html` to launch the file in the default browser
Confirmation Required:
- None — the file is a temp view artifact in `_private/` and does not modify source files
Delegates To:
- None.
## When to Use
- User says: "comment on this", "leave comments on", "give feedback on"
- User pastes text and asks for feedback/critique
- User wants targeted feedback without a full rewrite
## Clarify Before Commenting
Use AskUserQuestion to clarify scope when the request is ambiguous. Avoid over-commenting (overwhelming) or under-commenting (missing the point).
**Clarify when:**
- No lens specified → ask what angle they want
- Long document → ask if they want full coverage or just key sections
- Unclear audience → ask who the recipient is (affects POV comments)
**Skip clarification when:**
- Lens is explicit ("comment on wo