nuxt-content/docus

Overview

This skill creates a complete, production-ready documentation site for any JavaScript/TypeScript project using Docus and Nuxt. It scaffolds a docs directory, generates content pages from templates, and configures search, dark mode, MCP server, and llms.txt integration. The generator detects monorepos, package manager, and i18n needs to choose the correct layout and scripts.

How this skill works

The skill inspects the repository for lock files, monorepo indicators, README and source folders to determine docs location and package manager. It initializes a docs folder (or workspace entry) with app, content, public, and config files, writes a package.json and optional nuxt.config.ts for i18n, and generates landing, guide, and API pages from templates. It also wires AI features automatically (MCP endpoint and llms.txt) and updates monorepo configs when required.

When to use it

• You need a ready-to-run documentation site for a new or existing project.
• You want automatic AI tooling (MCP server and llms.txt) included without manual setup.
• You’re adding docs to a monorepo and need workspace-aware configuration.
• You want SEO-ready docs with search, dark mode, and a Nuxt/Docus stack.
• You need a starter content structure (getting started, guides, API reference).

Best practices

• Run the analyzer from the repository root so the skill can detect lock files and monorepo layout.
• Review generated content in content/ and edit introduction, installation, and API pages to reflect project specifics.
• Keep MDC component names prefixed with u- (e.g., ::u-page-hero) to avoid Vue resolution errors.
• If you need multiple languages, confirm i18n detection or request explicit i18n generation.
• Add theme customizations in app/app.config.ts and app/assets/css/main.css for brand consistency.

Example use cases

• Generate docs for a single-package npm project and run them locally with npm run dev.
• Add a docs workspace to a pnpm monorepo and update pnpm-workspace.yaml and root scripts.
• Produce an i18n-enabled docs site when @nuxtjs/i18n or locale folders are detected.
• Create a staging-ready docs site with search and dark mode, then deploy the generated output to Vercel or Netlify.
• Seed API reference pages from exported functions in src/ to produce a starter API section.