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):