A skill for Claude Cowork that generates an interactive HTML tool for annotating any document at the sentence level.
Click a sentence, leave a comment, copy structured feedback back to Claude. Useful for reviewing and iterating on any piece of writing — articles, emails, specs, reports, proposals.
Download doc-comments.skill and open it in Claude Cowork. Click Copy to your skills to install.
Once installed, just tell Claude:
"Generate a doc-comments tool for this draft" "I want to annotate this article" "Help me mark up this document"
Claude will generate a ready-to-open HTML file loaded with your content.
When triggered, Claude:
- Reads your document (from a file, pasted text, or something Claude just wrote)
- Splits it into paragraphs and builds a JavaScript content array
- Injects it into the HTML template
- Saves a
doc-comments.htmlfile to your workspace
Open it in any browser — no server needed, no dependencies, fully self-contained.
- Click any sentence to select it and open a comment input
- Type your note and hit Add comment (or Cmd+Enter)
- Commented sentences get an amber underline so you can see what's been annotated
- Copy feedback for Claude — formats all your comments as structured text to paste back into the conversation
- Copy plain text / Markdown / formatted — copy the document itself in different formats for pasting into Substack, Notion, or anywhere else
The skill is two files:
SKILL.md— instructions Claude follows to generate the toolassets/template.html— the HTML file with__CONTENT_PLACEHOLDER__and__DOC_TITLE_PLACEHOLDER__that Claude fills in
If you want to change the design, edit template.html. If you want to change the behaviour (different copy formats, different comment structure, etc.), edit SKILL.md. Then repackage using the skill-creator skill.
Built using Claude Cowork. Originally created as part of a writing workflow for Michelle's Substack — wrote the first post, needed a better way to give feedback on it, built the tool in the same session.
MIT