user-manual
Skill0 starsChanged 34 days agoMITView on GitHub
Writes end-user manuals for a web app as PDF and DOCX, with real screenshots taken with Playwright and a clean Word template (cover, header, footer, table of contents). Use when asked for "/user-manual", a user manual, a user guide, how-to documentation or training material for the end users of a web app.
1 other project uses a version of this.
Adopted by
Most recently taken up by
- stevenzhangmb-design/proengatheir own version, first seen Nov 16, 2026
Other versions1 project uses a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 1
- stevenzhangmb-design/proenga★ 2same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository2 other files it gives its agents.
- video-tutorialSkill
- visual-checkSkill
The file
We split this skill into the rules it gives an agent
10 rules. About 0 are common, 2 are distinctive, and 8 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈2
Distinctive · estimate
This author's own choices. Worth a look.
8
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 20
If $V/node_modules does not exist, run cd $V && npm install.
- Distinctive: line 22
Read the project's README.md and CLAUDE.md/AGENTS.md, its routes and navigation, to learn which screens and tasks exist and how the app is …
- Very specific: line 42
Project config: Create or update docs/webapp-docs.json following ../visual-check/references/configuration.md.
- Very specific: line 45
Walkthrough: Write docs/manuals/<name>/walkthrough.json: scenes and steps covering what the manual explains.
- Very specific: line 57
Open every PNG: Check that no screen came out blank, that personal data is blurred (redact), that no dev chrome shows, and that each crop …
- Very specific: line 60
Text: Write docs/manuals/<name>/manual.md following references/manual-style.md and references/markdown-format.md.
- Very specific: line 83
Delete, Submit, Send, Sign and similar buttons.
- Distinctive: line 88
If a screen looks different from what you expected, tell the user.
- Very specific: line 93
Write manual.md in the target language and set title, preface_title, contents_title and figure_label in its front matter (see …
- Very specific: line 108
Leave in docs/manuals/<name>/ the walkthrough.json, manual.md, screenshots/, the .docx and the .pdf.
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
User manual
Produces a manual from a walkthrough of the real app, with screenshots and
a neutral Word template (cover, header, footer and table of contents) that
scripts/build_template.py generates on first use. The result follows
references/manual-style.md.
In this guide $H is this skill's scripts/ folder and $V is
../visual-check/scripts. $V holds the config loader and the walkthrough
runner shared by the three webapp-docs-kit skills.
Before you start
- If
$V/node_modulesdoes not exist, runcd $V && npm install. The browser is installed once withnode $V/node_modules/playwright-core/cli.js install chromium. - Read the project's
README.mdandCLAUDE.md/AGENTS.md, its routes and navigation, to learn which screens and tasks exist and how the app is started. - Ask the user what you cannot work out from the code:
- Which environment to capture: local, dev or staging. Never use production.
- What the manual should cover and for whom. If the app is large, propose
splitting it into several manuals (one walkthrough each, for example
getting-started,orders,admin) and let the user decide. - The organization shown on the cover and the support contact.
- The language of the manual, if it is not English (see "Other languages").
Screens behind sign-in or other preconditions
This kit does not sign in, handle credentials or assume user roles. If the screens to document are behind a login, a specific role, a feature flag or any other precondition, stop and ask the user how they want to handle it. It is their decision. Never ask for, type or store passwords, tokens or cookies yourself, and never work around access controls.
Steps
- Project config. Create or update
docs/webapp-docs.jsonfollowing../visual-check/references/configuration.md. It is the same config/visual-checkuses. If it already exists, use it. - Walkthrough. Write
docs/manuals/<name>/walkthrough.json: scenes and steps covering what the manual explains. Add"screenshot"to the steps that get a figure./video-tutorialuses the same file. The format is inreferences/walkthrough-format.md. To find selectors, runnode $V/check.js <path> --htmland look at the screenshot before writing long walkthroughs. Selector tips are in../visual-check/references/capture-pitfalls.md. - Screenshots.
Open every PNG. Check that no screen came out blank, that personal data is blurred (cd <project> node $H/capture.js docs/webapp-docs.json docs/manuals/<name>/walkthrough.jsonredact), that no dev chrome shows, and that each crop shows what the text describes. If something is off, fix the walkthrough and rerun. - Text. Write
docs/manuals/<name>/manual.mdfollowingreferences/manual-style.mdandreferences/markdown-format.md. Describe only what the screenshots and the code confirm. Do not invent features. - Build.
On Windows usecd docs/manuals python3 $H/build_manual.py <name>/manual.md <name>/manual-<app>-<name>.docx python3 $H/to_pdf.py <name>/manual-<app>-<name>.docx \ --title "User manual — <App>" --author "<Organization>"pythoninstead ofpython3.to_pdf.pyrecomputes the table of contents and writes the.pdfnext to the.docx. It uses LibreOffice when installed (and relaunches itself with LibreOffice's Python if needed) or Microsoft Word on Windows. - Mandatory visual review. Render the PDF to images with
pdftoppm -r 50 -png manual.pdf <temp folder>/pgand open them. Check that the table of contents has page numbers, that no figure is cut off and that no table overflows. Do not call the manual done without looking at it. - Repeat steps 2 to 6 for every manual requested.
Rules
- Screenshots never change data.
capture.jsrefuses to click Save, Delete, Submit, Send, Sign and similar buttons. Use"simulate": trueon those steps: the button is highlighted but not clicked. Use"allowChange": trueonly with the user's explicit authorization for that step, and only in a test environment. - Blur every element with personal data.
- If a screen looks different from what you expected, tell the user. It may be a bug in the app. Do not hide it in the manual.
Other languages
Write manual.md in the target language and set title, preface_title,
contents_title and figure_label in its front matter (see
references/markdown-format.md). Add the language's destructive button labels
to protectedLabels in the config.
Custom template
The default template is neutral (no logos). To brand it, either regenerate it
with other colors (python3 $H/build_template.py out.docx --primary 0F766E --accent F59E0B [--letter])
or open it in Word/LibreOffice, add a logo, change fonts and colors, keep the
{{...}} markers, and pass it with --template my-template.docx.
build_manual.py stops and says what is missing if the template is unusable.
Delivery
Leave in docs/manuals/<name>/ the walkthrough.json, manual.md,
screenshots/, the .docx and the .pdf. At the end, report each PDF's path,
its page count, and any screen that could not be captured.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

