fix: remove unneeded frontmatter

.changeset/small-actors-notice.md

@@ -1,5 +0,0 @@
----
-'@sveltejs/mcp': patch
----
-
-chore: remove db requirement

.github/workflows/check.yml

@@ -16,7 +16,7 @@ jobs:
         uses: actions/checkout@v6
 
       - name: Setup pnpm
-        uses: pnpm/action-setup@v5
+        uses: pnpm/action-setup@v4
         with:
           version: 10.28.2
 
@@ -32,4 +32,6 @@ jobs:
       - name: Run type check
         run: pnpm run check
         env:
+          DATABASE_URL: file:test.db
+          DATABASE_TOKEN: dummy-key
           VOYAGE_API_KEY: dummy-key

.github/workflows/lint.yml

@@ -16,7 +16,7 @@ jobs:
         uses: actions/checkout@v6
 
       - name: Setup pnpm
-        uses: pnpm/action-setup@v5
+        uses: pnpm/action-setup@v4
         with:
           version: 10.28.2
 
@@ -32,4 +32,6 @@ jobs:
       - name: Run linting
         run: pnpm run lint
         env:
+          DATABASE_URL: file:test.db
           VOYAGE_API_KEY: dummy-key
+          DATABASE_TOKEN: dummy-key

.github/workflows/release.yml

@@ -64,7 +64,7 @@ jobs:
 
   publish-mcp:
     needs: release
-    if: contains(needs.release.outputs.publishedPackages, '"@sveltejs/mcp"')
+    if: contains(needs.release.outputs.publishedPackages, '"@sveltejs/ai-tools"')
     uses: ./.github/workflows/publish-mcp.yml
     secrets:
       MCP_KEY: ${{ secrets.MCP_KEY }}

.github/workflows/sync-plugins.yml

@@ -46,12 +46,21 @@ jobs:
       - name: Install dependencies
         run: pnpm install --frozen-lockfile --prefer-offline --ignore-scripts
 
-      - name: Sync plugins
-        run: pnpm sync-plugins
+      - name: Sync Claude plugin
+        run: pnpm sync-claude-plugin
+
+      - name: Sync Cursor plugin
+        run: pnpm sync-cursor-plugin
+
+      - name: Sync OpenCode plugin
+        run: pnpm sync-opencode-plugin
 
       - name: Generate skills documentation
         run: pnpm generate-skill-docs
 
+      - name: Bump plugin versions for changed plugins
+        run: pnpm bump-plugin-versions
+
       - name: Check for changes
         id: git-check
         run: |
@@ -60,7 +69,6 @@ jobs:
             plugins/cursor/svelte/ \
             packages/opencode/skills/ \
             packages/opencode/instructions/ \
-            packages/opencode/schema.json \
             documentation/docs/ \
             || echo "changed=true" >> $GITHUB_OUTPUT
 
@@ -82,7 +90,7 @@ jobs:
             ## Changes
             - Synced `plugins/claude/svelte/` (skills, agents with `permissionMode`)
             - Synced `plugins/cursor/svelte/` (skills, agents, rules)
-            - Synced `packages/opencode/` (skills, instructions, schema)
+            - Synced `packages/opencode/` (skills, instructions)
             - Updated documentation
 
             ## Generated by

.github/workflows/test.yml

@@ -16,7 +16,7 @@ jobs:
         uses: actions/checkout@v6
 
       - name: Setup pnpm
-        uses: pnpm/action-setup@v5
+        uses: pnpm/action-setup@v4
         with:
           version: 10.28.2
 
@@ -32,9 +32,13 @@ jobs:
       - name: Build project
         run: pnpm run build
         env:
+          DATABASE_URL: file:test.db
           VOYAGE_API_KEY: dummy-key
+          DATABASE_TOKEN: dummy-key
 
       - name: Run tests
         run: pnpm run test
         env:
+          DATABASE_URL: file:test.db
           VOYAGE_API_KEY: dummy-key
+          DATABASE_TOKEN: dummy-key

.prettierrc

@@ -10,12 +10,6 @@
 			"options": {
 				"parser": "svelte"
 			}
-		},
-		{
-			"files": "**/references/*.md",
-			"options": {
-				"embeddedLanguageFormatting": "off"
-			}
 		}
 	]
 }

CLAUDE.md

@@ -83,6 +83,7 @@ Located in `src/lib/server/analyze/`:
 
 Required environment variables:
 
+- `DATABASE_URL`: SQLite database path (default: `file:test.db`)
 - `VOYAGE_API_KEY`: API key for embeddings support (optional)
 
 When connected to the svelte-llm MCP server, you have access to comprehensive Svelte 5 and SvelteKit documentation. Here's how to use the available tools effectively:

apps/mcp-remote/.env.example

@@ -1 +1,3 @@
+DATABASE_URL=file:test.db
+DATABASE_TOKEN=needs_to_be_set_but_it_can_be_anything
 VOYAGE_API_KEY=your_actual_api_key_here

apps/mcp-remote/drizzle.config.ts

@@ -0,0 +1,12 @@
+import { defineConfig } from 'drizzle-kit';
+
+if (!process.env.DATABASE_URL) throw new Error('DATABASE_URL is not set');
+if (!process.env.DATABASE_TOKEN) throw new Error('DATABASE_TOKEN is not set');
+
+export default defineConfig({
+	schema: './src/lib/server/db/schema.ts',
+	dialect: 'turso',
+	dbCredentials: { url: process.env.DATABASE_URL, authToken: process.env.DATABASE_TOKEN },
+	verbose: true,
+	strict: true,
+});

apps/mcp-remote/package.json

@@ -23,6 +23,10 @@
 		"test:unit": "vitest",
 		"test": "npm run test:unit -- --run",
 		"test:watch": "npm run test:unit -- --watch",
