feat: welcome ai-tools

.changeset/remove-mcp-addon.md

@@ -0,0 +1,5 @@
+---
+'sv': minor
+---
+
+feat(ai-tools): replace `mcp` add-on with `ai-tools` add-on that includes both MCP and skills setup

.prettierignore

@@ -1,2 +1,3 @@
 packages/sv/src/cli/tests/snapshots/*
-packages/sv-utils/src/tests/**/output.ts
+packages/sv-utils/src/tests/**/output.ts
+packages/sv/src/create/shared/+skills/*

documentation/docs/20-commands/20-sv-add.md

@@ -49,10 +49,10 @@ Prevents installing dependencies
 
 ## Official add-ons
 
+- [`ai-tools`](ai-tools)
 - [`better-auth`](better-auth)
 - [`drizzle`](drizzle)
 - [`eslint`](eslint)
-- [`mcp`](mcp)
 - [`mdsvex`](mdsvex)
 - [`paraglide`](paraglide)
 - [`playwright`](playwright)

documentation/docs/30-add-ons/17-mcp.md → documentation/docs/30-add-ons/01-ai-tools.md

@@ -1,19 +1,20 @@
 ---
-title: mcp
+title: ai-tools
 ---
 
-[Svelte MCP](/docs/ai/overview) can help your LLM write better Svelte code.
+[Svelte AI Tools](/docs/ai/overview) can help your LLM write better Svelte code.
 
 ## Usage
 
 ```sh
-npx sv add mcp
+npx sv add ai-tools
 ```
 
 ## What you get
 
 - An MCP configuration for [local](https://svelte.dev/docs/ai/local-setup) or [remote](https://svelte.dev/docs/ai/remote-setup) setup
 - A [README for agents](https://agents.md/) to help you use the MCP server effectively
+- [Skills](https://svelte.dev/docs/ai/skills) for clients that support them (claude code, opencode)
 
 ## Options
 
@@ -22,13 +23,13 @@ npx sv add mcp
 The IDE you want to use like `'claude-code'`, `'cursor'`, `'gemini'`, `'opencode'`, `'vscode'`, `'other'`.
 
 ```sh
-npx sv add mcp="ide:cursor,vscode"
+npx sv add ai-tools="ide:cursor,vscode"
 ```
 
 ### setup
 
 The setup you want to use.
 
 ```sh
-npx sv add mcp="setup:local"
+npx sv add ai-tools="setup:local"
 ```

packages/sv/src/addons/mcp.ts → packages/sv/src/addons/ai-tools.ts

@@ -29,12 +29,26 @@ const options = defineAddonOptions()
 		required: true,
 		condition: ({ ide }) => !(ide.length === 1 && ide.includes('opencode'))
 	})
+	.add('skills', {
+		question: 'Do you want to install skills?',
+		type: 'select',
+		default: 'files',
+		options: [
+			{ value: 'files', label: 'Add files to the project' },
+			{
+				value: 'none',
+				label: 'Skip',
+				hint: 'for Claude Code you can install the plugin instead: /plugin install svelte'
+			}
+		],
+		condition: ({ ide }) => ide.some((i) => i !== 'opencode' && i !== 'other')
+	})
 	.build();
 
 export default defineAddon({
-	id: 'mcp',
-	shortDescription: 'Svelte MCP',
-	homepage: 'https://svelte.dev/docs/mcp',
+	id: 'ai-tools',
+	shortDescription: 'Svelte AI Tools',
+	homepage: 'https://svelte.dev/docs/ai',
 	options,
 	run: ({ sv, options }) => {
 		const getLocalConfig = (o?: {
@@ -72,14 +86,19 @@ export default defineAddon({
 					};
 					agentPath: string;
 					configPath: string;
+					skillsPath?: string;
+					agentsPath?: string;
+					agentExtension?: string;
 					customData?: Record<string, any>;
 					extraFiles?: Array<{ path: string; data: Record<string, any> }>;
 			  }
 			| { other: true }
 		> = {
 			'claude-code': {
-				agentPath: 'CLAUDE.md',
+				agentPath: '.claude/CLAUDE.md',
 				configPath: '.mcp.json',
+				skillsPath: '.claude/skills',
+				agentsPath: '.claude/agents',
 				mcpOptions: {
 					typeLocal: 'stdio',
 					typeRemote: 'http',
@@ -89,11 +108,13 @@ export default defineAddon({
 			cursor: {
 				agentPath: 'AGENTS.md',
 				configPath: '.cursor/mcp.json',
+				agentsPath: '.cursor/agents',
 				mcpOptions: {}
 			},
 			gemini: {
 				agentPath: 'GEMINI.md',
 				configPath: '.gemini/settings.json',
+				agentsPath: '.gemini/agents',
 				schema:
 					'https://raw.githubusercontent.com/google-gemini/gemini-cli/main/schemas/settings.schema.json',
 				mcpOptions: {}
@@ -115,6 +136,8 @@ export default defineAddon({
 			vscode: {
 				agentPath: 'AGENTS.md',
 				configPath: '.vscode/mcp.json',
+				agentsPath: '.github/agents',
+				agentExtension: '.agent.md',
 				mcpOptions: {
 					serversKey: 'servers'
 				}
@@ -127,16 +150,29 @@ export default defineAddon({
 		const filesAdded: string[] = [];
 		const filesExistingAlready: string[] = [];
 
-		const sharedFiles = getSharedFiles().filter((file) => file.include.includes('mcp'));
-		const agentFile = sharedFiles.find((file) => file.name === 'AGENTS.md');
+		const sharedFiles = getSharedFiles();
+		const mcpFiles = sharedFiles.filter((file) => file.include.includes('mcp'));
+		const skillFiles = sharedFiles.filter((file) => file.include.includes('skills'));
+		const agentFiles = sharedFiles.filter((file) => file.include.includes('agents'));
+		const agentFile = mcpFiles.find((file) => file.name === 'AGENTS.md');
 
 		for (const ide of options.ide) {
 			const value = configurator[ide];
 
 			if (value === undefined) continue;
 			if ('other' in value) continue;
 
-			const { mcpOptions, agentPath, configPath, schema, customData, extraFiles } = value;
+			const {
+				mcpOptions,
+				agentPath,
+				configPath,
+				skillsPath,
+				agentsPath,
+				agentExtension,
+				schema,
+				customData,
+				extraFiles
+			} = value;
 
 			// We only add the agent file if it's not already added
 			if (!filesAdded.includes(agentPath)) {
@@ -184,12 +220,42 @@ export default defineAddon({
 					);
 				}
 			}
+
+			// Add skills for clients that support them (not opencode - plugin handles it)
+			if (skillsPath && options.skills === 'files') {
+				for (const file of skillFiles) {
+					const filePath = `${skillsPath}/${file.name}`;
+					sv.file(filePath, (content) => {
+						if (content) {
+							filesExistingAlready.push(filePath);
+							return false;
+						}
+						return file.contents;
+					});
+				}
+			}
+
+			// Add sub-agents for clients that support them (not opencode - plugin handles it)
+			if (agentsPath) {
+				for (const file of agentFiles) {
+					const ext = agentExtension ?? '.md';
+					const name = file.name.replace(/\.md$/, ext);
+					const filePath = `${agentsPath}/${name}`;
+					sv.file(filePath, (content) => {
+						if (content) {
+							filesExistingAlready.push(filePath);
+							return false;
+						}
+						return file.contents;
+					});
+				}
+			}
 		}
 
 		if (filesExistingAlready.length > 0) {
 			log.warn(
 				`${filesExistingAlready.map((path) => color.path(path)).join(', ')} already exists, we didn't touch ${filesExistingAlready.length > 1 ? 'them' : 'it'}. ` +
-					`See ${color.website('https://svelte.dev/docs/mcp/overview#Usage')} for manual setup.`
+					`See ${color.website('https://svelte.dev/docs/ai')} for manual setup.`
 			);
 		}
 	},

packages/sv/src/addons/index.ts

@@ -1,8 +1,8 @@
 import type { Addon, AddonDefinition } from '../core/config.ts';
+import aiTools from './ai-tools.ts';
 import betterAuth from './better-auth.ts';
 import drizzle from './drizzle.ts';
 import eslint from './eslint.ts';
-import mcp from './mcp.ts';
 import mdsvex from './mdsvex.ts';
 import paraglide from './paraglide.ts';
 import playwright from './playwright.ts';
@@ -24,7 +24,7 @@ type OfficialAddons = {
 	mdsvex: Addon<any>;
 	paraglide: Addon<any>;
 	storybook: Addon<any>;
-	mcp: Addon<any>;
+	aiTools: Addon<any>;
 };
 
 // The order of addons here determines the order they are displayed inside the CLI
@@ -41,7 +41,7 @@ export const officialAddons: OfficialAddons = {
 	mdsvex,
 	paraglide,
 	storybook,
-	mcp
+	aiTools
 };
 
 export function getAddonDetails(id: string): AddonDefinition {

packages/sv/src/addons/tests/mcp/test.ts → packages/sv/src/addons/tests/ai-tools/test.ts

@@ -1,23 +1,31 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import { expect } from 'vitest';
-import mcp from '../../mcp.ts';
+import aiTools from '../../ai-tools.ts';
 import { setupTest } from '../_setup/suite.ts';
 
 const { test, testCases } = setupTest(
-	{ mcp },
+	{ 'ai-tools': aiTools },
 	{
 		kinds: [
 			{
 				type: 'default-local',
 				options: {
-					mcp: { ide: ['claude-code', 'cursor', 'gemini', 'opencode', 'vscode'], setup: 'local' }
+					'ai-tools': {
+						ide: ['claude-code', 'cursor', 'gemini', 'opencode', 'vscode'],
+						setup: 'local',
+						skills: 'files'
+					}
 				}
 			},
 			{
 				type: 'default-remote',
 				options: {
-					mcp: { ide: ['claude-code', 'cursor', 'gemini', 'opencode', 'vscode'], setup: 'remote' }
+					'ai-tools': {
+						ide: ['claude-code', 'cursor', 'gemini', 'opencode', 'vscode'],
+						setup: 'remote',
+						skills: 'files'
+					}
 				}
 			}
 		],
@@ -45,12 +53,12 @@ const { test, testCases } = setupTest(
 	}
 );
 
-test.concurrent.for(testCases)('mcp $kind.type $variant', (testCase, ctx) => {
+test.concurrent.for(testCases)('ai-tools $kind.type $variant', (testCase, ctx) => {
 	const cwd = ctx.cwd(testCase);
 
 	const getContent = (filePath: string) => {
-		const cursorPath = path.resolve(cwd, filePath);
-		return fs.readFileSync(cursorPath, 'utf8');
+		const fullPath = path.resolve(cwd, filePath);
+		return fs.readFileSync(fullPath, 'utf8');
 	};
 
 	const cursorMcpContent = getContent(`.cursor/mcp.json`);
@@ -214,4 +222,22 @@ test.concurrent.for(testCases)('mcp $kind.type $variant', (testCase, ctx) => {
 			}
 		`);
 	}
+
+	// skills should be installed for claude-code only (opencode uses plugin)
+	const claudeSkillsDir = path.resolve(cwd, '.claude/skills');
+	expect(fs.existsSync(claudeSkillsDir)).toBe(true);
+	expect(fs.existsSync(path.resolve(claudeSkillsDir, 'svelte-code-writer/SKILL.md'))).toBe(true);
+	expect(fs.existsSync(path.resolve(claudeSkillsDir, 'svelte-core-bestpractices/SKILL.md'))).toBe(
+		true
+	);
+
+	// opencode should NOT have skills (plugin handles it)
+	expect(fs.existsSync(path.resolve(cwd, '.opencode/skills'))).toBe(false);
+
+	// sub-agents should be installed for all clients except opencode
+	expect(fs.existsSync(path.resolve(cwd, '.claude/agents/svelte-file-editor.md'))).toBe(true);
+	expect(fs.existsSync(path.resolve(cwd, '.cursor/agents/svelte-file-editor.md'))).toBe(true);
+	expect(fs.existsSync(path.resolve(cwd, '.gemini/agents/svelte-file-editor.md'))).toBe(true);
+	expect(fs.existsSync(path.resolve(cwd, '.github/agents/svelte-file-editor.agent.md'))).toBe(true);
+	expect(fs.existsSync(path.resolve(cwd, '.opencode/agents'))).toBe(false);
 });

packages/sv/src/cli/tests/cli.ts

@@ -32,7 +32,7 @@ describe('cli', () => {
 				'better-auth=demo:password,github',
 				'mdsvex',
 				'paraglide=languageTags:en,es+demo:yes',
-				'mcp=ide:claude-code,cursor,gemini,opencode,vscode,other+setup:local'
+				'ai-tools=ide:claude-code,cursor,gemini,opencode,vscode,other+setup:local+skills:files'
 				// 'storybook' // No storybook addon during tests!
 			]
 		},
@@ -93,10 +93,29 @@ describe('cli', () => {
 				projectName
 			);
 			const relativeFiles = fs.readdirSync(testOutputPath, { recursive: true }) as string[];
+
+			// Files from ai-tools repo (skills, agents) change independently -
+			// snapshot only file listings, not content
+			const aiToolsFiles: Record<string, string[]> = {};
+			const aiToolsPattern = /[\\/](skills|agents)[\\/]/;
+
 			for (const relativeFile of relativeFiles) {
 				if (!fs.statSync(path.resolve(testOutputPath, relativeFile)).isFile()) continue;
 				if (['.svg', '.env'].some((ext) => relativeFile.endsWith(ext))) continue;
 
+				const normalized = relativeFile.replace(/\\/g, '/');
+
+				// Group ai-tools files by directory for manifest comparison
+				if (aiToolsPattern.test(normalized)) {
+					const match = normalized.match(/(.+\/(?:skills|agents))\/(.*)/);
+					if (match) {
+						const [, base, rest] = match;
+						aiToolsFiles[base] ??= [];
+						aiToolsFiles[base].push(rest);
+					}
+					continue;
+				}
+
 				let generated = fs.readFileSync(path.resolve(testOutputPath, relativeFile), 'utf-8');
 				if (relativeFile === 'package.json') {
 					const { data: generatedPackageJson } = parse.json(generated);
@@ -119,6 +138,15 @@ describe('cli', () => {
 				);
 			}
 
+			// Compare ai-tools file listings against sv-files-snapshots.md manifests
+			for (const [dir, files] of Object.entries(aiToolsFiles)) {
+				const manifest = files.sort().join('\n') + '\n';
+				await expect(manifest).toMatchFileSnapshot(
+					path.resolve(snapPath, dir, 'sv-files-snapshots.md'),
+					`ai-tools manifest "${dir}" does not match snapshot`
+				);
+			}
+
 			if (projectName === 'create-with-all-addons' && process.platform !== 'win32') {
 				await exec('pnpm', ['install', '--no-frozen-lockfile'], {
 					nodeOptions: { stdio: 'pipe', cwd: testOutputPath }

packages/sv/src/cli/tests/snapshots/create-with-all-addons/CLAUDE.md → packages/sv/src/cli/tests/snapshots/create-with-all-addons/.claude/CLAUDE.md

@@ -2,7 +2,7 @@
 
 - **Language**: TypeScript
 - **Package Manager**: npm
-- **Add-ons**: prettier, eslint, vitest, playwright, tailwindcss, sveltekit-adapter, drizzle, better-auth, mdsvex, paraglide, mcp
+- **Add-ons**: prettier, eslint, vitest, playwright, tailwindcss, sveltekit-adapter, drizzle, better-auth, mdsvex, paraglide, ai-tools
 
 ---
 

packages/sv/src/cli/tests/snapshots/create-with-all-addons/.claude/agents/sv-files-snapshots.md

@@ -0,0 +1 @@
+svelte-file-editor.md

packages/sv/src/cli/tests/snapshots/create-with-all-addons/.claude/skills/sv-files-snapshots.md

@@ -0,0 +1,11 @@
+svelte-code-writer/SKILL.md
+svelte-core-bestpractices/SKILL.md
+svelte-core-bestpractices/references/$inspect.md
+svelte-core-bestpractices/references/@attach.md
+svelte-core-bestpractices/references/@render.md
+svelte-core-bestpractices/references/await-expressions.md
+svelte-core-bestpractices/references/bind.md
+svelte-core-bestpractices/references/each.md
+svelte-core-bestpractices/references/hydratable.md
+svelte-core-bestpractices/references/snippet.md
+svelte-core-bestpractices/references/svelte-reactivity.md

packages/sv/src/cli/tests/snapshots/create-with-all-addons/.cursor/agents/sv-files-snapshots.md

@@ -0,0 +1 @@
+svelte-file-editor.md