/polish-doc — notes into one document

Version 0.1.2 — what changed in each version is in VERSION.md.

A Claude Code skill that turns analysis output, meeting notes and drafts into one HTML document. It opens as a single file, pastes into Slack, and prints without falling apart.

It is written for a reader who is not a developer. Plain enough for a 12-year-old, short sentences, lots of pictures. Then it does one more pass: nothing said twice, nothing from the source left out, and the tells that give away AI writing stripped.

Existing documents keep their look. Give it an .html document that already has its own fonts, colors and layout, and only the text changes.

Any language. By default the document comes out in your OS locale's language — a ko_KR machine produces Korean, a de_DE machine produces German — and you can override that in one word. The template ships with CJK, Arabic and Devanagari font fallbacks and logical CSS properties, so right-to-left documents lay out correctly.

1. Install

./install.sh

Installs globally into ~/.claude/skills/. For a single project:

./install.sh --project /path/to/repo

Manual install is just a folder copy.

cp -R skill/polish-doc ~/.claude/skills/

Start a new Claude Code session afterwards and it shows up in the list.

2. Use it

/polish-doc analysis.md
/polish-doc ~/Downloads/meeting-notes.txt reference.html
/polish-doc <paste the content you want documented>
/polish-doc report.html          ← an existing document. Keeps its fonts, colors and layout; fixes the text
/polish-doc                      ← documents whatever you just produced. Asks what to build if there's nothing

Give it several files and it merges them into one document. It does not give each file its own section. A new document is saved next to the source file as <topic>-<purpose>-<YYYYMMDD>.html. An existing document is saved next to the original as <name>-polished.html; the original is untouched.

Open example/sample-en.html or example/sample-ko.html in a browser and you will see exactly what comes out. Same template, same rules, two locales.

3. What it does for you

4. Layout

polish-doc-skill/
├── README.md                     this file — what the skill does now
├── VERSION.md                    version history
├── install.sh                    installer
├── skill/polish-doc/
│   ├── SKILL.md                  the rules — arguments, language, sentences, diagrams, building, revision
│   └── TEMPLATE.html             skeleton and CSS for new documents. What makes them look like one set
├── manual/
│   └── PROMPT.md                 using it without Claude Code (claude.ai, ChatGPT, …)
└── example/
    ├── sample-en.html            sample output, English. The content is fictional
    └── sample-ko.html            sample output, Korean. The content is fictional

5. Changing it

Different complaints live in different files. Don't mix them up.

Re-run ./install.sh after editing.

6. Worth knowing

• New documents all use the template CSS, unchanged. They have to look like one set; change TEMPLATE.html instead.
• An existing .html document keeps its own CSS. The skill changes its text, not its look. Say "match the standard look" if you want it moved onto the template.
• The confidential tag in the masthead is the default, translated into the document's language. Tell it to drop the tag for anything going outside the company.
• No external scripts, CDNs or image files. Pictures are inline SVG or CSS boxes. Send one file and the other person sees exactly what you see.
• Want a shareable link? Build the document first, then say "publish this as a link".