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 - set up the Svelte plugin (Claude Code, opencode) or pick individual tools (MCP server, skills, sub-agents) per client

.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/01-ai-tools.md

@@ -0,0 +1,56 @@
+---
+title: ai-tools
+---
+
+[Svelte AI Tools](/docs/ai/overview) can help your LLM write better Svelte code.
+
+## Usage
+
+```sh
+npx sv add ai-tools
+```
+
+## What you get
+
+You can add the tooling either through the official **Svelte plugin** or as **individual tools**.
+
+- The **Svelte plugin** bundles everything (MCP server, [skills](https://svelte.dev/docs/ai/skills) and sub-agents) and keeps itself up to date. It's available for Claude Code and opencode. For Claude Code it's enabled through a committed `.claude/settings.json` - the first time you open the project you'll be asked to trust the workspace, then it installs automatically (no `/plugin install` needed).
+- **Individual tools**, for clients without a plugin (or when you want to pick exactly what to add):
+  - 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
+  - Sub-agents for clients that support them
+
+## Options
+
+### ide
+
+The client(s) you want to use like `'claude-code'`, `'cursor'`, `'gemini'`, `'opencode'`, `'vscode'`, `'other'`.
+
+```sh
+npx sv add ai-tools="ide:cursor,vscode"
+```
+
+### delivery
+
+How to add the tooling: `'plugin'` (the Svelte plugin, recommended) or `'tools'` (individual tools). Only asked when a selected client supports a plugin.
+
+```sh
+npx sv add ai-tools="ide:claude-code+delivery:plugin"
+```
+
+### tools
+
+Which individual tools to add when not using the plugin, like `'mcp'`, `'svelte-code-writer'`, `'svelte-core-bestpractices'`, `'svelte-file-editor'`.
+
+```sh
+npx sv add ai-tools="ide:cursor+delivery:tools+tools:mcp,svelte-file-editor"
+```
+
+### mcpSetup
+
+The MCP setup you want to use (`'local'` or `'remote'`). Only relevant when adding the MCP server as an individual tool.
+
+```sh
+npx sv add ai-tools="mcpSetup:local"
+```

packages/sv/api-surface-testing.md

@@ -15,7 +15,7 @@ type OfficialAddons = {
 	mdsvex: Addon<any>;
 	paraglide: Addon<any>;
 	storybook: Addon<any>;
-	mcp: Addon<any>;
+	aiTools: Addon<any>;
 	experimental: Addon<any>;
 };
 declare const officialAddons: OfficialAddons;

packages/sv/api-surface.md

@@ -25,7 +25,7 @@ type OfficialAddons = {
 	mdsvex: Addon<any>;
 	paraglide: Addon<any>;
 	storybook: Addon<any>;
-	mcp: Addon<any>;
+	aiTools: Addon<any>;
 	experimental: Addon<any>;
 };
 declare const officialAddons: OfficialAddons;