create-docs
Create complete documentation sites for projects. Use when asked to: "create docs", "add documentation", "setup docs site", "generate docs", "document my project", "write docs", "initialize documentation", "add a docs folder", "create a docs website". Generates Docus-based sites with search, dark mo
By nuxt-content · 469 installs
npx skills add nuxt-content/docus --skill create-docs
Source repository · Upstream listing
Create Docs
Generate a complete, production ready documentation site for any project.
Workflow
1. Analyze Detect package manager, monorepo structure, read context
2. Initialize Create docs directory with correct setup
3. Generate Write documentation pages using templates
4. Configure Set up AI integration (MCP, llms.txt)
5. Finalize Provide next steps with correct commands
Package Manager Reference
Detect from lock files, default to npm if none found:
Lock File PM Install Run Add
pnpm lock.yaml pnpm pnpm install pnpm run pnpm add
package lock.json npm npm install npm run npm install
yarn.lock yarn yarn install yarn yarn add
bun.lockb bun bun install bun run bun add
Use [pm] as placeholder in commands below.
Step 1: Analyze Project
Detect Project Structure
Determine Docs Location
Project Type Target Directory Workspace Entry
Standard project ./docs N/A
Monorepo with apps/ ./apps/docs apps/docs
Monorepo with packages/ ./docs docs
Existing docs/ folder Ask user or ./documentation —
Read Context Files
File Extract
README.md Project name, description, features, usage examples
package.json Name, description, dependencies, repository URL
src/ or lib/ Exported functions, composables for API docs
Detect i18n Requirement
Check if project needs multi language docs:
Indicator Action
@nuxtjs/i18n in dependencies Use i18n template
locales/ or i18n/ folder exists Use i18n template
Multiple language README files Use i18n template
User explicitly mentions multiple languages Use i18n template
None of the above Use default template
Step 2: Initialize Docs
Create Directory Structure
Default template:
i18n template (if multi language detected):
Create package.json
Default:
i18n (add @nuxtjs/i18n ):
Create nuxt.config.ts (i18n only)
Create .gitignore
Update Monorepo Configuration (if applicable)
pnpm Monorepo
1. Add docs to workspace and configure onlyBuiltDependencies (required for better sqlite3):
2. Add dev script to root package.json:
Or with directory path:
npm/yarn Monorepo
Step 3: Generate Documentation
Use templates from [references/templates.md](references/templates.md).
CRITICAL: MDC Component Naming
All Nuxt UI components in MDC must use the u prefix:
Correct Wrong
::u page hero ::page hero
::u page section ::page section
:::u page feature :::page feature
:::u button :::button
::::u page card ::::page card
Without the u prefix, Vue will fail to resolve the components.
Documentation Structure
Generate Pages
1. Landing page ( index.md ) Hero + features grid
2. Introduction What & why, use cases
3. Installation Prerequisites, install commands
4. Guide pages Feature documentation with action based H2 headings
For writing style, see [references/writing guide.md](references/writing guide.md).
For MDC components, see [references/mdc components.md](references/mdc components.md).
Step 4: Configure AI Integration
Docus automatically includes MCP server ( /mcp ) and llms.txt generation. No configuration needed.
Do NOT add AI Integration sections to the landing page. These features work automatically.
Optionally mention in the introduction page:
Optional: app.config.ts
Optional: Theme Customization
If the project has a design system or brand colors, customize the docs theme.
Custom CSS
Create app/assets/css/main.css :
Extended app.config.ts
Step 5: Finalize
Provide instructions using detected package manager.
Standard Project
Monorepo
Features Included
Full text search
Dark mode
MCP server for AI tools (/mcp)
LLM integration (/llms.txt)
SEO optimized
Next Steps
1. Review generated content
2. Add more guides in content/2.guide/
3. Customize theme in app.config.ts
4. Deploy to Vercel/Netlify/Cloudflare
Suggest Follow ups
After documentation is created, suggest enhancements:
Deployment
Platform Command Output
Vercel npx vercel prod Auto detected
Netlify [pm] run generate .output/public
Cloudflare Pages [pm] run generate .output/public
GitHub Pages [pm] run generate .output/public
Example: auth utils
Detected: pnpm monorepo, package in packages/
Generated structure:
Inside authentication.md (action based H2 headings):