$html-docs
InstallDevelopersPricingSign inOpen drive

For Agents

  • Install the skill
  • Use it
  • Agent–human collaboration
  • Go deeper

For Humans

  • Generate with AI
  • Import from anywhere
  • Start blank
  • Try the demo

For agents

Give your agent the power to create review-ready documents.

One command installs it. Your agent can then create private documents and iterate on them with you through comments. Works with Claude Code, Codex, Cursor, Windsurf, Cline, and any agent that can run commands.

Install the skill See example promptsAgent + human workflows
1

Install the skill#

One command sets up every agent you have. Takes about 30 seconds.

Recommended

Run this in any project. It finds your installed agents and configures each one for you.

your project
$ npx @html-docs/cli install
Auto-configures:Claude CodeCursorCodexWindsurfCline

Add --api-key <key> to create documents in your own account, or run it without and authenticate later with npx @html-docs/cli auth.

Prefer to set it up by hand? Per-agent instructions

Paste this to your agent, or run it yourself:

Paste to Claude Code
Run this: mkdir -p ~/.claude/skills/html-docs && curl -fsSL https://www.html-docs.com/agents/skill.md -o ~/.claude/skills/html-docs/SKILL.md

Auto-discovered on next session. Then start using the prompts below.

Or configure MCP manually
mcp.json
{
  "mcpServers": {
    "html-docs": {
      "command": "npx",
      "args": ["@html-docs/cli", "--mcp"]
    }
  }
}

Document tools: update, read, comment, and list_comments.

2

Use it#

Copy a prompt, swap in your subject. Each one creates a private document for review.

Popular — going viral on X right now

Implementation notes

A living doc the agent updates as it works — design decisions, tradeoffs, open questions. You follow along and comment in real time.

Prompt
Implement <SPEC>. As you work, keep a running notes doc on HTML Docs that captures anything I should know — design decisions, deviations from the spec, tradeoffs, and open questions. Create it once, then update it as you go so I can follow along live and comment.

Product requirements doc

Point your agent at a codebase and get a full PRD — personas, user stories, journeys.

Prompt
Reverse-engineer a product requirements document from this codebase — personas, features as user stories, journeys — and create it as a private HTML Docs document.

Research report

Deep-dive research on any topic, prepared as a private report with diagrams and citations.

Prompt
Research [TOPIC] in depth and create a comprehensive private report in HTML Docs — include key findings, analysis, CSS diagrams where helpful, and a summary of implications.

Design review

Get a web page design, then steer it with comments instead of re-prompting from scratch.

Prompt
Design a landing page for [X] and create it as a private HTML Docs document. I'll review the design with comments — then read my comments and revise the page from them.

Built with these prompts

Live stock dashboard

Real-time data via the CORS proxy, Chart.js sparklines, auto-refresh.

See it live

Pomodoro timer

Focus timer with Web Audio, YouTube & Spotify embeds, localStorage stats.

See it live

Morning newspaper

Broadsheet layout with live news, multi-column, real market data.

See it live
3

Agent–human collaboration#

Share a doc with your agent. Review, comment, and iterate together.

Option A — Public link

Set your doc’s visibility to public in the share dialog. Anyone (or any agent) with the link can read it. No API key needed.

Option B — API key

Pass your API key as x-api-key header. The agent gets full read/write access to your docs — create, edit, comment.

Review a doc

Q3 Product Launch Plan

Ship redesigned dashboard, roll out inline comments...

Target ship date: end of next sprint.

Agent summary

1. Dashboard redesign is the critical path
2. Comments feature unblocks collaboration
3. Timeline is aggressive — needs scope check

Prompt ready to paste
Comment on a doc

API Design Proposal

All endpoints return JSON with a status field.

Agent

“Should this be a top-level field or nested under meta?”

Authentication uses bearer tokens...

Rate limiting is set to 1000 req/min.

Agent

“Too high for public API — consider 100/min default.”

Prompt ready to paste
Edit a section

Introduction

Our company has been working very hard over the past several months to develop what we believe is a truly revolutionary...

We built a faster way to publish docs. Here’s how it works.

Prompt ready to paste
Create a new doc

Weekly Standup Notes

Alice — Frontend
DoneDoingBlocked
Bob — Backend
DoneDoingBlocked
Carol — Design
DoneDoingBlocked
Private/s/review-link
Prompt ready to paste
Review → iterate loop
v1Original
v2Improved
Prompt ready to paste

Replace <doc-id> and <doc-token> with values from your doc’s share URL. With an API key set up, agents can also use the doc ID directly.

Go deeper

API reference

Full API docs — create, read, edit, comment, version history, authentication.

Full skill file

The raw SKILL.md — view it, copy it, or curl it directly.

CORS proxy for live data

How hosted pages can fetch external APIs through the built-in forward proxy.

Artifacts

Browse human-published artifacts, including work created with AI.

Start creating. Humans or agents.

Generate with AI, import, write from scratch, or teach your agent to collaborate on a private document.

Create a docGet the agent skill

For humans

Create docs your way.

Generate with AI, import from anywhere, or start blank. Pick your path.

1

Generate with AI#

Describe what you want. AI writes it.

AI Generate

“A project proposal for a mobile app that helps people find dog-friendly restaurants. Include executive summary, market analysis, and timeline.”

Generating...
  1. 1Click Create in your library.
  2. 2Choose Generate with AI.
  3. 3Describe your doc in plain English.
  4. 4Edit, publish, or share.
Try it
2

Import from anywhere#

Paste a link or upload a file. We convert it.

Import
Google Doc

docs.google.com/d/1xR3k...

Web page

https://blog.example.com/my-post

Upload file

report.pdf, notes.html, draft.txt

  1. 1Click Import in your library.
  2. 2Paste a URL (Google Doc, web page) or upload HTML/PDF/text.
  3. 3Review the converted page.
  4. 4Edit and make it yours.
3

Start blank#

A clean page. Just start typing.

Editor

Type / for commands

Heading

Large section heading

Image

Upload or embed an image

Bullet list

Create a simple list

Callout

Highlight important info

Publish

Go live at /site/your-slug

  1. 1Click Create in your library.
  2. 2Choose Blank page.
  3. 3Use / slash commands for blocks, headings, images.
  4. 4Publish when ready.
Create a doc

Want to see it in action?

Open a live demo doc with slash commands, comments, and publish — no signup needed.

Try the demo
© 2026 HTML DocsInstallSupportPrivacyTermsAPI