Tooluck logoTooluck
SKILL.md

app-docs

Agent skill fromjezweb/claude-skills

Generate complete user documentation for a web app with screenshots. Browses the app via browser automation, screenshots every screen, and produces a structured user guide with step-by-step instructions, annotated screenshots, workflow diagrams, and reference tables. Supports quick (key screens), standard (all pages), thorough (every state and flow), and exhaustive (publishable documentation suite). Triggers: 'document the app', 'user guide', 'app documentation', 'screenshot docs', 'generate user docs', 'help docs', 'how-to guide', 'write the docs'.

How to install app-docs

install app-docs
# install the claude-skills pack with the skills CLI
npx skills add jezweb/claude-skills

# or add only this skill to Claude Code: copy the folder

plugins/dev-tools/skills/app-docs/

# into

~/.claude/skills/app-docs/ (all projects)

.claude/skills/app-docs/ (one project)

plugins/dev-tools/skills/app-docs/SKILL.md

MITFull file
1# App Documentation Generator
2
3Browse a running web app, screenshot every screen, and produce documentation good enough to publish. Not a screenshot dump — a structured guide that teaches someone how to use the app.
4
5## Browser Tool Detection
6
7Same as ux-audit — Chrome MCP, Playwright MCP, or playwright-cli.
8
9## URL Resolution
10
11Same as ux-audit — prefer deployed/live URL over localhost.
12
13## Depth Levels
14
15| Depth | Screenshots | What it produces | Duration |
16|-------|------------|-----------------|----------|
17| **quick** | ~10 | Single-page quick-start guide. Key screens, happy path only. | 10-15 min |
18| **standard** | ~30 | Full user guide. All pages, primary workflows, reference tables. | 30-60 min |
19| **thorough** | ~80+ | Comprehensive guide. All states, mobile views, every CRUD flow, troubleshooting. | 1-3 hours |
20| **exhaustive** | ~150+ | Publishable documentation suite. Everything in thorough plus: getting started tutorial, feature-by-feature deep dives, admin guide, keyboard shortcut reference, FAQ, and HTML version. | 3-6 hours |
21
22Default: **standard**
23
24## Workflow
25
26### 1. Get App Details
27
28Ask the user:
29- **App URL** (required — or auto-detect from wrangler.jsonc / running dev server)
30- **App name** (for the guide title)
31- **Auth** — Chrome MCP uses their session; Playwright needs credentials
32- **Depth** — quick, standard, thorough, or exhaustive
33- **Audience** — who reads this? (end users, admins, new team members, clients)
34
35### 2. Discover All Routes
36…

Excerpt shown under the repository's MIT license.

More skills in claude-skills

Keep exploring

Similar skill repositories

Newsletter

Join the Community

Subscribe to our newsletter for the latest news and updates