+		"db:push": "drizzle-kit push",
+		"db:generate": "drizzle-kit generate",
+		"db:migrate": "drizzle-kit migrate",
+		"db:studio": "drizzle-kit studio",
 		"inspect": "pnpm mcp-inspector"
 	},
 	"keywords": [
@@ -35,12 +39,15 @@
 	"devDependencies": {
 		"@eslint/compat": "catalog:lint",
 		"@eslint/js": "catalog:lint",
+		"@libsql/client": "catalog:orm",
 		"@modelcontextprotocol/inspector": "catalog:ai",
 		"@sveltejs/adapter-vercel": "catalog:svelte",
 		"@sveltejs/kit": "catalog:svelte",
 		"@sveltejs/vite-plugin-svelte": "catalog:svelte",
 		"@types/node": "catalog:tooling",
 		"@typescript-eslint/parser": "catalog:lint",
+		"drizzle-kit": "catalog:orm",
+		"drizzle-orm": "catalog:orm",
 		"eslint-config-prettier": "catalog:lint",
 		"eslint-plugin-svelte": "catalog:lint",
 		"globals": "catalog:lint",
@@ -55,6 +62,7 @@
 		"vitest": "catalog:tooling"
 	},
 	"dependencies": {
+		"@sveltejs/mcp-schema": "workspace:^",
 		"@sveltejs/mcp-server": "workspace:^",
 		"@tmcp/transport-http": "catalog:tmcp",
 		"@vercel/analytics": "catalog:tooling",

apps/mcp-remote/src/hooks.server.ts

@@ -1,5 +1,6 @@
 import { dev } from '$app/environment';
 import { http_transport } from '$lib/mcp/index.js';
+import { db } from '$lib/server/db/index.js';
 import { redirect } from '@sveltejs/kit';
 import { track } from '@vercel/analytics/server';
 
@@ -16,6 +17,7 @@ export async function handle({ event, resolve }) {
 		}
 	}
 	const mcp_response = await http_transport.respond(event.request, {
+		db,
 		// only add analytics in production
 		track: dev
 			? undefined

apps/mcp-remote/src/lib/server/db/index.ts

@@ -0,0 +1,13 @@
+import { createClient } from '@libsql/client';
+import { drizzle } from 'drizzle-orm/libsql';
+import * as schema from './schema.js';
+import { DATABASE_TOKEN, DATABASE_URL } from '$env/static/private';
+if (!DATABASE_URL) throw new Error('DATABASE_URL is not set');
+if (!DATABASE_TOKEN) throw new Error('DATABASE_TOKEN is not set');
+
+const client = createClient({
+	url: DATABASE_URL,
+	authToken: DATABASE_TOKEN,
+});
+
+export const db = drizzle(client, { schema, logger: true });

apps/mcp-remote/src/lib/server/db/schema.ts

@@ -0,0 +1,2 @@
+// we need to re-export from here to allow for the drizzle config to pick them up for migrations
+export * from '@sveltejs/mcp-schema/schema';

documentation/docs/10-introduction/10-overview.md

@@ -17,10 +17,6 @@ To get the most out of the MCP server we recommend including the following promp
 
 > [!NOTE] This is already setup for you when using `npx sv add mcp`
 
-<!-- prettier-ignore-start -->
-````markdown
 @include .generated/agents.md
-````
-<!-- prettier-ignore-end -->
 
 If your MCP client supports it, we also recommend using the [svelte-task](prompts#svelte-task) prompt to instruct the LLM on the best way to use the MCP server.

documentation/docs/30-capabilities/.generated/prompts.md

@@ -5,22 +5,10 @@ This prompt should be used whenever you are asking the model to work on a Svelte
 <details>
 	<summary>Copy the prompt</summary>
 
-<!-- prettier-ignore-start -->
-````markdown
+```md
 You are a Svelte expert tasked to build components and utilities for Svelte developers. If you need documentation for anything related to Svelte you can invoke the tool `get-documentation` with one of the following paths. However: before invoking the `get-documentation` tool, try to answer the users query using your own knowledge and the `svelte-autofixer` tool. Be mindful of how many section you request, since it is token-intensive!
 <available-docs>
 
-- title: Overview, use_cases: use title and path to estimate use case, path: ai/overview
-- title: Local setup, use_cases: use title and path to estimate use case, path: ai/local-setup
-- title: Remote setup, use_cases: use title and path to estimate use case, path: ai/remote-setup
-- title: Tools, use_cases: use title and path to estimate use case, path: ai/tools
-- title: Resources, use_cases: use title and path to estimate use case, path: ai/resources
-- title: Prompts, use_cases: use title and path to estimate use case, path: ai/prompts
-- title: Overview, use_cases: use title and path to estimate use case, path: ai/plugin
-- title: Subagent, use_cases: use title and path to estimate use case, path: ai/subagent
-- title: Overview, use_cases: use title and path to estimate use case, path: ai/opencode-plugin
-- title: Subagent, use_cases: use title and path to estimate use case, path: ai/opencode-subagent
-- title: Overview, use_cases: use title and path to estimate use case, path: ai/skills
 - title: Overview, use_cases: project setup, creating new svelte apps, scaffolding, cli tools, initializing projects, path: cli/overview
 - title: Frequently asked questions, use_cases: project setup, initializing new svelte projects, troubleshooting cli installation, package manager configuration, path: cli/faq
 - title: sv create, use_cases: project setup, starting new sveltekit app, initializing project, creating from playground, choosing project template, path: cli/sv-create
@@ -30,7 +18,7 @@ You are a Svelte expert tasked to build components and utilities for Svelte deve
 - title: devtools-json, use_cases: development setup, chrome devtools integration, browser-based editing, local development workflow, debugging setup, path: cli/devtools-json
 - title: drizzle, use_cases: database setup, sql queries, orm integration, data modeling, postgresql, mysql, sqlite, server-side data access, database migrations, type-safe queries, path: cli/drizzle
 - title: eslint, use_cases: code quality, linting, error detection, project setup, code standards, team collaboration, typescript projects, path: cli/eslint
-- title: better-auth, use_cases: use title and path to estimate use case, path: cli/better-auth
+- title: lucia, use_cases: authentication, login systems, user management, registration pages, session handling, auth setup, path: cli/lucia
 - title: mcp, use_cases: use title and path to estimate use case, path: cli/mcp
 - title: mdsvex, use_cases: blog, content sites, markdown rendering, documentation sites, technical writing, cms integration, article pages, path: cli/mdsvex
 - title: paraglide, use_cases: internationalization, multi-language sites, i18n, translation, localization, language switching, global apps, multilingual content, path: cli/paraglide
@@ -41,7 +29,6 @@ You are a Svelte expert tasked to build components and utilities for Svelte deve
 - title: tailwindcss, use_cases: project setup, styling, css framework, rapid prototyping, utility-first css, design systems, responsive design, adding tailwind to svelte, path: cli/tailwind
 - title: vitest, use_cases: testing, unit tests, component testing, test setup, quality assurance, ci/cd pipelines, test-driven development, path: cli/vitest
 - title: add-on, use_cases: use title and path to estimate use case, path: cli/add-on
-- title: sv-utils, use_cases: use title and path to estimate use case, path: cli/sv-utils
 - title: Introduction, use_cases: learning sveltekit, project setup, understanding framework basics, choosing between svelte and sveltekit, getting started with full-stack apps, path: kit/introduction
 - title: Creating a project, use_cases: project setup, starting new sveltekit app, initial development environment, first-time sveltekit users, scaffolding projects, path: kit/creating-a-project
 - title: Project types, use_cases: deployment, project setup, choosing adapters, ssg, spa, ssr, serverless, mobile apps, desktop apps, pwa, offline apps, browser extensions, separate backend, docker containers, path: kit/project-types
@@ -109,6 +96,17 @@ You are a Svelte expert tasked to build components and utilities for Svelte deve
 - title: Configuration, use_cases: project setup, configuration, adapters, deployment, build settings, environment variables, routing customization, prerendering, csp security, csrf protection, path configuration, typescript setup, path: kit/configuration
 - title: Command Line Interface, use_cases: project setup, typescript configuration, generated types, ./$types imports, initial project configuration, path: kit/cli
 - title: Types, use_cases: typescript, type safety, route parameters, api endpoints, load functions, form actions, generated types, jsconfig setup, path: kit/types
+- title: Overview, use_cases: use title and path to estimate use case, path: mcp/overview
+- title: Local setup, use_cases: use title and path to estimate use case, path: mcp/local-setup
+- title: Remote setup, use_cases: use title and path to estimate use case, path: mcp/remote-setup
+- title: Tools, use_cases: use title and path to estimate use case, path: mcp/tools
+- title: Resources, use_cases: use title and path to estimate use case, path: mcp/resources
+- title: Prompts, use_cases: use title and path to estimate use case, path: mcp/prompts
+- title: Overview, use_cases: use title and path to estimate use case, path: mcp/plugin
+- title: Skill, use_cases: use title and path to estimate use case, path: mcp/skill
+- title: Subagent, use_cases: use title and path to estimate use case, path: mcp/subagent
+- title: Overview, use_cases: use title and path to estimate use case, path: mcp/opencode-plugin
+- title: Subagent, use_cases: use title and path to estimate use case, path: mcp/opencode-subagent
 - title: Overview, use_cases: always, any svelte project, getting started, learning svelte, introduction, project setup, understanding framework basics, path: svelte/overview
 - title: Getting started, use_cases: project setup, starting new svelte project, initial installation, choosing between sveltekit and vite, editor configuration, path: svelte/getting-started
 - title: .svelte files, use_cases: always, any svelte project, component creation, project setup, learning svelte basics, path: svelte/svelte-files
@@ -156,7 +154,6 @@ You are a Svelte expert tasked to build components and utilities for Svelte deve
 - title: Lifecycle hooks, use_cases: component initialization, cleanup tasks, timers, subscriptions, dom measurements, chat windows, autoscroll features, migration from svelte 4, path: svelte/lifecycle-hooks
 - title: Imperative component API, use_cases: project setup, client-side rendering, server-side rendering, ssr, hydration, testing, programmatic component creation, tooltips, dynamic mounting, path: svelte/imperative-component-api
 - title: Hydratable data, use_cases: use title and path to estimate use case, path: svelte/hydratable
-- title: Best practices, use_cases: use title and path to estimate use case, path: svelte/best-practices
 - title: Testing, use_cases: testing, quality assurance, unit tests, integration tests, component tests, e2e tests, vitest setup, playwright setup, test automation, path: svelte/testing
 - title: TypeScript, use_cases: typescript setup, type safety, component props typing, generic components, wrapper components, dom type augmentation, project configuration, path: svelte/typescript
 - title: Custom elements, use_cases: web components, custom elements, component library, design system, framework-agnostic components, embedding svelte in non-svelte apps, shadow dom, path: svelte/custom-elements
@@ -207,7 +204,6 @@ This is the task you will work on:
 </task>
 
 If you are not writing the code into a file, once you have the final version of the code ask the user if it wants to generate a playground link to quickly check the code in it and if it answer yes call the `playground-link` tool and return the url to the user nicely formatted. The playground link MUST be generated only once you have the final version of the code and you are ready to share it, it MUST include an entry point file called `App.svelte` where the main component should live. If you have multiple files to include in the playground link you can include them all at the root.
-````
-<!-- prettier-ignore-end -->
+```
 
 </details>

documentation/docs/50-opencode-plugin/opencode-plugin.md

@@ -6,7 +6,7 @@ OpenCode has a [plugin system](https://opencode.ai/docs/plugins/) that allows de
 
 ## Installation
 
-To install the plugin in OpenCode you can edit your [OpenCode config](https://opencode.ai/docs/config/) (either the global or the local one), adding `@sveltejs/opencode` to the list of plugins.
+To install the plugin in OpenCode you can edit your [OpenCode config]() (either the global or the local one), adding `@sveltejs/opencode` to the list of plugins.
 
 ```json
 {
@@ -23,24 +23,16 @@ The default configuration for the Svelte OpenCode plugin looks like this...
 
 ```json
 {
-	"$schema": "https://svelte.dev/opencode/schema.json",
+	"$schema": "https://raw.githubusercontent.com/sveltejs/ai-tools/refs/heads/main/packages/opencode/schema.json",
 	"mcp": {
 		"type": "remote",
 		"enabled": true
 	},
 	"subagent": {
-		"enabled": true,
-		"agents": {
-			"svelte-file-editor": {
-				"model": "other-model", // defaults to the same as main agent,
-				"temperature": 1, // default to unset
-				"top_p": 0.7, // default to unset,
-				"maxSteps": 20 // default to unlimited
-			}
-		}
+		"enabled": true
 	},
 	"skills": {
-		"enabled": true // it can also be an array of all the skills to enable like ['svelte-core-bestpractices']
+		"enabled": true
 	},
 	"instructions": {
 		"enabled": true
@@ -48,6 +40,6 @@ The default configuration for the Svelte OpenCode plugin looks like this...
 }
 ```
 
-...but if you prefer, you can enable only the subagent, only the MCP, only the skills (`enabled` supports both a boolean or an array containing the name of all the skills to enable), or configure the kind of MCP server you want to use (`local` or `remote`).
+...but if you prefer, you can enable only the subagent, only the MCP, only the skills, or configure the kind of MCP server you want to use (`local` or `remote`).
 
 You can place this file in `./.opencode/svelte.json` (in your project), in `~/.config/opencode/svelte.json` or, if you have an `OPENCODE_CONFIG_DIR` environment variable specified, at `$OPENCODE_CONFIG_DIR/svelte.json`.

documentation/docs/60-skills/.generated/skills.md

@@ -217,7 +217,7 @@ The CSS in a component's `<style>` is scoped to that component. If a parent comp
 </style>
 ```
 
-If this is impossible (for example, the child component comes from a library) you can use `:global` to override styles:
+If this impossible (for example, the child component comes from a library) you can use `:global` to override styles:
 
 ```svelte
 <div>

package.json

@@ -25,12 +25,10 @@
 		"debug:generate-summaries": "pnpm --filter @sveltejs/mcp-server run debug:generate-summaries",
 		"release": "pnpm --filter @sveltejs/mcp run build && changeset publish",
 		"changeset:version": "changeset version && pnpm --filter @sveltejs/mcp run update:version && git add --all",
-		"sync-plugins": "pnpm sync-claude-plugin && pnpm sync-cursor-plugin && pnpm sync-opencode-plugin && pnpm bump-plugin-versions",
 		"sync-claude-plugin": "node scripts/sync-claude-plugin.ts",
 		"sync-cursor-plugin": "node scripts/sync-cursor-plugin.ts",
-		"sync-opencode-plugin": "node scripts/sync-opencode-plugin.ts && pnpm generate-opencode-jsonschema",
+		"sync-opencode-plugin": "node scripts/sync-opencode-plugin.ts",
 		"bump-plugin-versions": "node scripts/bump-plugin-versions.ts",
-		"postbump-plugin-versions": "pnpm format",
 		"resolve-references": "node scripts/resolve-references.ts",
 		"postresolve-references": "pnpm format"
 	},

packages/mcp-schema/package.json

@@ -0,0 +1,19 @@
+{
+	"name": "@sveltejs/mcp-schema",
+	"version": "0.0.1",
+	"private": true,
+	"description": "",
+	"main": "index.js",
+	"exports": {
+		".": "./src/index.js",
+		"./utils": "./src/utils.js",
+		"./schema": "./src/schema.js"
+	},
+	"keywords": [],
+	"author": "",
+	"license": "ISC",
+	"type": "module",
+	"dependencies": {
+		"drizzle-orm": "catalog:orm"
+	}
+}

packages/mcp-schema/src/index.js

@@ -0,0 +1,8 @@
+/**
+ * @import * as schema from './schema.js'
+ */
+export * from './schema.js';
+
+/**
+ * @typedef {typeof schema} Schema
+ */

packages/mcp-schema/src/schema.js

@@ -0,0 +1,82 @@
+import { integer, sqliteTable, text } from 'drizzle-orm/sqlite-core';
+import { float_32_array } from './utils.js';
+
+/**
+ * NOTE: if you modify a schema adding a vector column you need to manually add this
+ *
+ * CREATE INDEX IF NOT EXISTS name_of_the_index
+ * ON `name_of_the_table` (
+ * 	libsql_vector_idx(name_of_the_column, 'metric=cosine')
+ * )
+ *
+ * to the generated migration file
+ */
+
+export const distillations = sqliteTable('distillations', {
+	id: integer('id').primaryKey(),
+	preset_name: text('preset_name').notNull(),
+	version: text('version').notNull(),
+	content: text('content').notNull(),
+	size_kb: integer('size_kb').notNull(),
+	document_count: integer('document_count').notNull(),
+	distillation_job_id: integer('distillation_job_id').references(() => distillation_jobs.id),
+	created_at: integer('created_at', { mode: 'timestamp' })
+		.notNull()
+		.$defaultFn(() => new Date()),
+});
+
+export const distillation_jobs = sqliteTable('distillation_jobs', {
+	id: integer('id').primaryKey(),
+	preset_name: text('preset_name').notNull(),
+	batch_id: text('batch_id'),
+	status: text('status', { enum: ['pending', 'processing', 'completed', 'failed'] }).notNull(),
+	model_used: text('model_used').notNull(),
+	total_files: integer('total_files').notNull(),
+	processed_files: integer('processed_files').notNull().default(0),
+	successful_files: integer('successful_files').notNull().default(0),
+	minimize_applied: integer('minimize_applied', { mode: 'boolean' }).notNull().default(false),
+	total_input_tokens: integer('total_input_tokens').notNull().default(0),
+	total_output_tokens: integer('total_output_tokens').notNull().default(0),
+	started_at: integer('started_at', { mode: 'timestamp' }),
+	completed_at: integer('completed_at', { mode: 'timestamp' }),
+	error_message: text('error_message'),
+	metadata: text('metadata', { mode: 'json' }).notNull().default({}),
+	created_at: integer('created_at', { mode: 'timestamp' })
+		.notNull()
+		.$defaultFn(() => new Date()),
+	updated_at: integer('updated_at', { mode: 'timestamp' })
+		.notNull()
+		.$defaultFn(() => new Date()),
+});
+
+export const content = sqliteTable('content', {
+	id: integer('id').primaryKey(),
+	path: text('path').notNull(),
+	filename: text('filename').notNull(),
+	content: text('content').notNull(),
+	size_bytes: integer('size_bytes').notNull(),
+	embeddings: float_32_array('embeddings', { dimensions: 1024 }),
+	metadata: text('metadata', { mode: 'json' }).notNull().default({}),
+	created_at: integer('created_at', { mode: 'timestamp' })
+		.notNull()
+		.$defaultFn(() => new Date()),
+	updated_at: integer('updated_at', { mode: 'timestamp' })
+		.notNull()
+		.$defaultFn(() => new Date()),
+});
+
+export const content_distilled = sqliteTable('content_distilled', {
+	id: integer('id').primaryKey(),
+	path: text('path').notNull(),
+	filename: text('filename').notNull(),
+	content: text('content').notNull(),
+	size_bytes: integer('size_bytes').notNull(),
+	embeddings: float_32_array('embeddings', { dimensions: 1024 }),
+	metadata: text('metadata', { mode: 'json' }).notNull().default({}),
+	created_at: integer('created_at', { mode: 'timestamp' })
+		.notNull()
+		.$defaultFn(() => new Date()),
+	updated_at: integer('updated_at', { mode: 'timestamp' })
+		.notNull()
+		.$defaultFn(() => new Date()),
+});

packages/mcp-schema/src/utils.js

@@ -0,0 +1,65 @@
+/**
+ * @import { Column } from 'drizzle-orm';
+ */
+import { sql } from 'drizzle-orm';
+import { customType } from 'drizzle-orm/sqlite-core';
+
+/**
+ * Helper function to convert an array of embeddings into a format that can be inserted into a LibSQL vector column.
+ * @param {number[]} arr The embeddings array.
+ */
+export function vector(arr) {
+	return sql`vector32(${JSON.stringify(arr)})`;
+}
+
+/**
+ * Helper function to calculate the distance between a vector column and an array of embeddings and return it as a columns.
+ * @param {Column} column The drizzle column representing the vector.
+ * @param {number} arr The embeddings array.
+ * @param {string} as The name of the returned column. Default is 'distance'.
+ *
+ * @example
+ * await db.select({
+ *   id: vector_table.id,
+ *   text: vector_table.text,
+ *   distance: distance(vector_table.vector, await get_embeddings(sentence)),
+ * })
+ * .from(vector_table)
+ * .orderBy(sql`distance`)
+ * .execute();
+ */
+export function distance(column, arr, as = 'distance') {
+	return /** @type {typeof sql<number>} */ (
+		sql
+	)`CASE ${column} ISNULL WHEN 1 THEN 1 ELSE vector_distance_cos(${column}, vector32(${JSON.stringify(arr)})) END`.as(
+		as,
+	);
+}
+
+/**
+ * Custom drizzle type to use the LibSQL vector column type.
+ */
+export const float_32_array = /** @type {typeof customType<{
+	data: number[];
+	config: { dimensions: number };
+	configRequired: true;
+	driverData: Buffer;
+}>} */ (customType)({
+	dataType(config) {
+		return `F32_BLOB(${config.dimensions})`;
+	},
+	/**
+	 * @param {Buffer} value
+	 */
+	fromDriver(value) {
+		return Array.from(new Float32Array(value.buffer));
+	},
+	/**
+	 *
+	 * @param {number[]} value
+	 * @returns
+	 */
+	toDriver(value) {
+		return vector(value);
+	},
+});

packages/mcp-server/package.json

@@ -17,8 +17,12 @@
 		".": "./src/index.ts",
 		"./handlers": "./src/mcp/handlers/tools/handlers.ts"
 	},
+	"peerDependencies": {
+		"drizzle-orm": "^0.45.0"
+	},
 	"dependencies": {
 		"@mcp-ui/server": "catalog:ai",
+		"@sveltejs/mcp-schema": "workspace:^",
 		"@tmcp/adapter-valibot": "catalog:tmcp",
 		"@tmcp/transport-in-memory": "catalog:tmcp",
 		"@typescript-eslint/parser": "catalog:lint",

packages/mcp-server/src/mcp/autofixers/add-autofixers-issues.test.ts

@@ -344,111 +344,87 @@ describe('add_autofixers_issues', () => {
 	});
 
 	describe('imported_runes', () => {
-		describe.each([
-			{ source: 'svelte' },
-			{ source: 'svelte/runes' },
-			{ source: '@sveltejs/runes' },
-			{ source: '@sveltejs/vite-plugin-svelte' },
-		])('from "$source"', ({ source }) => {
-			describe.each(dollarless_runes)('single import ($rune)', ({ rune }) => {
-				it(`should add suggestions when importing '${rune}' from '${source}'`, () => {
-					const content = run_autofixers_on_code(`
+		describe.each([{ source: 'svelte' }, { source: 'svelte/runes' }])(
+			'from "$source"',
+			({ source }) => {
+				describe.each(dollarless_runes)('single import ($rune)', ({ rune }) => {
+					it(`should add suggestions when importing '${rune}' from '${source}'`, () => {
+						const content = run_autofixers_on_code(`
 					<script>
 						import { ${rune} } from '${source}';
 					</script>`);
 
-					expect(content.suggestions.length).toBeGreaterThanOrEqual(1);
-					expect(content.suggestions).toContain(
-						`You are importing "${rune}" from "${source}". This is not necessary, all runes are globally available. Please remove this import and use "$${rune}" directly.`,
-					);
-				});
+						expect(content.suggestions.length).toBeGreaterThanOrEqual(1);
+						expect(content.suggestions).toContain(
+							`You are importing "${rune}" from "${source}". This is not necessary, all runes are globally available. Please remove this import and use "$${rune}" directly.`,
+						);
+					});
 
-				it(`should add suggestions when importing "${rune}" as the default export from '${source}'`, () => {
-					const content = run_autofixers_on_code(`
+					it(`should add suggestions when importing "${rune}" as the default export from '${source}'`, () => {
+						const content = run_autofixers_on_code(`
 					<script>
 						import ${rune} from '${source}';
 					</script>`);
 
-					expect(content.suggestions.length).toBeGreaterThanOrEqual(1);
-					expect(content.suggestions).toContain(
-						`You are importing "${rune}" from "${source}". This is not necessary, all runes are globally available. Please remove this import and use "$${rune}" directly.`,
-					);
-				});
+						expect(content.suggestions.length).toBeGreaterThanOrEqual(1);
+						expect(content.suggestions).toContain(
+							`You are importing "${rune}" from "${source}". This is not necessary, all runes are globally available. Please remove this import and use "$${rune}" directly.`,
+						);
+					});
 
-				it(`should add suggestions when importing '${rune}' as the namespace export from '${source}'`, () => {
-					const content = run_autofixers_on_code(`
+					it(`should add suggestions when importing '${rune}' as the namespace export from '${source}'`, () => {
+						const content = run_autofixers_on_code(`
 					<script>
 						import * as ${rune} from '${source}';
 					</script>`);
 
-					expect(content.suggestions.length).toBeGreaterThanOrEqual(1);
-					expect(content.suggestions).toContain(
-						`You are importing "${rune}" from "${source}". This is not necessary, all runes are globally available. Please remove this import and use "$${rune}" directly.`,
-					);
+						expect(content.suggestions.length).toBeGreaterThanOrEqual(1);
+						expect(content.suggestions).toContain(
+							`You are importing "${rune}" from "${source}". This is not necessary, all runes are globally available. Please remove this import and use "$${rune}" directly.`,
+						);
+					});
 				});
-			});
 
-			it(`should add suggestions when importing multiple runes from '${source}'`, () => {
-				const content = run_autofixers_on_code(`
+				it(`should add suggestions when importing multiple runes from '${source}'`, () => {
+					const content = run_autofixers_on_code(`
 					<script>
 						import { onMount, state, effect } from '${source}';
 					</script>`);
 
-				expect(content.suggestions.length).toBeGreaterThanOrEqual(2);
-				expect(content.suggestions).toContain(
-					`You are importing "state" from "${source}". This is not necessary, all runes are globally available. Please remove this import and use "$state" directly.`,
-				);
-				expect(content.suggestions).toContain(
-					`You are importing "effect" from "${source}". This is not necessary, all runes are globally available. Please remove this import and use "$effect" directly.`,
-				);
-			});
+					expect(content.suggestions.length).toBeGreaterThanOrEqual(2);
+					expect(content.suggestions).toContain(
+						`You are importing "state" from "${source}". This is not necessary, all runes are globally available. Please remove this import and use "$state" directly.`,
+					);
+					expect(content.suggestions).toContain(
+						`You are importing "effect" from "${source}". This is not necessary, all runes are globally available. Please remove this import and use "$effect" directly.`,
+					);
+				});
 
-			it(`should not add suggestions when importing other identifiers from '${source}'`, () => {
-				const content = run_autofixers_on_code(`
+				it(`should not add suggestions when importing other identifiers from '${source}'`, () => {
+					const content = run_autofixers_on_code(`
 					<script>
 						import { onMount } from '${source}';
 					</script>`);
 
-				expect(content.suggestions).not.toContain(
-					`You are importing "onMount" from "${source}". This is not necessary, all runes are globally available. Please remove this import and use "$onMount" directly.`,
-				);
-			});
-		});
+					expect(content.suggestions).not.toContain(
+						`You are importing "onMount" from "${source}". This is not necessary, all runes are globally available. Please remove this import and use "$onMount" directly.`,
+					);
+				});
+			},
+		);
 
 		describe.each(dollarless_runes)('importing $rune from external lib', ({ rune }) => {
-			it(`should not add suggestions when importing from packages whose name doesn't contain svelte`, () => {
-				const content = run_autofixers_on_code(`
-				<script>
-					import { ${rune} } from 'something-something';
-				</script>`);
-
-				expect(content.suggestions).not.toContain(
-					`You are importing "${rune}" from "something-something". This is not necessary, all runes are globally available. Please remove this import and use "$${rune}" directly.`,
-				);
-			});
-
-			it(`should add suggestions with a different hint when importing from packages whose name contains svelte but it's not official`, () => {
+			it(`should not add suggestions when importing from packages that are not svelte`, () => {
 				const content = run_autofixers_on_code(`
 				<script>
 					import { ${rune} } from 'svelte-something-something';
 				</script>`);
 
-				expect(content.suggestions).toContain(
-					`You are importing "${rune}" from "svelte-something-something". If you are trying to import runes to use them this is not necessary, all runes are globally available. Please remove this import and use "$${rune}" directly. If you are importing the function from a separate library ignore this suggestion.`,
+				expect(content.suggestions).not.toContain(
+					`You are importing "${rune}" from "svelte-something-something". This is not necessary, all runes are globally available. Please remove this import and use "$${rune}" directly.`,
 				);
 			});
 		});
-
-		it('should not add the imported_runes suggestion when importing derived from svelte/store', () => {
-			const content = run_autofixers_on_code(`
-			<script>
-				import { derived } from 'svelte/store';
-			</script>`);
-
-			expect(content.suggestions).not.toContain(
-				'You are importing "derived" from "svelte/store". This is not necessary, all runes are globally available. Please remove this import and use "$derived" directly.',
-			);
-		});
 	});
 
 	describe('derived_with_function', () => {

packages/mcp-server/src/mcp/autofixers/visitors/imported-runes.ts

@@ -3,20 +3,10 @@ import type { Autofixer } from './index.js';
 
 const dollarless_runes = base_runes.map((r) => r.replace('$', ''));
 
-function should_suggest_for_source(source: string, rune: string) {
-	if (!source.includes('svelte')) {
-		return false;
-	}
-	if (source === 'svelte/store' && rune === 'derived') {
-		return false;
-	}
-	return true;
-}
-
 export const imported_runes: Autofixer = {
 	ImportDeclaration(node, { state, next }) {
 		const source = (node.source.value || node.source.raw?.slice(1, -1))?.toString();
-		if (source) {
+		if (source && (source === 'svelte' || source.startsWith('svelte/'))) {
 			for (const specifier of node.specifiers) {
 				const id =
 					specifier.type === 'ImportDefaultSpecifier'
@@ -26,25 +16,10 @@ export const imported_runes: Autofixer = {
 							: specifier.type === 'ImportSpecifier'
 								? specifier.imported
 								: null;
-				if (
-					id &&
-					id.type === 'Identifier' &&
-					dollarless_runes.includes(id.name) &&
-					should_suggest_for_source(source, id.name)
-				) {
-					if (
-						source === 'svelte' ||
-						source.startsWith('svelte/') ||
-						source.startsWith('@sveltejs')
-					) {
-						state.output.suggestions.push(
-							`You are importing "${id.name}" from "${source}". This is not necessary, all runes are globally available. Please remove this import and use "$${id.name}" directly.`,
-						);
-					} else {
-						state.output.suggestions.push(
-							`You are importing "${id.name}" from "${source}". If you are trying to import runes to use them this is not necessary, all runes are globally available. Please remove this import and use "$${id.name}" directly. If you are importing the function from a separate library ignore this suggestion.`,
-						);
-					}
+				if (id && id.type === 'Identifier' && dollarless_runes.includes(id.name)) {
+					state.output.suggestions.push(
+						`You are importing "${id.name}" from "${source}". This is not necessary, all runes are globally available. Please remove this import and use "$${id.name}" directly.`,
+					);
 				}
 			}
 		}

packages/mcp-server/src/mcp/handlers/tools/get-documentation.ts

@@ -91,56 +91,16 @@ export async function get_documentation_handler({
 		}
 	});
 
-	const successes = results.filter((r) => r.success);
-	const failed_sections = sections.filter(
-		(s) =>
-			!available_sections.some(
-				(a) => a.title.toLowerCase() === s.toLowerCase() || a.slug === s || a.url === s,
-			),
-	);
+	const has_any_success = results.some((result) => result.success);
+	let final_text = results.map((r) => r.content).join('\n\n---\n\n');
 
-	if (successes.length > 0 && failed_sections.length === 0) {
-		return successes.map((r) => r.content).join('\n\n---\n\n');
-	}
-
-	const parts: string[] = [];
-
-	if (successes.length > 0) {
-		parts.push(successes.map((r) => r.content).join('\n\n---\n\n'));
-	}
-
-	const fuzzy_results = failed_sections.map((requested) => {
-		const lower = requested.toLowerCase();
-		const matches = available_sections.filter(
-			(a) =>
-				a.title.toLowerCase().includes(lower) ||
-				a.slug.includes(lower) ||
-				lower.includes(a.slug.split('/').pop() ?? '') ||
-				a.use_cases.toLowerCase().includes(lower),
-		);
-		return { requested, matches };
-	});
-
-	const has_fuzzy = fuzzy_results.some((r) => r.matches.length > 0);
-
-	// Full list only when no successes and no fuzzy matches
-	if (successes.length === 0 && !has_fuzzy) {
+	if (!has_any_success) {
 		const formatted_sections = await format_sections_list();
-		parts.push(`${SECTIONS_LIST_INTRO}\n\n${formatted_sections}\n\n${SECTIONS_LIST_OUTRO}`);
+
+		final_text += `\n\n---\n\n${SECTIONS_LIST_INTRO}\n\n${formatted_sections}\n\n${SECTIONS_LIST_OUTRO}`;
 	}
 
-	// Similar results then errors
-	for (const { requested, matches } of fuzzy_results) {
-		if (matches.length > 0) {
-			const match_list = matches.map((m) => `- title: ${m.title}, section: ${m.slug}`).join('\n');
-			parts.push(
-				`${matches.length} similar result${matches.length > 1 ? 's' : ''} for "${requested}":\n${match_list}`,
-			);
-		}
-		parts.push(`Section not found: "${requested}".`);
-	}
-
-	return parts.join('\n\n---\n\n');
+	return final_text;
 }
 
 export function get_documentation(server: SvelteMcp) {

packages/mcp-server/src/mcp/index.ts

@@ -1,6 +1,8 @@
 import { ValibotJsonSchemaAdapter } from '@tmcp/adapter-valibot';
 import { McpServer } from 'tmcp';
 import { setup_prompts, setup_resources, setup_tools } from './handlers/index.js';
+import type { LibSQLDatabase } from 'drizzle-orm/libsql';
+import type { Schema } from '@sveltejs/mcp-schema';
 import { icons } from './icons/index.js';
 
 export const server = new McpServer(
@@ -23,6 +25,7 @@ export const server = new McpServer(
 			'This is the official Svelte MCP server. It MUST be used whenever svelte development is involved. It can provide official documentation, code examples and correct your code. After you correct the component call this tool again to confirm all the issues are fixed.',
 	},
 ).withContext<{
+	db: LibSQLDatabase<Schema>;
 	track?: (sessionId: string, event: string, extra?: string) => Promise<void>;
 }>();
 

packages/mcp-stdio/CHANGELOG.md

@@ -1,17 +1,5 @@
 # @sveltejs/mcp
 
-## 0.1.22
-
-### Patch Changes
-
-- fix: broaden checks for imported runes because LLMs are unhinged ([#185](https://github.com/sveltejs/ai-tools/pull/185))
-
-## 0.1.21
-
-### Patch Changes
-
-- feat: display similar result & error at the end ([#161](https://github.com/sveltejs/ai-tools/pull/161))
-
 ## 0.1.20
 
 ### Patch Changes

packages/mcp-stdio/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@sveltejs/mcp",
-	"version": "0.1.22",
+	"version": "0.1.20",
 	"type": "module",
 	"license": "MIT",
 	"mcpName": "dev.svelte/mcp",

packages/mcp-stdio/server.json

@@ -9,7 +9,7 @@
 		"subfolder": "packages/mcp-stdio",
 		"source": "github"
 	},
-	"version": "0.1.22",
+	"version": "0.1.20",
 	"websiteUrl": "https://svelte.dev/docs/mcp/overview",
 	"icons": [
 		{
@@ -25,7 +25,7 @@
 		{
 			"registryType": "npm",
 			"identifier": "@sveltejs/mcp",
-			"version": "0.1.22",
+			"version": "0.1.20",
 			"runtimeHint": "npx",
 			"transport": {
 				"type": "stdio"

packages/opencode/CHANGELOG.md

@@ -1,35 +1,5 @@
 # @sveltejs/opencode
 
-## 0.1.8
-
-### Patch Changes
-
-- fix: add `server` export to opencode plugin ([`96c50ac`](https://github.com/sveltejs/ai-tools/commit/96c50acae2b4131a6c72d3579a73c44ab9158b18))
-
-## 0.1.7
-
-### Patch Changes
-
-- fix: import `ts` files directly ([#190](https://github.com/sveltejs/ai-tools/pull/190))
-
-## 0.1.6
-
-### Patch Changes
-
-- chore: sync skills from svelte.dev ([#178](https://github.com/sveltejs/ai-tools/pull/178))
-
-- fix: update svelte-file-editor agent to use proper name ([#183](https://github.com/sveltejs/ai-tools/pull/183))
-
-## 0.1.5
-
-### Patch Changes
-
-- fix: merge user-configured svelte-file-editor agent settings ([#176](https://github.com/sveltejs/ai-tools/pull/176))
-
-- feat(opencode): mcp enabled option is passed to opencode ([#171](https://github.com/sveltejs/ai-tools/pull/171))
-
-- feat: allow enabling a specific skill in opencode plugin ([#174](https://github.com/sveltejs/ai-tools/pull/174))
-
 ## 0.1.4
 
 ### Patch Changes

packages/opencode/README.md

@@ -36,76 +36,39 @@ The plugin injects instructions that teach the agent how to effectively use the
 
 ## Configuration
 
-Create `svelte.json` to customize how the plugin configures MCP, the Svelte subagent, instructions, and skills.
+The default configuration:
 
 ```json
 {
-	"$schema": "https://svelte.dev/opencode/schema.json",
+	"$schema": "https://raw.githubusercontent.com/sveltejs/ai-tools/refs/heads/main/packages/opencode/schema.json",
 	"mcp": {
 		"type": "remote",
 		"enabled": true
 	},
 	"subagent": {
-		"enabled": true,
-		"agents": {
-			"svelte-file-editor": {
-				"model": "anthropic/claude-sonnet-4-20250514",
-				"temperature": 0.7,
-				"top_p": 0.9,
-				"maxSteps": 20
-			}
-		}
+		"enabled": true
 	},
 	"instructions": {
 		"enabled": true
-	},
-	"skills": {
-		"enabled": ["svelte-code-writer", "svelte-core-bestpractices"]
 	}
 }
 ```
 
-### Defaults
-
-If omitted, the plugin uses these defaults:
-
-- `mcp.type`: `"remote"`
-- `mcp.enabled`: `true`
-- `subagent.enabled`: `true`
-- `subagent.agents`: `{}`
-- `instructions.enabled`: `true`
-- `skills.enabled`: `true`
-
 ### Configuration Options
 
-| Option                                           | Type                  | Default    | Description                                                                                    |
-| ------------------------------------------------ | --------------------- | ---------- | ---------------------------------------------------------------------------------------------- |
-| `mcp.type`                                       | `"remote" \| "local"` | `"remote"` | Use `https://mcp.svelte.dev/mcp` (`remote`) or run `@sveltejs/mcp` via `npx` (`local`).        |
-| `mcp.enabled`                                    | `boolean`             | `true`     | Enable or disable the Svelte MCP server entry.                                                 |
-| `subagent.enabled`                               | `boolean`             | `true`     | Enable or disable registration of the `svelte-file-editor` subagent.                           |
-| `subagent.agents.svelte-file-editor.model`       | `string`              | main agent | Override the model used by the Svelte file editor subagent.                                    |
-| `subagent.agents.svelte-file-editor.temperature` | `number`              | unset      | Set temperature for the subagent.                                                              |
-| `subagent.agents.svelte-file-editor.top_p`       | `number`              | unset      | Set top-p sampling for the subagent.                                                           |
-| `subagent.agents.svelte-file-editor.maxSteps`    | `number`              | unlimited  | Limit the number of steps the subagent can execute.                                            |
-| `instructions.enabled`                           | `boolean`             | `true`     | Enable or disable automatic instruction-file injection.                                        |
-| `skills.enabled`                                 | `boolean \| string[]` | `true`     | Enable all skills (`true`), disable all skills (`false`), or enable only specific skill names. |
+| Option                 | Type                    | Default    | Description                                                                      |
+| ---------------------- | ----------------------- | ---------- | -------------------------------------------------------------------------------- |
+| `mcp.type`             | `"remote"` \| `"local"` | `"remote"` | Use the remote server at `mcp.svelte.dev` or run locally via `npx @sveltejs/mcp` |
+| `mcp.enabled`          | `boolean`               | `true`     | Enable/disable the MCP server                                                    |
+| `subagent.enabled`     | `boolean`               | `true`     | Enable/disable the Svelte file editor subagent                                   |
+| `instructions.enabled` | `boolean`               | `true`     | Enable/disable agent instructions injection                                      |
 
-### Supported Skill Names
+### Config File Location
 
-When using `skills.enabled` as an array, these built-in names are currently available:
+Place your configuration at one of these locations:
 
-- `svelte-code-writer`
-- `svelte-core-bestpractices`
-
-### Config File Locations and Precedence
-
-The plugin reads from these files (lowest priority first, highest priority last):
-
-- `~/.config/opencode/svelte.json`
-- `$OPENCODE_CONFIG_DIR/svelte.json` (when `OPENCODE_CONFIG_DIR` is set)
-- `.opencode/svelte.json` in the current project
-
-If the same key is defined in multiple files, the later location overrides earlier ones.
+- `~/.config/opencode/svelte.json` (global)
+- `$OPENCODE_CONFIG_DIR/svelte.json` (if `OPENCODE_CONFIG_DIR` is set, takes priority)
 
 ## License
 

packages/opencode/agents.ts

@@ -1,11 +0,0 @@
-// This file is auto-generated by scripts/sync-opencode-plugin.ts
-// Do not edit manually — edit the markdown files in tools/agents/ instead.
-
-export const agents = {
-	'svelte-file-editor': {
-		description:
-			'Specialized Svelte 5 code editor. MUST BE USED PROACTIVELY when creating, editing, or reviewing any .svelte file or .svelte.ts/.svelte.js module and MUST use the tools from the MCP server or the `svelte-file-editor` skill if they are available. Fetches relevant documentation and validates code using the Svelte MCP server tools.',
-		prompt:
-			"You are a Svelte 5 expert responsible for writing, editing, and validating Svelte components and modules. You have access to the Svelte MCP server which provides documentation and code analysis tools. Always use the tools from the svelte MCP server to fetch documentation with `get_documentation` and validating the code with `svelte_autofixer`. If the autofixer returns any issue or suggestions try to solve them.\n\nIf the MCP tools are not available you can use the `svelte-code-writer` skill to learn how to use the `@sveltejs/mcp` cli to access the same tools.\n\nIf the skill is not available you can run `npx @sveltejs/mcp@latest -y --help` to learn how to use it.\n\n## Available MCP Tools\n\n### 1. list-sections\n\nLists all available Svelte 5 and SvelteKit documentation sections with titles and paths. Use this first to discover what documentation is available.\n\n### 2. get-documentation\n\nRetrieves full documentation for specified sections. Accepts a single section name or an array of section names. Use after `list-sections` to fetch relevant docs for the task at hand.\n\n**Example sections:** `$state`, `$derived`, `$effect`, `$props`, `$bindable`, `snippets`, `routing`, `load functions`\n\n### 3. svelte-autofixer\n\nAnalyzes Svelte code and returns suggestions to fix issues. Pass the component code directly to this tool. It will detect common mistakes like:\n\n- Using `$effect` instead of `$derived` for computations\n- Missing cleanup in effects\n- Svelte 4 syntax (`on:click`, `export let`, `<slot>`)\n- Missing keys in `{#each}` blocks\n- And more\n\n## Workflow\n\nWhen invoked to work on a Svelte file:\n\n### 1. Gather Context (if needed)\n\nIf you're uncertain about Svelte 5 syntax or patterns, use the MCP tools:\n\n1. Call `list-sections` to see available documentation\n2. Call `get-documentation` with relevant section names\n\n### 2. Read the Target File\n\nRead the file to understand the current implementation.\n\n### 3. Make Changes\n\nApply edits following Svelte 5 best practices:\n\n### 4. Validate Changes\n\nAfter editing, ALWAYS call `svelte-autofixer` with the updated code to check for issues.\n\n### 5. Fix Any Issues\n\nIf the autofixer reports problems, fix them and re-validate until no issues remain.\n\n## Output Format\n\nAfter completing your work, provide:\n\n1. Summary of changes made\n2. Any issues found and fixed by the autofixer\n3. Recommendations for further improvements (if any)",
-	},
-} as const;

packages/opencode/config.ts

@@ -4,28 +4,6 @@ import { homedir } from 'os';
 import { join } from 'path';
 import * as v from 'valibot';
 
-// Schema for individual agent configuration
-const agent_config_schema = v.object({
-	model: v.pipe(
-		v.optional(v.string()),
-		v.description('Model identifier for the agent (e.g., "anthropic/claude-sonnet-4-20250514")'),
-	),
-	temperature: v.pipe(
-		v.optional(v.number()),
-		v.description('Temperature setting for the agent (e.g., 0.7)'),
-	),
-	top_p: v.pipe(
-		v.optional(v.number()),
-		v.description(
-			'Control response diversity with the top_p option. Alternative to temperature for controlling randomness.',
-		),
-	),
-	maxSteps: v.pipe(
-		v.optional(v.number()),
-		v.description('Maximum number of steps the agent can take (e.g., 10)'),
-	),
-});
-
 const default_config = {
 	mcp: {
 		type: 'remote' as 'remote' | 'local',
@@ -33,61 +11,36 @@ const default_config = {
 	},
 	subagent: {
 		enabled: true,
-		agents: {} as Record<string, v.InferInput<typeof agent_config_schema>>,
 	},
 	instructions: {
 		enabled: true,
 	},
 	skills: {
-		enabled: true as boolean | string[],
+		enabled: true,
 	},
 };
 
 export const config_schema = v.object({
-	mcp: v.pipe(
-		v.optional(
-			v.object({
-				type: v.optional(v.picklist(['remote', 'local'])),
-				enabled: v.optional(v.boolean()),
-			}),
-		),
-		v.description(
-			"Configuration for the MCP. You can chose if it should be enabled or not and the transport to use 'remote' (default) and 'local'.",
-		),
+	mcp: v.optional(
+		v.object({
+			type: v.optional(v.picklist(['remote', 'local'])),
+			enabled: v.optional(v.boolean()),
+		}),
 	),
-	subagent: v.pipe(
-		v.optional(
-			v.object({
-				enabled: v.optional(v.boolean()),
-				agents: v.optional(v.record(v.string(), agent_config_schema)),
-			}),
-		),
-		v.description('Configuration for the subagent. You can choose if it should be enabled or not.'),
+	subagent: v.optional(
+		v.object({
+			enabled: v.optional(v.boolean()),
+		}),
 	),
-	instructions: v.pipe(
-		v.optional(
-			v.object({
-				enabled: v.optional(v.boolean()),
-			}),
-		),
-		v.description(
-			'Configuration for the automatic AGENTS.md injection. You can choose if it should be enabled or not.',
-		),
+	instructions: v.optional(
+		v.object({
+			enabled: v.optional(v.boolean()),
+		}),
 	),
-	skills: v.pipe(
-		v.optional(
-			v.object({
-				enabled: v.pipe(
-					v.optional(v.union([v.boolean(), v.array(v.string())])),
-					v.description(
-						'It can be either a boolean or an array containing the skills that you want to enable',
-					),
-				),
-			}),
-		),
-		v.description(
-			'Configuration for the skills. You can choose if it they should be enabled or not, or specify an array of skill names to enable only specific skills.',
-		),
+	skills: v.optional(
+		v.object({
+			enabled: v.optional(v.boolean()),
+		}),
 	),
 });
 
@@ -159,12 +112,8 @@ function merge_with_defaults(user_config: Partial<McpConfig>): McpConfig {
 			...user_config.mcp,
 		},
 		subagent: {
-			enabled: default_config.subagent.enabled,
+			...default_config.subagent,
 			...user_config.subagent,
-			agents: {
-				...default_config.subagent.agents,
-				...user_config.subagent?.agents,
-			},
 		},
 		instructions: {
 			...default_config.instructions,
@@ -202,11 +151,7 @@ export function get_mcp_config(ctx: PluginInput) {
 			if (parsed.success) {
 				merged = {
 					mcp: { ...merged.mcp, ...parsed.output.mcp },
-					subagent: {
-						...merged.subagent,
-						...parsed.output.subagent,
-						agents: { ...merged.subagent?.agents, ...parsed.output.subagent?.agents },
-					},
+					subagent: { ...merged.subagent, ...parsed.output.subagent },
 					instructions: { ...merged.instructions, ...parsed.output.instructions },
 					skills: { ...merged.skills, ...parsed.output.skills },
 				};

packages/opencode/index.ts

@@ -2,8 +2,7 @@ import type { Plugin } from '@opencode-ai/plugin';
 import { readdir } from 'node:fs/promises';
 import { dirname, join } from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { agents } from './agents.ts';
-import { get_mcp_config } from './config.ts';
+import { get_mcp_config } from './config.js';
 
 const current_dir = dirname(fileURLToPath(import.meta.url));
 
@@ -40,77 +39,105 @@ export const svelte_plugin: Plugin = async (ctx) => {
 				input.instructions.push(...instructions_paths.map((file) => join(instructions_dir, file)));
 			}
 
-			const skills_enabled = mcp_config.skills?.enabled;
-			if (skills_enabled !== false) {
+			if (mcp_config.skills?.enabled !== false) {
 				const skills_dir = join(current_dir, 'skills');
-				if (Array.isArray(skills_enabled)) {
-					// only add specific skill directories by name
-					for (const skill_name of skills_enabled) {
-						const skill_path = join(skills_dir, skill_name);
-						// @ts-expect-error -- skills is a new opencode feature
-						input.skills.paths.push(skill_path);
-					}
-				} else {
-					// @ts-expect-error -- skills is a new opencode feature
-					input.skills.paths.push(skills_dir);
-				}
+				// @ts-expect-error -- skills is a new opencode feature
+				input.skills.paths.push(skills_dir);
 			}
 
 			// if the user doesn't have the MCP server already we add one based on config
-			if (!input.mcp[svelte_mcp_name]) {
+			if (!input.mcp[svelte_mcp_name] && mcp_config.mcp?.enabled !== false) {
 				if (mcp_config.mcp?.type === 'remote') {
 					input.mcp[svelte_mcp_name] = {
 						type: 'remote',
 						url: 'https://mcp.svelte.dev/mcp',
-						enabled: mcp_config.mcp?.enabled ?? true,
 					};
 				} else {
 					input.mcp[svelte_mcp_name] = {
 						type: 'local',
 						command: ['npx', '-y', '@sveltejs/mcp'],
-						enabled: mcp_config.mcp?.enabled ?? true,
 					};
 				}
 			}
 			if (mcp_config.subagent?.enabled !== false) {
-				for (const [agent_name, agent_data] of Object.entries(agents)) {
-					// we add the editor subagent that will be used when editing Svelte files to prevent wasting context on the main agent
-					const default_config: (typeof input.agent)[string] = {
-						color: '#ff3e00',
-						mode: 'subagent',
-						prompt: agent_data.prompt,
-						description: agent_data.description,
-						permission: {
-							bash: 'ask',
-							edit: 'allow',
-							webfetch: 'ask',
-						},
-						tools: {
-							[`${svelte_mcp_name}_*`]: true,
-						},
-					};
+				// we add the editor subagent that will be used when editing Svelte files to prevent wasting context on the main agent
+				input.agent['svelte-file-editor'] = {
+					color: '#ff3e00',
+					mode: 'subagent',
+					prompt: `You are a Svelte 5 expert responsible for writing, editing, and validating Svelte components and modules. You have access to the Svelte MCP server which provides documentation and code analysis tools. Always use the tools from the svelte MCP server to fetch documentation with \`get_documentation\` and validating the code with \`svelte_autofixer\`. If the autofixer returns any issue or suggestions try to solve them.
 
-					// Get per-agent config from svelte.json (if any)
-					const agent_config = mcp_config.subagent?.agents?.[agent_name];
+If the MCP tools are not available you can use the \`svelte-code-editor\` skill to learn how to use the \`@sveltejs/mcp\` cli to access the same tools.
 
-					// Configure agent from svelte.json only
-					// Priority: svelte.json agent config > defaults
-					input.agent[agent_name] = {
-						...default_config,
-						...(agent_config?.model !== undefined && {
-							model: agent_config.model,
-						}),
-						...(agent_config?.temperature !== undefined && {
-							temperature: agent_config.temperature,
-						}),
-						...(agent_config?.maxSteps !== undefined && {
-							maxSteps: agent_config.maxSteps,
-						}),
-						...(agent_config?.top_p !== undefined && {
-							top_p: agent_config.top_p,
-						}),
-					};
-				}
+If the skill is not available you can run \`npx @sveltejs/mcp@latest -y --help\` to learn how to use it.
+
+## Available MCP Tools
+
+### 1. list-sections
+
+Lists all available Svelte 5 and SvelteKit documentation sections with titles and paths. Use this first to discover what documentation is available.
+
+### 2. get-documentation
+
+Retrieves full documentation for specified sections. Accepts a single section name or an array of section names. Use after \`list-sections\` to fetch relevant docs for the task at hand.
+
+**Example sections:** \`$state\`, \`$derived\`, \`$effect\`, \`$props\`, \`$bindable\`, \`snippets\`, \`routing\`, \`load functions\`
+
+### 3. svelte-autofixer
+
+Analyzes Svelte code and returns suggestions to fix issues. Pass the component code directly to this tool. It will detect common mistakes like:
+
+- Using \`$effect\` instead of \`$derived\` for computations
+- Missing cleanup in effects
+- Svelte 4 syntax (\`on:click\`, \`export let\`, \`<slot>\`)
+- Missing keys in \`{#each}\` blocks
+- And more
+
+## Workflow
+
+When invoked to work on a Svelte file:
+
+### 1. Gather Context (if needed)
+
+If you're uncertain about Svelte 5 syntax or patterns, use the MCP tools:
+
+1. Call \`list-sections\` to see available documentation
+2. Call \`get-documentation\` with relevant section names
+
+### 2. Read the Target File
+
+Read the file to understand the current implementation.
+
+### 3. Make Changes
+
+Apply edits following Svelte 5 best practices:
+
+### 4. Validate Changes
+
+After editing, ALWAYS call \`svelte-autofixer\` with the updated code to check for issues.
+
+### 5. Fix Any Issues
+
+If the autofixer reports problems, fix them and re-validate until no issues remain.
+
+## Output Format
+
+After completing your work, provide:
+
+1. Summary of changes made
+2. Any issues found and fixed by the autofixer
+3. Recommendations for further improvements (if any)
+`,
+					description:
+						'Specialized Svelte 5 code editor. MUST BE USED PROACTIVELY when creating, editing, or reviewing any .svelte file or .svelte.ts/.svelte.js module and MUST use the tools from the MCP server or the `svelte-code-writer` skill if they are available. Fetches relevant documentation and validates code using the Svelte MCP server tools.',
+					permission: {
+						bash: 'ask',
+						edit: 'allow',
+						webfetch: 'ask',
+					},
+					tools: {
+						[`${svelte_mcp_name}_*`]: true,
+					},
+				};
 			}
 		},
 	};

packages/opencode/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@sveltejs/opencode",
-	"version": "0.1.8",
+	"version": "0.1.4",
 	"type": "module",
 	"license": "MIT",
 	"homepage": "https://github.com/sveltejs/ai-tools#readme",
@@ -14,16 +14,9 @@
 	"files": [
 		"index.ts",
 		"config.ts",
-		"agents.ts",
 		"instructions",
 		"skills"
 	],
-	"exports": {
-		"./server": {
-			"types": "./index.ts",
-			"import": "./index.ts"
-		}
-	},
 	"repository": {
 		"type": "git",
 		"url": "git+https://github.com/sveltejs/ai-tools.git",

packages/opencode/schema.json

@@ -14,55 +14,16 @@
 					"type": "boolean"
 				}
 			},
-			"required": [],
-			"description": "Configuration for the MCP. You can chose if it should be enabled or not and the transport to use 'remote' (default) and 'local'."
+			"required": []
 		},
 		"subagent": {
 			"type": "object",
 			"properties": {
 				"enabled": {
 					"type": "boolean"
-				},
-				"agents": {
-					"type": "object",
-					"propertyNames": {
-						"anyOf": [
-							{
-								"enum": [
-									"svelte-file-editor"
-								]
-							},
-							{
-								"type": "string"
-							}
-						]
-					},
-					"additionalProperties": {
-						"type": "object",
-						"properties": {
-							"model": {
-								"type": "string",
-								"description": "Model identifier for the agent (e.g., \"anthropic/claude-sonnet-4-20250514\")"
-							},
-							"temperature": {
-								"type": "number",
-								"description": "Temperature setting for the agent (e.g., 0.7)"
-							},
-							"top_p": {
-								"type": "number",
-								"description": "Control response diversity with the top_p option. Alternative to temperature for controlling randomness."
-							},
-							"maxSteps": {
-								"type": "number",
-								"description": "Maximum number of steps the agent can take (e.g., 10)"
-							}
-						},
-						"required": []
-					}
 				}
 			},
-			"required": [],
-			"description": "Configuration for the subagent. You can choose if it should be enabled or not."
+			"required": []
 		},
 		"instructions": {
 			"type": "object",
@@ -71,39 +32,16 @@
 					"type": "boolean"
 				}
 			},
-			"required": [],
-			"description": "Configuration for the automatic AGENTS.md injection. You can choose if it should be enabled or not."
+			"required": []
 		},
 		"skills": {
 			"type": "object",
 			"properties": {
 				"enabled": {
-					"anyOf": [
-						{
-							"type": "boolean"
-						},
-						{
-							"type": "array",
-							"items": {
-								"anyOf": [
-									{
-										"enum": [
-											"svelte-code-writer",
-											"svelte-core-bestpractices"
-										]
-									},
-									{
-										"type": "string"
-									}
-								]
-							}
-						}
-					],
-					"description": "It can be either a boolean or an array containing the skills that you want to enable"
+					"type": "boolean"
 				}
 			},
-			"required": [],
-			"description": "Configuration for the skills. You can choose if it they should be enabled or not, or specify an array of skill names to enable only specific skills."
+			"required": []
 		}
 	},
 	"required": [],

packages/opencode/scripts/generate-schema.ts

@@ -3,58 +3,6 @@ import { config_schema } from '../config.js';
 import fs from 'node:fs';
 import path from 'node:path';
 
-// Read agent names from tools/agents/*.md files
-function get_agent_names(agents_dir: string) {
-	if (!fs.existsSync(agents_dir)) return [];
-	return fs
-		.readdirSync(agents_dir, { withFileTypes: true })
-		.filter((entry) => entry.isFile() && entry.name.endsWith('.md'))
-		.map((entry) => entry.name.replace(/\.md$/, ''));
-}
-
-function get_skill_names(skills_dir: string) {
-	if (!fs.existsSync(skills_dir)) return [];
-	return fs
-		.readdirSync(skills_dir, { withFileTypes: true })
-		.filter((entry) => entry.isDirectory())
-		.map((entry) => entry.name);
-}
-
-const skills_dir = path.resolve('./skills');
-const skill_names = get_skill_names(skills_dir);
-const schema = config_schema;
-const json_schema = toJsonSchema(schema);
-
-// Post-process: inject skill name suggestions into the items schema.
-// This is the JSON Schema equivalent of `"a" | "b" | (string & {})` —
-// editors will autocomplete the known names but any string is still valid.
-if (skill_names.length > 0) {
-	// eslint-disable-next-line @typescript-eslint/no-explicit-any
-	const enabled = (json_schema as any).properties?.skills?.properties?.enabled;
-	if (enabled?.anyOf) {
-		const array_branch = enabled.anyOf.find((s: Record<string, unknown>) => s.type === 'array');
-		if (array_branch) {
-			array_branch.items = {
-				anyOf: [{ enum: skill_names }, { type: 'string' }],
-			};
-		}
-	}
-}
-
-// Post-process: inject known agent names for intellisense
-// This is the JSON Schema equivalent of `"a" | "b" | (string & {})` —
-// editors will autocomplete the known names but any string is still valid.
-const agents_dir = path.resolve('../../tools/agents');
-const agent_names = get_agent_names(agents_dir);
-
-if (agent_names.length > 0) {
-	// eslint-disable-next-line @typescript-eslint/no-explicit-any
-	const agents = (json_schema as any).properties?.subagent?.properties?.agents;
-	if (agents) {
-		agents.propertyNames = {
-			anyOf: [{ enum: agent_names }, { type: 'string' }],
-		};
-	}
-}
+const json_schema = toJsonSchema(config_schema);
 
 fs.writeFileSync(path.resolve('./schema.json'), JSON.stringify(json_schema, null, '\t'));

packages/opencode/skills/svelte-core-bestpractices/SKILL.md

@@ -134,7 +134,7 @@ The CSS in a component's `<style>` is scoped to that component. If a parent comp
 </style>
 ```
 
-If this is impossible (for example, the child component comes from a library) you can use `:global` to override styles:
+If this impossible (for example, the child component comes from a library) you can use `:global` to override styles:
 
 ```svelte
 <div>

packages/opencode/tsconfig.json

@@ -1,9 +1,5 @@
 {
 	"extends": "../../tsconfig.json",
-	"compilerOptions": {
-		"allowImportingTsExtensions": true,
-		"types": ["@types/node"]
-	},
-	"include": ["index.ts", "config.ts", "agents.ts", "scripts/*"],
+	"include": ["index.ts", "config.ts", "scripts/*"],
 	"exclude": ["node_modules"]
 }

plugins/claude/svelte/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
 	"name": "svelte",
 	"description": "A plugin for all things related to Svelte development, MCP, skills, and more.",
-	"version": "1.0.4",
+	"version": "1.0.2",
 	"author": {
 		"name": "Svelte"
 	},

plugins/claude/svelte/agents/svelte-file-editor.md

@@ -6,7 +6,7 @@ permissionMode: acceptEdits
 
 You are a Svelte 5 expert responsible for writing, editing, and validating Svelte components and modules. You have access to the Svelte MCP server which provides documentation and code analysis tools. Always use the tools from the svelte MCP server to fetch documentation with `get_documentation` and validating the code with `svelte_autofixer`. If the autofixer returns any issue or suggestions try to solve them.
 
-If the MCP tools are not available you can use the `svelte-code-writer` skill to learn how to use the `@sveltejs/mcp` cli to access the same tools.
+If the MCP tools are not available you can use the `svelte-code-editor` skill to learn how to use the `@sveltejs/mcp` cli to access the same tools.
 
 If the skill is not available you can run `npx @sveltejs/mcp@latest -y --help` to learn how to use it.
 

plugins/claude/svelte/skills/svelte-core-bestpractices/SKILL.md

@@ -134,7 +134,7 @@ The CSS in a component's `<style>` is scoped to that component. If a parent comp
 </style>
 ```
 
-If this is impossible (for example, the child component comes from a library) you can use `:global` to override styles:
+If this impossible (for example, the child component comes from a library) you can use `:global` to override styles:
 
 ```svelte
 <div>

plugins/cursor/svelte/.cursor-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
 	"name": "svelte",
 	"description": "A plugin for all things related to Svelte development, MCP, skills, and more.",
-	"version": "1.0.4",
+	"version": "1.0.2",
 	"author": {
 		"name": "Svelte"
 	},

plugins/cursor/svelte/agents/svelte-file-editor.md

@@ -5,7 +5,7 @@ description: Specialized Svelte 5 code editor. MUST BE USED PROACTIVELY when cre
 
 You are a Svelte 5 expert responsible for writing, editing, and validating Svelte components and modules. You have access to the Svelte MCP server which provides documentation and code analysis tools. Always use the tools from the svelte MCP server to fetch documentation with `get_documentation` and validating the code with `svelte_autofixer`. If the autofixer returns any issue or suggestions try to solve them.
 
-If the MCP tools are not available you can use the `svelte-code-writer` skill to learn how to use the `@sveltejs/mcp` cli to access the same tools.
+If the MCP tools are not available you can use the `svelte-code-editor` skill to learn how to use the `@sveltejs/mcp` cli to access the same tools.
 
 If the skill is not available you can run `npx @sveltejs/mcp@latest -y --help` to learn how to use it.
 

plugins/cursor/svelte/skills/svelte-core-bestpractices/SKILL.md

@@ -134,7 +134,7 @@ The CSS in a component's `<style>` is scoped to that component. If a parent comp
 </style>
 ```
 
-If this is impossible (for example, the child component comes from a library) you can use `:global` to override styles:
+If this impossible (for example, the child component comes from a library) you can use `:global` to override styles:
 
 ```svelte
 <div>

pnpm-workspace.yaml

@@ -24,6 +24,10 @@ catalogs:
     prettier-plugin-svelte: ^3.3.3
     svelte-eslint-parser: ^1.4.0
     typescript-eslint: ^8.44.0
+  orm:
+    '@libsql/client': ^0.17.0
+    drizzle-kit: ^0.31.0
+    drizzle-orm: ^0.45.0
   svelte:
     '@sveltejs/adapter-vercel': ^6.0.0
     '@sveltejs/kit': ^2.42.2
@@ -42,7 +46,7 @@ catalogs:
     '@types/estree': ^1.0.8
     '@types/node': ^24.3.1
     '@valibot/to-json-schema': ^1.5.0
-    '@vercel/analytics': ^2.0.0
+    '@vercel/analytics': ^1.5.0
     dotenv: ^17.2.3
     node-resolve-ts: ^1.0.2
     publint: ^0.3.13

scripts/sync-opencode-plugin.ts

@@ -37,77 +37,7 @@ async function sync_agents_md() {
 	console.log('Synced AGENTS.md to opencode package and documentation');
 }
 
-interface AgentData {
-	name: string;
-	description: string;
-	prompt: string;
-}
-
-/**
- * Parse a markdown agent file with frontmatter (name, description) and body (prompt)
- */
-function parse_agent_md(content: string, file_path: string): AgentData | null {
-	const frontmatter_match = content.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
-	if (!frontmatter_match) {
-		console.warn(`Skipping ${file_path}: no frontmatter found`);
-		return null;
-	}
-
-	const frontmatter = frontmatter_match[1] ?? '';
-	const body = (frontmatter_match[2] ?? '').trim();
-
-	const name = frontmatter.match(/^name:\s*(.+)$/m)?.[1]?.trim();
-	const description = frontmatter.match(/^description:\s*(.+)$/m)?.[1]?.trim();
-
-	if (!name || !description) {
-		console.warn(`Skipping ${file_path}: missing name or description in frontmatter`);
-		return null;
-	}
-
-	return { name, description, prompt: body };
-}
-
-/**
- * Generate agents.ts module from tools/agents/*.md files
- */
-async function sync_agents() {
-	const agents_dir = path.join(TOOLS_DIR, 'agents');
-	const entries = await fs.readdir(agents_dir, { withFileTypes: true });
-	const md_files = entries.filter((e) => e.isFile() && e.name.endsWith('.md'));
-
-	const agents: AgentData[] = [];
-
-	for (const file of md_files) {
-		const file_path = path.join(agents_dir, file.name);
-		const content = await fs.readFile(file_path, 'utf-8');
-		const agent = parse_agent_md(content, file_path);
-		if (agent) {
-			agents.push(agent);
-		}
-	}
-
-	const output = [
-		'// This file is auto-generated by scripts/sync-opencode-plugin.ts',
-		'// Do not edit manually — edit the markdown files in tools/agents/ instead.',
-		'',
-		`export const agents = ${JSON.stringify(
-			Object.fromEntries(
-				agents.map((a) => [a.name, { description: a.description, prompt: a.prompt }]),
-			),
-			null,
-			'\t',
-		)} as const;`,
-		'',
-	].join('\n');
-
-	const dest = path.join(OPENCODE_PKG_DIR, 'agents.ts');
-	await fs.writeFile(dest, output);
-
-	console.log(`Generated agents.ts with ${agents.length} agent(s)`);
-}
-
 await sync_skills();
 await sync_agents_md();
-await sync_agents();
 
 console.log('OpenCode plugin sync complete');

scripts/update-docs-prompts.ts

@@ -18,11 +18,9 @@ ${module.docs_description}
 <details>
 	<summary>Copy the prompt</summary>
 
-<!-- prettier-ignore-start -->
-\`\`\`\`markdown
+\`\`\`md
 ${await module.generate_for_docs()}
-\`\`\`\`
-<!-- prettier-ignore-end -->
+\`\`\`
 
 </details>
 

tools/agents/svelte-file-editor.md

@@ -5,7 +5,7 @@ description: Specialized Svelte 5 code editor. MUST BE USED PROACTIVELY when cre
 
 You are a Svelte 5 expert responsible for writing, editing, and validating Svelte components and modules. You have access to the Svelte MCP server which provides documentation and code analysis tools. Always use the tools from the svelte MCP server to fetch documentation with `get_documentation` and validating the code with `svelte_autofixer`. If the autofixer returns any issue or suggestions try to solve them.
 
-If the MCP tools are not available you can use the `svelte-code-writer` skill to learn how to use the `@sveltejs/mcp` cli to access the same tools.
+If the MCP tools are not available you can use the `svelte-code-editor` skill to learn how to use the `@sveltejs/mcp` cli to access the same tools.
 
 If the skill is not available you can run `npx @sveltejs/mcp@latest -y --help` to learn how to use it.
 

tools/skills/svelte-core-bestpractices/SKILL.md

@@ -134,7 +134,7 @@ The CSS in a component's `<style>` is scoped to that component. If a parent comp
 </style>
 ```
 
-If this is impossible (for example, the child component comes from a library) you can use `:global` to override styles:
+If this impossible (for example, the child component comes from a library) you can use `:global` to override styles:
 
 ```svelte
 <div>