docs: add SKILL.md for AI coding assistants

Author: johnleider

apps/docs/build/copy-markdown.ts

@@ -1,4 +1,4 @@
-import { copyFileSync, mkdirSync } from 'node:fs'
+import { copyFileSync, existsSync, mkdirSync } from 'node:fs'
 import { glob } from 'node:fs/promises'
 import { dirname, join, relative } from 'node:path'
 
@@ -21,7 +21,15 @@ export default function copyMarkdownPlugin (): Plugin {
         copyFileSync(file, destPath)
       }
 
-      console.log(`[copy-markdown] Copied ${files.length} markdown files`)
+      // Copy SKILL.md from packages/0 to dist root
+      const skillSrc = '../../packages/0/SKILL.md'
+      const skillDest = join(outDir, 'SKILL.md')
+      if (existsSync(skillSrc)) {
+        copyFileSync(skillSrc, skillDest)
+        console.log(`[copy-markdown] Copied ${files.length} markdown files + SKILL.md`)
+      } else {
+        console.log(`[copy-markdown] Copied ${files.length} markdown files (SKILL.md not found)`)
+      }
     },
   }
 }

apps/docs/build/generate-llms-full.ts

@@ -226,6 +226,9 @@ function generateLlmsTxt (pages: PageInfo[]): string {
     lines.push('')
   }
 
+  // AI Resources section
+  lines.push('## AI Resources', '', `- [SKILL.md](${BASE_URL}/SKILL.md): Compact reference with patterns, anti-patterns, and TypeScript types for AI coding assistants`, `- [Vuetify MCP](${BASE_URL}/guide/tooling/vuetify-mcp): Model Context Protocol server for structured API access`, '')
+
   return lines.join('\n')
 }
 

apps/docs/src/pages/guide/tooling/ai-tools.md

@@ -31,37 +31,52 @@ v0 provides machine-readable documentation files following the [llms.txt](https:
 | - | - | - | - |
 | <a href="/llms.txt" target="_blank" class="v0-link">llms.txt↗</a> | {{ llmsStats.llms.sizeFormatted }} | Curated index with links | Quick context, navigation |
 | <a href="/llms-full.txt" target="_blank" class="v0-link whitespace-nowrap">llms-full.txt↗</a> | {{ llmsStats.llmsFull.sizeFormatted }} | Complete documentation | Deep understanding, code generation |
+| <a href="/SKILL.md" target="_blank" class="v0-link">SKILL.md↗</a> | ~7KB | Patterns & anti-patterns | Claude Code, Clawdbot skills |
 
 > [!ASKAI] When should I use llms.txt vs llms-full.txt?
 
-## Usage Examples
+## Usage
 
-### ChatGPT / Claude.ai
+Whether you're a developer prompting an AI assistant or an agent consuming v0 documentation programmatically, choose the approach that fits your workflow.
 
-Paste the URL directly in chat:
+::: code-group
 
-```txt
-Read https://0.vuetifyjs.com/llms-full.txt and help me build a multi-select dropdown using v0 composables.
-```
-
-### Cursor / Windsurf
+```md I'm a Human
+**Claude Code / Codex** — Add Vuetify MCP for structured API access:
+> claude mcp add --transport http vuetify-mcp https://mcp.vuetifyjs.com/mcp
 
-Add to your project's `.cursorrules` or AI context:
+Or fetch docs directly in your session:
+> WebFetch https://0.vuetifyjs.com/llms-full.txt
 
-```txt
-@https://0.vuetifyjs.com/llms.txt
-```
+**Cursor / Windsurf** — Add to .cursorrules or configure MCP:
+> @https://0.vuetifyjs.com/llms.txt
 
-### Claude Code
+See [Vuetify MCP](/guide/tooling/vuetify-mcp) for IDE configuration.
 
-Fetch the documentation in your session:
+**ChatGPT / Claude.ai** — Paste the URL in chat:
+> Read https://0.vuetifyjs.com/llms-full.txt and help me build a multi-select dropdown.
+```
 
-```txt
-WebFetch https://0.vuetifyjs.com/llms-full.txt
+```md I'm an Agent
+**With MCP (recommended)** — Always-current structured access:
+- `get_vuetify0_skill` — Latest SKILL.md reference
+- `get_vuetify0_composable_list` — Browse all composables
+- `get_vuetify0_composable_guide` — Detailed composable docs
+- `get_vuetify0_component_list` — Browse headless components
+- `get_vuetify0_component_guide` — Component docs and examples
+
+**Without MCP** — Fetch SKILL.md at session start:
+> WebFetch https://0.vuetifyjs.com/SKILL.md
+
+**What's in SKILL.md:**
+- Core composables (useTheme, useLocale, useBreakpoints, etc.)
+- Selection system (useSingle, useGroup, useStep)
+- Component compound patterns (Root/Item pairs)
+- Registry & Trinity patterns
+- Common mistakes to avoid
 ```
 
-> [!TIP]
-> For the best experience with Claude, use [Vuetify MCP](/guide/tooling/vuetify-mcp) instead. It provides structured API access rather than raw text.
+:::
 
 ## What's Included
 
@@ -74,6 +89,8 @@ WebFetch https://0.vuetifyjs.com/llms-full.txt
 
 **llms-full.txt** includes the complete content of every documentation page, stripped of Vue components and frontmatter for cleaner LLM consumption.
 
+**SKILL.md** is a compact reference optimized for AI coding assistants. It focuses on practical usage patterns, the selection/registry systems, common mistakes, and TypeScript integration — ideal for project-level context files.
+
 ## How It Works
 
 Both files are auto-generated at build time by [generate-llms-full.ts](https://github.com/vuetifyjs/0/blob/master/apps/docs/build/generate-llms-full.ts):