Skip to content

Commit 0e5afec

Browse files
committed
docs: add skills.sh support for SKILL.md distribution
- Move SKILL.md from packages/0/ to skills/vuetify0/ (skills.sh format) - Add frontmatter with name, description, license, metadata - Update ai-tools.md with npx skills add vuetifyjs/0 - Update copy-markdown.ts to use new SKILL.md path
1 parent 79b4db3 commit 0e5afec

File tree

4 files changed

+715
-310
lines changed

4 files changed

+715
-310
lines changed

apps/docs/build/copy-markdown.ts

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -21,8 +21,8 @@ export default function copyMarkdownPlugin (): Plugin {
2121
copyFileSync(file, destPath)
2222
}
2323

24-
// Copy SKILL.md from packages/0 to dist root
25-
const skillSrc = '../../packages/0/SKILL.md'
24+
// Copy SKILL.md from skills/vuetify0 to dist root
25+
const skillSrc = '../../skills/vuetify0/SKILL.md'
2626
const skillDest = join(outDir, 'SKILL.md')
2727
if (existsSync(skillSrc)) {
2828
copyFileSync(skillSrc, skillDest)

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

Lines changed: 36 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -31,52 +31,70 @@ v0 provides machine-readable documentation files following the [llms.txt](https:
3131
| - | - | - | - |
3232
| <a href="/llms.txt" target="_blank" class="v0-link">llms.txt↗</a> | {{ llmsStats.llms.sizeFormatted }} | Curated index with links | Quick context, navigation |
3333
| <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 |
34-
| <a href="/SKILL.md" target="_blank" class="v0-link">SKILL.md↗</a> | ~7KB | Patterns & anti-patterns | Claude Code, Clawdbot skills |
34+
| <a href="/SKILL.md" target="_blank" class="v0-link">SKILL.md↗</a> | ~14KB | Patterns & anti-patterns | Claude Code, Cursor, Windsurf |
3535

3636
> [!ASKAI] When should I use llms.txt vs llms-full.txt?
3737
3838
## Usage
3939

40-
Whether you're a developer prompting an AI assistant or an agent consuming v0 documentation programmatically, choose the approach that fits your workflow.
40+
Install SKILL.md via [skills.sh](https://skills.sh) — works with Claude Code, Cursor, Windsurf, Codex, and [35+ agents](https://github.com/vercel-labs/skills#supported-agents):
4141

42-
::: code-group
42+
```bash
43+
npx skills add vuetifyjs/0
44+
```
45+
46+
### For Humans
4347

44-
```md I'm a Human
4548
**Claude Code / Codex** — Add Vuetify MCP for structured API access:
46-
> claude mcp add --transport http vuetify-mcp https://mcp.vuetifyjs.com/mcp
49+
50+
```bash
51+
claude mcp add --transport http vuetify-mcp https://mcp.vuetifyjs.com/mcp
52+
```
4753

4854
Or fetch docs directly in your session:
49-
> WebFetch https://0.vuetifyjs.com/llms-full.txt
55+
56+
```txt
57+
WebFetch https://0.vuetifyjs.com/llms-full.txt
58+
```
5059

5160
**Cursor / Windsurf** — Add to .cursorrules or configure MCP:
52-
> @https://0.vuetifyjs.com/llms.txt
61+
62+
```txt
63+
@https://0.vuetifyjs.com/llms.txt
64+
```
5365

5466
See [Vuetify MCP](/guide/tooling/vuetify-mcp) for IDE configuration.
5567

5668
**ChatGPT / Claude.ai** — Paste the URL in chat:
57-
> Read https://0.vuetifyjs.com/llms-full.txt and help me build a multi-select dropdown.
69+
70+
```txt
71+
Read https://0.vuetifyjs.com/llms-full.txt and help me build a multi-select dropdown.
5872
```
5973

60-
```md I'm an Agent
61-
**With MCP (recommended)** — Always-current structured access:
74+
### For Agents
75+
76+
**With MCP** — Always-current structured access:
77+
6278
- `get_vuetify0_skill` — Latest SKILL.md reference
6379
- `get_vuetify0_composable_list` — Browse all composables
6480
- `get_vuetify0_composable_guide` — Detailed composable docs
6581
- `get_vuetify0_component_list` — Browse headless components
6682
- `get_vuetify0_component_guide` — Component docs and examples
6783

6884
**Without MCP** — Fetch SKILL.md at session start:
69-
> WebFetch https://0.vuetifyjs.com/SKILL.md
85+
86+
```txt
87+
WebFetch https://0.vuetifyjs.com/SKILL.md
88+
```
7089

7190
**What's in SKILL.md:**
72-
- Core composables (useTheme, useLocale, useBreakpoints, etc.)
73-
- Selection system (useSingle, useGroup, useStep)
74-
- Component compound patterns (Root/Item pairs)
91+
92+
- All composables (createSelection, createForm, useTheme, etc.)
93+
- Headless components (Tabs, Dialog, Checkbox, Radio, etc.)
94+
- Selection system (createSingle, createGroup, createStep)
7595
- Registry & Trinity patterns
96+
- Code style (shallowRef, function declarations)
7697
- Common mistakes to avoid
77-
```
78-
79-
:::
8098

8199
## What's Included
82100

@@ -89,7 +107,7 @@ See [Vuetify MCP](/guide/tooling/vuetify-mcp) for IDE configuration.
89107

90108
**llms-full.txt** includes the complete content of every documentation page, stripped of Vue components and frontmatter for cleaner LLM consumption.
91109

92-
**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.
110+
**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. Install it via [skills.sh](https://skills.sh) (`npx skills add vuetifyjs/0`) to make it available across Claude Code, Cursor, Windsurf, and 35+ other agents.
93111

94112
## How It Works
95113

packages/0/SKILL.md

Lines changed: 0 additions & 290 deletions
This file was deleted.

0 commit comments

Comments
 (0)