@z7589xxz758/slidex-mcp-server 0.1.0 → 0.1.2

package/README.md

@@ -4,6 +4,16 @@ MCP server for SlideX MotionDoc decks. It lets MCP clients create decks, read te
 
 Current authoring syntax uses `<Slide>` with `Text`, `Icon`, `Chart`, `ImageBlock`, and `VideoBlock`. New MCP block insertion only creates the current authoring blocks.
 
+The package also includes built-in slide layout presets matching the SlideX Studio layout picker, such as Title & Photo, Title & Bullets, Agenda, Key Fact, Quote, Photos - 3 on a page, and Photo. Once installed, MCP clients can list layouts, fetch layout source, create a slide from a layout, append a layout slide, or replace an existing slide with a layout.
+
+## Quick Start
+
+Run the server directly without installing:
+
+```bash
+npx -y @z7589xxz758/slidex-mcp-server
+```
+
 ## Use With MCP Clients
 
 ```json
@@ -11,7 +21,7 @@ Current authoring syntax uses `<Slide>` with `Text`, `Icon`, `Chart`, `ImageBloc
   "mcpServers": {
     "slidex": {
       "command": "npx",
-      "args": ["-y", "slidex-mcp-server"]
+      "args": ["-y", "@z7589xxz758/slidex-mcp-server"]
     }
   }
 }
@@ -51,9 +61,45 @@ When connecting through stdio, prefer the silent npm form:
 - `slidex_update_slide_props`
 - `slidex_replace_slide`
 - `slidex_add_block`
+- `slidex_list_slide_layouts`
+- `slidex_get_slide_layout`
+- `slidex_create_slide_from_layout`
+- `slidex_add_slide_from_layout`
+- `slidex_replace_slide_with_layout`
 - `slidex_delete_slide`
 - `slidex_reorder_slide`
 - `slidex_export_html`
 - `slidex_list_block_types`
 
 `slidex_add_block` currently accepts `Text`, `Image`, `Video`, `ChartBar`, `ChartLine`, `ChartArea`, `ChartPie`, `ChartDonut`, and `Icon`.
+
+## Built-in Slide Layouts
+
+`slidex_list_slide_layouts` currently returns 16 installable layout presets:
+
+- `title`
+- `title-photo`
+- `title-alt-photo`
+- `title-bullets`
+- `bullets`
+- `title-bullets-photo`
+- `title-bullets-small-video`
+- `title-bullets-large-video`
+- `chapter`
+- `only-title`
+- `agenda`
+- `statement`
+- `key-fact`
+- `quote`
+- `photos-3`
+- `photo`
+
+Layout resources are also available at `slidex://slide-layouts` and `slidex://slide-layouts/{layoutId}`.
+
+## Dynamic Workspace Skills
+
+When the server starts, it dynamically scans the current working directory (`process.cwd()`) for a `.agents/skills` folder. If found, it reads the `SKILL.md` files and automatically registers them as:
+- **MCP Prompts**: `skill_<folder_name>` (e.g., `skill_high_end_visual_design`)
+- **MCP Resources**: `workspace://skills/<folder_name>`
+
+This allows the AI to adapt to the specific design guidelines, tones, and automated workflows of the workspace it is running in!

package/dist/server.mjs

@@ -437,8 +437,8 @@ var init_parseUtil = __esm({
     init_errors();
     init_en();
     makeIssue = (params) => {
-      const { data, path, errorMaps, issueData } = params;
-      const fullPath = [...path, ...issueData.path || []];
+      const { data, path: path2, errorMaps, issueData } = params;
+      const fullPath = [...path2, ...issueData.path || []];
       const fullIssue = {
         ...issueData,
         path: fullPath
@@ -718,11 +718,11 @@ var init_types = __esm({
     init_parseUtil();
     init_util();
     ParseInputLazyPath = class {
-      constructor(parent, value, path, key) {
+      constructor(parent, value, path2, key) {
         this._cachedPath = [];
         this.parent = parent;
         this.data = value;
-        this._path = path;
+        this._path = path2;
         this._key = key;
       }
       get path() {
@@ -4221,10 +4221,10 @@ function mergeDefs(...defs) {
 function cloneDef(schema) {
   return mergeDefs(schema._zod.def);
 }
-function getElementAtPath(obj, path) {
-  if (!path)
+function getElementAtPath(obj, path2) {
+  if (!path2)
     return obj;
-  return path.reduce((acc, key) => acc?.[key], obj);
+  return path2.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject(promisesObj) {
   const keys = Object.keys(promisesObj);
@@ -4552,11 +4552,11 @@ function explicitlyAborted(x, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues(path, issues) {
+function prefixIssues(path2, issues) {
   return issues.map((iss) => {
     var _a3;
     (_a3 = iss).path ?? (_a3.path = []);
-    iss.path.unshift(path);
+    iss.path.unshift(path2);
     return iss;
   });
 }
@@ -4773,16 +4773,16 @@ function flattenError(error51, mapper = (issue2) => issue2.message) {
 }
 function formatError(error51, mapper = (issue2) => issue2.message) {
   const fieldErrors = { _errors: [] };
-  const processError = (error52, path = []) => {
+  const processError = (error52, path2 = []) => {
     for (const issue2 of error52.issues) {
       if (issue2.code === "invalid_union" && issue2.errors.length) {
-        issue2.errors.map((issues) => processError({ issues }, [...path, ...issue2.path]));
+        issue2.errors.map((issues) => processError({ issues }, [...path2, ...issue2.path]));
       } else if (issue2.code === "invalid_key") {
-        processError({ issues: issue2.issues }, [...path, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path2, ...issue2.path]);
       } else if (issue2.code === "invalid_element") {
-        processError({ issues: issue2.issues }, [...path, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path2, ...issue2.path]);
       } else {
-        const fullpath = [...path, ...issue2.path];
+        const fullpath = [...path2, ...issue2.path];
         if (fullpath.length === 0) {
           fieldErrors._errors.push(mapper(issue2));
         } else {
@@ -4809,17 +4809,17 @@ function formatError(error51, mapper = (issue2) => issue2.message) {
 }
 function treeifyError(error51, mapper = (issue2) => issue2.message) {
   const result = { errors: [] };
-  const processError = (error52, path = []) => {
+  const processError = (error52, path2 = []) => {
     var _a3, _b;
     for (const issue2 of error52.issues) {
       if (issue2.code === "invalid_union" && issue2.errors.length) {
-        issue2.errors.map((issues) => processError({ issues }, [...path, ...issue2.path]));
+        issue2.errors.map((issues) => processError({ issues }, [...path2, ...issue2.path]));
       } else if (issue2.code === "invalid_key") {
-        processError({ issues: issue2.issues }, [...path, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path2, ...issue2.path]);
       } else if (issue2.code === "invalid_element") {
-        processError({ issues: issue2.issues }, [...path, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path2, ...issue2.path]);
       } else {
-        const fullpath = [...path, ...issue2.path];
+        const fullpath = [...path2, ...issue2.path];
         if (fullpath.length === 0) {
           result.errors.push(mapper(issue2));
           continue;
@@ -4851,8 +4851,8 @@ function treeifyError(error51, mapper = (issue2) => issue2.message) {
 }
 function toDotPath(_path) {
   const segs = [];
-  const path = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
-  for (const seg of path) {
+  const path2 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
+  for (const seg of path2) {
     if (typeof seg === "number")
       segs.push(`[${seg}]`);
     else if (typeof seg === "symbol")
@@ -18532,13 +18532,13 @@ function resolveRef(ref, ctx) {
   if (!ref.startsWith("#")) {
     throw new Error("External $ref is not supported, only local refs (#/...) are allowed");
   }
-  const path = ref.slice(1).split("/").filter(Boolean);
-  if (path.length === 0) {
+  const path2 = ref.slice(1).split("/").filter(Boolean);
+  if (path2.length === 0) {
     return ctx.rootSchema;
   }
   const defsKey = ctx.version === "draft-2020-12" ? "$defs" : "definitions";
-  if (path[0] === defsKey) {
-    const key = path[1];
+  if (path2[0] === defsKey) {
+    const key = path2[1];
     if (!key || !ctx.defs[key]) {
       throw new Error(`Reference not found: ${ref}`);
     }
@@ -26638,8 +26638,8 @@ var require_utils = __commonJS({
       }
       return ind;
     }
-    function removeDotSegments(path) {
-      let input = path;
+    function removeDotSegments(path2) {
+      let input = path2;
       const output = [];
       let nextSlash = -1;
       let len = 0;
@@ -26891,8 +26891,8 @@ var require_schemes = __commonJS({
         wsComponent.secure = void 0;
       }
       if (wsComponent.resourceName) {
-        const [path, query] = wsComponent.resourceName.split("?");
-        wsComponent.path = path && path !== "/" ? path : void 0;
+        const [path2, query] = wsComponent.resourceName.split("?");
+        wsComponent.path = path2 && path2 !== "/" ? path2 : void 0;
         wsComponent.query = query;
         wsComponent.resourceName = void 0;
       }
@@ -35980,12 +35980,12 @@ var require_dist = __commonJS({
         throw new Error(`Unknown format "${name}"`);
       return f;
     };
-    function addFormats(ajv, list, fs, exportName) {
+    function addFormats(ajv, list, fs2, exportName) {
       var _a3;
       var _b;
       (_a3 = (_b = ajv.opts.code).formats) !== null && _a3 !== void 0 ? _a3 : _b.formats = (0, codegen_1._)`require("ajv-formats/dist/formats").${exportName}`;
       for (const f of list)
-        ajv.addFormat(f, fs[f]);
+        ajv.addFormat(f, fs2[f]);
     }
     module.exports = exports = formatsPlugin;
     Object.defineProperty(exports, "__esModule", { value: true });
@@ -40852,8 +40852,8 @@ function renderLucideIcon(name, strokeWidth = 2) {
   if (!isSlideXIconName(name)) {
     return "";
   }
-  const children = lucideIconPaths[name].map((path) => {
-    const [shape, ...parts] = path.split(" ");
+  const children = lucideIconPaths[name].map((path2) => {
+    const [shape, ...parts] = path2.split(" ");
     if (shape === "circle") {
       return `<circle cx="${parts[0]}" cy="${parts[1]}" r="${parts[2]}" />`;
     }
@@ -40863,7 +40863,7 @@ function renderLucideIcon(name, strokeWidth = 2) {
     if (shape === "rect") {
       return `<rect x="${parts[0]}" y="${parts[1]}" width="${parts[2]}" height="${parts[3]}" rx="${parts[4]}" ry="${parts[5]}" />`;
     }
-    return `<path d="${escapeAttribute(shape === "path" ? parts.join(" ") : path)}" />`;
+    return `<path d="${escapeAttribute(shape === "path" ? parts.join(" ") : path2)}" />`;
   }).join("");
   return `<svg aria-hidden="true" fill="none" stroke="currentColor" stroke-linecap="round" stroke-linejoin="round" stroke-width="${strokeWidth}" viewBox="0 0 24 24">${children}</svg>`;
 }
@@ -42031,7 +42031,446 @@ var init_templates = __esm({
   }
 });
 
+// core/motion-doc/presets/templates/slideLayouts.ts
+var slideLayouts;
+var init_slideLayouts = __esm({
+  "core/motion-doc/presets/templates/slideLayouts.ts"() {
+    slideLayouts = [
+      {
+        id: "title",
+        name: "Title, Body & Author",
+        source: `<Text fontSize={80} fontWeight={800} enter="fadeUp" x={8} y={25} w={84} h={15}>Presentation Title</Text>
+<Text fontSize={24} lineHeight={1.6} fontWeight={400} enter="fadeUp" delay={0.1} x={8} y={43} w={65} h={15}>Write a short paragraph to introduce the main topic or provide a brief overview of your presentation.</Text>
+<Text fontSize={18} fontWeight={600} enter="fadeUp" delay={0.2} x={8} y={82} w={40} h={10}>Author Name</Text>`
+      },
+      {
+        id: "title-photo",
+        name: "Title & Photo",
+        source: `<Text fontSize={72} fontWeight={800} enter="slideRight" x={8} y={40} w={40} h={20}>Title</Text>
+<ImageBlock src="https://images.unsplash.com/photo-1551434678-e076c223a692?auto=format&fit=crop&q=80&w=1200" alt="Photo" x={50} y={10} w={42} h={80} fit="cover" radius={24} enter="fadeIn" />`
+      },
+      {
+        id: "title-alt-photo",
+        name: "Title & Alternate Photo",
+        source: `<ImageBlock src="https://images.unsplash.com/photo-1518005020951-eccb494ad742?auto=format&fit=crop&q=80&w=1200" alt="Alternate Photo" x={8} y={10} w={42} h={80} fit="cover" radius={24} enter="fadeIn" />
+<Text fontSize={72} fontWeight={800} enter="slideLeft" x={54} y={40} w={40} h={20}>Title</Text>`
+      },
+      {
+        id: "title-bullets",
+        name: "Title & Bullets",
+        source: `<Text fontSize={54} fontWeight={700} enter="slideLeft" x={8} y={10} w={84} h={15}>Title</Text>
+<Text listType="bullet" fontSize={24} lineHeight={1.8} enter="fadeUp" x={8} y={30} w={84} h={60}>\u2022 First point
+\u2022 Second point
+\u2022 Third point</Text>`
+      },
+      {
+        id: "bullets",
+        name: "Bullets",
+        source: `<Text listType="bullet" fontSize={28} lineHeight={1.8} enter="fadeUp" x={10} y={20} w={80} h={60}>\u2022 First point
+\u2022 Second point
+\u2022 Third point</Text>`
+      },
+      {
+        id: "title-bullets-photo",
+        name: "Title, Bullets & Photo",
+        source: `<Text fontSize={54} fontWeight={700} enter="slideLeft" x={8} y={10} w={84} h={15}>Title</Text>
+<Text listType="bullet" fontSize={20} lineHeight={1.6} enter="fadeUp" x={8} y={30} w={40} h={60}>\u2022 First point
+\u2022 Second point</Text>
+<ImageBlock src="https://images.unsplash.com/photo-1518005020951-eccb494ad742?auto=format&fit=crop&q=80&w=1200" alt="Photo" x={52} y={30} w={40} h={60} fit="cover" radius={24} enter="fadeIn" />`
+      },
+      {
+        id: "title-bullets-small-video",
+        name: "Title, Bullets & Small Live Video",
+        source: `<Text fontSize={54} fontWeight={700} enter="slideLeft" x={8} y={10} w={84} h={15}>Title</Text>
+<Text listType="bullet" fontSize={20} lineHeight={1.6} enter="fadeUp" x={8} y={30} w={40} h={60}>\u2022 First point
+\u2022 Second point</Text>
+<VideoBlock src="https://www.w3schools.com/html/mov_bbb.mp4" controls="true" x={52} y={30} w={40} h={40} fit="cover" radius={24} enter="fadeIn" />`
+      },
+      {
+        id: "title-bullets-large-video",
+        name: "Title, Bullets & Large Live Video",
+        source: `<Text fontSize={54} fontWeight={700} enter="slideLeft" x={8} y={10} w={84} h={15}>Title</Text>
+<Text listType="bullet" fontSize={20} lineHeight={1.6} enter="fadeUp" x={8} y={30} w={30} h={60}>\u2022 First point
+\u2022 Second point</Text>
+<VideoBlock src="https://www.w3schools.com/html/mov_bbb.mp4" controls="true" x={42} y={25} w={50} h={65} fit="cover" radius={24} enter="fadeIn" />`
+      },
+      {
+        id: "chapter",
+        name: "Chapter",
+        source: `<Text fontSize={96} fontWeight={800} enter="zoomIn" x={10} y={40} w={80} h={20} textAlign="center" textVerticalAlign="middle">Chapter</Text>`
+      },
+      {
+        id: "only-title",
+        name: "Only Title",
+        source: `<Text fontSize={64} fontWeight={800} enter="slideLeft" x={8} y={40} w={84} h={20}>Title</Text>`
+      },
+      {
+        id: "agenda",
+        name: "Agenda",
+        source: `<Text fontSize={54} fontWeight={700} enter="slideLeft" x={8} y={10} w={84} h={15}>Agenda</Text>
+<Text listType="bullet" fontSize={24} lineHeight={2} enter="fadeUp" x={8} y={30} w={40} h={60}>\u2022 09:00 - Keynote
+\u2022 10:30 - Strategy
+\u2022 13:00 - Workshop</Text>`
+      },
+      {
+        id: "statement",
+        name: "Statement",
+        source: `<Text fontSize={48} fontWeight={700} lineHeight={1.4} enter="fadeUp" x={15} y={35} w={70} h={30} textAlign="center">A clear, bold statement that captures attention and delivers the core message.</Text>`
+      },
+      {
+        id: "key-fact",
+        name: "Key Fact",
+        source: `<Text fontSize={120} fontWeight={900} enter="zoomIn" x={10} y={30} w={80} h={25} textAlign="center">100%</Text>
+<Text fontSize={24} fontWeight={500} enter="fadeUp" delay={0.2} x={10} y={60} w={80} h={10} textAlign="center">Key Fact</Text>`
+      },
+      {
+        id: "quote",
+        name: "Quote",
+        source: `<Text fontSize={60} fontWeight={600} lineHeight={1.3} enter="fadeUp" x={15} y={30} w={70} h={30}>"A profound quote goes here."</Text>
+<Text fontSize={20} fontWeight={400} enter="fadeUp" delay={0.2} x={15} y={65} w={70} h={10}>\u2014 Author</Text>`
+      },
+      {
+        id: "photos-3",
+        name: "Photos - 3 on a page",
+        source: `<ImageBlock src="https://images.unsplash.com/photo-1551434678-e076c223a692?auto=format&fit=crop&q=80&w=800" alt="Photo 1" x={8} y={10} w={40} h={80} fit="cover" radius={24} enter="fadeIn" />
+<ImageBlock src="https://images.unsplash.com/photo-1518005020951-eccb494ad742?auto=format&fit=crop&q=80&w=800" alt="Photo 2" x={52} y={10} w={40} h={38} fit="cover" radius={24} enter="fadeIn" delay={0.1} />
+<ImageBlock src="https://images.unsplash.com/photo-1498050108023-c5249f4df085?auto=format&fit=crop&q=80&w=800" alt="Photo 3" x={52} y={52} w={40} h={38} fit="cover" radius={24} enter="fadeIn" delay={0.2} />`
+      },
+      {
+        id: "photo",
+        name: "Photo",
+        source: `<ImageBlock src="https://images.unsplash.com/photo-1498050108023-c5249f4df085?auto=format&fit=crop&q=80&w=1200" alt="Full Photo" x={0} y={0} w={100} h={100} fit="cover" radius={0} enter="fadeIn" />`
+      },
+      {
+        id: "blank",
+        name: "Blank",
+        source: ``
+      }
+    ];
+  }
+});
+
+// mcp/slideLayoutMcp.ts
+function registerSlideLayoutMcp(server) {
+  registerSlideLayoutResources(server);
+  registerSlideLayoutTools(server);
+}
+function registerSlideLayoutResources(server) {
+  server.registerResource(
+    "slidex-slide-layout-index",
+    "slidex://slide-layouts",
+    {
+      description: "Built-in SlideX slide layout presets.",
+      mimeType: "application/json",
+      title: "SlideX Slide Layouts"
+    },
+    (uri) => ({
+      contents: [
+        {
+          mimeType: "application/json",
+          text: toJson(listSlideLayoutSummaries(false)),
+          uri: uri.href
+        }
+      ]
+    })
+  );
+  server.registerResource(
+    "slidex-slide-layout-source",
+    new ResourceTemplate("slidex://slide-layouts/{layoutId}", {
+      complete: {
+        layoutId: (value) => publicSlideLayouts.map((layout) => layout.id).filter((layoutId) => layoutId.startsWith(value))
+      },
+      list: () => ({
+        resources: publicSlideLayouts.map((layout) => ({
+          description: `Slide layout preset: ${layout.name}.`,
+          mimeType: "text/markdown",
+          name: layout.id,
+          title: layout.name,
+          uri: `slidex://slide-layouts/${layout.id}`
+        }))
+      })
+    }),
+    {
+      description: "Built-in SlideX slide layout source by id.",
+      mimeType: "text/markdown",
+      title: "SlideX Slide Layout Source"
+    },
+    (uri, variables) => {
+      const layoutId = Array.isArray(variables.layoutId) ? variables.layoutId[0] : variables.layoutId;
+      const layout = getSlideLayoutOrThrow(layoutId);
+      return {
+        contents: [
+          {
+            mimeType: "text/markdown",
+            text: layout.source,
+            uri: uri.href
+          }
+        ]
+      };
+    }
+  );
+}
+function registerSlideLayoutTools(server) {
+  server.registerTool(
+    "slidex_list_slide_layouts",
+    {
+      title: "List Slide Layouts",
+      description: "List the built-in slide layout presets available to create or insert slides.",
+      inputSchema: {
+        includeSource: external_exports.boolean().default(false)
+      }
+    },
+    ({ includeSource }) => jsonResult(listSlideLayoutSummaries(includeSource))
+  );
+  server.registerTool(
+    "slidex_get_slide_layout",
+    {
+      title: "Get Slide Layout",
+      description: "Return one built-in slide layout preset and its MDX block source.",
+      inputSchema: {
+        includeSource: external_exports.boolean().default(true),
+        layoutId: external_exports.string().describe("Layout id from slidex_list_slide_layouts.")
+      }
+    },
+    ({ includeSource, layoutId }) => runTool(() => formatSlideLayout(getSlideLayoutOrThrow(layoutId), includeSource))
+  );
+  server.registerTool(
+    "slidex_create_slide_from_layout",
+    {
+      title: "Create Slide From Layout",
+      description: "Create a complete <Slide>...</Slide> source block from a built-in layout.",
+      inputSchema: {
+        layoutId: external_exports.string().describe("Layout id from slidex_list_slide_layouts."),
+        ...layoutSlideOptionsSchema
+      }
+    },
+    ({ layoutId, ...options }) => runTool(() => {
+      const layout = getSlideLayoutOrThrow(layoutId);
+      const slideSource = createSlideSourceFromLayout(layout, void 0, options);
+      return {
+        layout: formatSlideLayout(layout, false),
+        slideSource,
+        summary: summarizeMotionDoc(`# Layout Preview
+
+${slideSource}`)
+      };
+    })
+  );
+  server.registerTool(
+    "slidex_add_slide_from_layout",
+    {
+      title: "Add Slide From Layout",
+      description: "Append or insert a new slide generated from a built-in layout.",
+      inputSchema: {
+        afterSlideIndex: external_exports.number().int().min(0).optional().describe("Insert after this slide index. Omit to append at the end."),
+        layoutId: external_exports.string().describe("Layout id from slidex_list_slide_layouts."),
+        source: external_exports.string().describe("Existing SlideX MotionDoc MDX source."),
+        ...layoutSlideOptionsSchema
+      }
+    },
+    ({ afterSlideIndex, layoutId, source, ...options }) => runTool(() => {
+      const layout = getSlideLayoutOrThrow(layoutId);
+      const nextSource = addSlideFromLayout(source, layout, afterSlideIndex, options);
+      return {
+        layout: formatSlideLayout(layout, false),
+        source: nextSource,
+        summary: summarizeMotionDoc(nextSource)
+      };
+    })
+  );
+  server.registerTool(
+    "slidex_replace_slide_with_layout",
+    {
+      title: "Replace Slide With Layout",
+      description: "Replace one slide with a new slide generated from a built-in layout.",
+      inputSchema: {
+        layoutId: external_exports.string().describe("Layout id from slidex_list_slide_layouts."),
+        slideIndex: external_exports.number().int().min(0),
+        source: external_exports.string().describe("Existing SlideX MotionDoc MDX source."),
+        ...layoutSlideOptionsSchema
+      }
+    },
+    ({ layoutId, slideIndex, source, ...options }) => runTool(() => {
+      const layout = getSlideLayoutOrThrow(layoutId);
+      const document = parseMotionDoc(source);
+      const referenceSlide = getSlideOrThrow2(document.scenes, slideIndex);
+      const slideSource = createSlideSourceFromLayout(layout, referenceSlide, options, {
+        preserveReferenceDuration: true
+      });
+      const nextSource = replaceSlideContent(source, slideIndex, slideSource);
+      return {
+        layout: formatSlideLayout(layout, false),
+        source: nextSource,
+        summary: summarizeMotionDoc(nextSource)
+      };
+    })
+  );
+}
+function listSlideLayoutSummaries(includeSource) {
+  return {
+    count: publicSlideLayouts.length,
+    layouts: publicSlideLayouts.map((layout) => formatSlideLayout(layout, includeSource))
+  };
+}
+function formatSlideLayout(layout, includeSource) {
+  return {
+    id: layout.id,
+    name: layout.name,
+    source: includeSource ? layout.source : void 0
+  };
+}
+function getSlideLayoutOrThrow(layoutId) {
+  const layout = publicSlideLayouts.find((item) => item.id === layoutId);
+  if (!layout) {
+    throw new Error(
+      `Unknown layoutId: ${layoutId ?? "(missing)"}. Available layouts: ${publicSlideLayouts.map((item) => item.id).join(", ")}.`
+    );
+  }
+  return layout;
+}
+function addSlideFromLayout(source, layout, afterSlideIndex, options) {
+  const document = parseMotionDoc(source);
+  const referenceIndex = afterSlideIndex ?? document.scenes.length - 1;
+  const referenceSlide = document.scenes[referenceIndex];
+  const slideSource = createSlideSourceFromLayout(layout, referenceSlide, options);
+  const normalizedSource = source.trim() || "# Untitled Deck";
+  if (afterSlideIndex === void 0) {
+    return `${normalizedSource.trimEnd()}
+
+${slideSource}`;
+  }
+  if (!referenceSlide) {
+    throw new Error(`afterSlideIndex ${afterSlideIndex} is outside the slide range.`);
+  }
+  const pattern = /<(Slide|Scene)\b[^>]*>[\s\S]*?<\/\1>/g;
+  let currentIndex = 0;
+  for (const match of normalizedSource.matchAll(pattern)) {
+    if (currentIndex === afterSlideIndex && match.index !== void 0) {
+      const insertAt = match.index + match[0].length;
+      return `${normalizedSource.slice(0, insertAt)}
+
+${slideSource}${normalizedSource.slice(insertAt)}`;
+    }
+    currentIndex += 1;
+  }
+  throw new Error(`afterSlideIndex ${afterSlideIndex} is outside the slide range.`);
+}
+function createSlideSourceFromLayout(layout, referenceSlide, options, behavior = {}) {
+  const slideProps = buildSlideProps(referenceSlide, options, behavior);
+  const layoutSource = applyLayoutReplacements(layout.source, options.replacements);
+  return `${formatSlideTag2(slideProps)}
+${indentLayoutSource(layoutSource)}
+</Slide>`;
+}
+function buildSlideProps(referenceSlide, options, behavior) {
+  const referenceProps = referenceSlide?.props ?? {};
+  const duration3 = options.duration ?? (behavior.preserveReferenceDuration ? numberProp3(referenceProps.duration) ?? referenceSlide?.duration : void 0) ?? 5;
+  const theme = options.theme ?? stringProp3(referenceProps.theme) ?? "dark";
+  const background = options.background ?? stringProp3(referenceProps.background) ?? (theme === "light" ? "#f7f7f2" : "#050505");
+  const accent = options.accent ?? stringProp3(referenceProps.accent) ?? (theme === "light" ? "#111111" : "#ffffff");
+  const textColor = options.textColor ?? stringProp3(referenceProps.textColor);
+  return {
+    accent,
+    background,
+    duration: duration3,
+    ...textColor ? { textColor } : {},
+    theme
+  };
+}
+function getSlideOrThrow2(slides, slideIndex) {
+  const slide2 = slides[slideIndex];
+  if (!slide2) {
+    throw new Error(`slideIndex ${slideIndex} is outside the slide range.`);
+  }
+  return slide2;
+}
+function applyLayoutReplacements(source, replacements) {
+  if (!replacements) return source;
+  return Object.entries(replacements).reduce((currentSource, [from, to]) => {
+    if (!from) return currentSource;
+    return currentSource.split(from).join(safeMdxText2(to));
+  }, source);
+}
+function indentLayoutSource(source) {
+  if (!source.trim()) return "";
+  return source.split("\n").map((line) => line.trim() ? `  ${line}` : line).join("\n");
+}
+function formatSlideTag2(props) {
+  const duration3 = numberProp3(props.duration) ?? 5;
+  const entries = Object.entries(props).filter(([key]) => key !== "duration");
+  const attrs = entries.map(
+    ([key, value]) => typeof value === "number" ? `${key}={${value}}` : `${key}="${safeMdxAttribute2(value)}"`
+  ).join(" ");
+  return `<Slide duration={${duration3}}${attrs ? ` ${attrs}` : ""}>`;
+}
+function stringProp3(value) {
+  return typeof value === "string" && value ? value : void 0;
+}
+function numberProp3(value) {
+  return typeof value === "number" && Number.isFinite(value) ? value : void 0;
+}
+function safeMdxText2(value) {
+  return value.replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+function safeMdxAttribute2(value) {
+  return safeMdxText2(value).replace(/"/g, "&quot;");
+}
+function runTool(callback) {
+  try {
+    return jsonResult(callback());
+  } catch (error51) {
+    return {
+      content: [
+        {
+          type: "text",
+          text: error51 instanceof Error ? error51.message : String(error51)
+        }
+      ],
+      isError: true
+    };
+  }
+}
+function jsonResult(data) {
+  return {
+    content: [
+      {
+        type: "text",
+        text: toJson(data)
+      }
+    ],
+    structuredContent: {
+      result: data
+    }
+  };
+}
+function toJson(value) {
+  return JSON.stringify(value, null, 2);
+}
+var publicSlideLayouts, layoutSlideOptionsSchema;
+var init_slideLayoutMcp = __esm({
+  "mcp/slideLayoutMcp.ts"() {
+    "use strict";
+    init_mcp();
+    init_v4();
+    init_motionDocSerialize();
+    init_motionDocAutomation();
+    init_motionDocParser();
+    init_slideLayouts();
+    publicSlideLayouts = slideLayouts.filter((layout) => layout.id !== "blank");
+    layoutSlideOptionsSchema = {
+      accent: external_exports.string().optional(),
+      background: external_exports.string().optional(),
+      duration: external_exports.number().positive().optional(),
+      replacements: external_exports.record(external_exports.string(), external_exports.string()).optional().describe("Optional exact text replacements applied to the layout source."),
+      textColor: external_exports.string().optional(),
+      theme: external_exports.enum(["dark", "light"]).optional()
+    };
+  }
+});
+
 // mcp/server.ts
+import fs from "node:fs";
+import path from "node:path";
 var require_server = __commonJS({
   "mcp/server.ts"() {
     init_mcp();
@@ -42041,6 +42480,7 @@ var require_server = __commonJS({
     init_motionDocExport();
     init_defaultMdx();
     init_templates();
+    init_slideLayoutMcp();
     var server = new McpServer({
       name: "slidex-motion-doc",
       version: "2.0.4"
@@ -42059,6 +42499,8 @@ var require_server = __commonJS({
     registerResources();
     registerPrompts();
     registerTools();
+    registerSlideLayoutMcp(server);
+    registerWorkspaceSkills();
     main().catch((error51) => {
       console.error(error51 instanceof Error ? error51.stack ?? error51.message : String(error51));
       process.exitCode = 1;
@@ -42077,7 +42519,7 @@ var require_server = __commonJS({
             source: external_exports.string().describe("SlideX MotionDoc MDX source.")
           }
         },
-        ({ source }) => runTool(() => summarizeMotionDoc(source))
+        ({ source }) => runTool2(() => summarizeMotionDoc(source))
       );
       server.registerTool(
         "slidex_validate_motion_doc",
@@ -42088,7 +42530,7 @@ var require_server = __commonJS({
             source: external_exports.string().describe("SlideX MotionDoc MDX source.")
           }
         },
-        ({ source }) => runTool(() => summarizeMotionDoc(source).validation)
+        ({ source }) => runTool2(() => summarizeMotionDoc(source).validation)
       );
       server.registerTool(
         "slidex_list_templates",
@@ -42099,7 +42541,7 @@ var require_server = __commonJS({
             category: external_exports.string().optional().describe("Optional category filter.")
           }
         },
-        ({ category }) => runTool(() => listTemplateSummaries(category))
+        ({ category }) => runTool2(() => listTemplateSummaries(category))
       );
       server.registerTool(
         "slidex_get_template",
@@ -42111,7 +42553,7 @@ var require_server = __commonJS({
             templateId: external_exports.string().optional().describe("Template id. Defaults to the first template.")
           }
         },
-        ({ includeSource, templateId }) => runTool(() => formatTemplate(getTemplateOrDefault(templateId), includeSource))
+        ({ includeSource, templateId }) => runTool2(() => formatTemplate(getTemplateOrDefault(templateId), includeSource))
       );
       server.registerTool(
         "slidex_create_deck",
@@ -42133,7 +42575,7 @@ var require_server = __commonJS({
             title: external_exports.string()
           }
         },
-        (args) => runTool(() => createMotionDocFromOutline(args))
+        (args) => runTool2(() => createMotionDocFromOutline(args))
       );
       server.registerTool(
         "slidex_create_from_template",
@@ -42146,7 +42588,7 @@ var require_server = __commonJS({
             title: external_exports.string().optional()
           }
         },
-        ({ replacements, templateId, title }) => runTool(() => {
+        ({ replacements, templateId, title }) => runTool2(() => {
           const template = getTemplateOrDefault(templateId);
           const titled = title ? applyMotionDocTitle(template.source, title) : { source: template.source };
           const replaced = replacements ? applyMotionDocTextReplacements(titled.source, replacements) : { source: titled.source, summary: summarizeMotionDoc(titled.source) };
@@ -42168,7 +42610,7 @@ var require_server = __commonJS({
             source: external_exports.string()
           }
         },
-        ({ props, slideIndex, source }) => runTool(() => updateMotionDocSlideProps(source, slideIndex, props))
+        ({ props, slideIndex, source }) => runTool2(() => updateMotionDocSlideProps(source, slideIndex, props))
       );
       server.registerTool(
         "slidex_replace_slide",
@@ -42181,7 +42623,7 @@ var require_server = __commonJS({
             source: external_exports.string()
           }
         },
-        ({ slideIndex, slideSource, source }) => runTool(() => replaceMotionDocSlide(source, slideIndex, slideSource))
+        ({ slideIndex, slideSource, source }) => runTool2(() => replaceMotionDocSlide(source, slideIndex, slideSource))
       );
       server.registerTool(
         "slidex_add_block",
@@ -42197,7 +42639,7 @@ var require_server = __commonJS({
             type: external_exports.enum(motionDocAddBlockTypes)
           }
         },
-        ({ position, props, slideIndex, source, text: text2, type }) => runTool(() => addMotionDocBlock(source, slideIndex, type, { position, props, text: text2 }))
+        ({ position, props, slideIndex, source, text: text2, type }) => runTool2(() => addMotionDocBlock(source, slideIndex, type, { position, props, text: text2 }))
       );
       server.registerTool(
         "slidex_delete_slide",
@@ -42209,7 +42651,7 @@ var require_server = __commonJS({
             source: external_exports.string()
           }
         },
-        ({ slideIndex, source }) => runTool(() => deleteMotionDocSlide(source, slideIndex))
+        ({ slideIndex, source }) => runTool2(() => deleteMotionDocSlide(source, slideIndex))
       );
       server.registerTool(
         "slidex_reorder_slide",
@@ -42222,7 +42664,7 @@ var require_server = __commonJS({
             toIndex: external_exports.number().int().min(0)
           }
         },
-        ({ fromIndex, source, toIndex }) => runTool(() => reorderMotionDocSlide(source, fromIndex, toIndex))
+        ({ fromIndex, source, toIndex }) => runTool2(() => reorderMotionDocSlide(source, fromIndex, toIndex))
       );
       server.registerTool(
         "slidex_export_html",
@@ -42234,7 +42676,7 @@ var require_server = __commonJS({
             title: external_exports.string().optional()
           }
         },
-        ({ source, title }) => runTool(() => ({
+        ({ source, title }) => runTool2(() => ({
           html: buildMotionDocHtml(source, title),
           summary: summarizeMotionDoc(source)
         }))
@@ -42245,7 +42687,7 @@ var require_server = __commonJS({
           title: "List Block Types",
           description: "List block type names accepted by slidex_add_block."
         },
-        () => runTool(() => ({ blockTypes: motionDocAddBlockTypes }))
+        () => runTool2(() => ({ blockTypes: motionDocAddBlockTypes }))
       );
     }
     function registerResources() {
@@ -42261,7 +42703,7 @@ var require_server = __commonJS({
           contents: [
             {
               mimeType: "application/json",
-              text: toJson(listTemplateSummaries()),
+              text: toJson2(listTemplateSummaries()),
               uri: uri.href
             }
           ]
@@ -42353,9 +42795,81 @@ var require_server = __commonJS({
         })
       );
     }
-    function runTool(callback) {
+    function registerWorkspaceSkills() {
+      const skillsDir = path.join(process.cwd(), ".agents", "skills");
+      if (!fs.existsSync(skillsDir)) return;
+      let skillDirs = [];
+      try {
+        const entries = fs.readdirSync(skillsDir, { withFileTypes: true });
+        skillDirs = entries.filter((e) => e.isDirectory()).map((e) => e.name);
+      } catch {
+        return;
+      }
+      for (const dirName of skillDirs) {
+        const skillFilePath = path.join(skillsDir, dirName, "SKILL.md");
+        if (!fs.existsSync(skillFilePath)) continue;
+        try {
+          const content = fs.readFileSync(skillFilePath, "utf8");
+          let name = dirName;
+          let description = `Skill: ${dirName}`;
+          const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---/);
+          if (frontmatterMatch) {
+            const yaml = frontmatterMatch[1];
+            const nameMatch = yaml.match(/^name:\s*(.+)$/m);
+            const descMatch = yaml.match(/^description:\s*(.+)$/m);
+            if (nameMatch) name = nameMatch[1].trim();
+            if (descMatch) description = descMatch[1].trim();
+          }
+          server.registerResource(
+            `skill-${dirName}`,
+            `workspace://skills/${dirName}`,
+            {
+              description,
+              mimeType: "text/markdown",
+              title: name
+            },
+            (uri) => ({
+              contents: [
+                {
+                  mimeType: "text/markdown",
+                  text: content,
+                  uri: uri.href
+                }
+              ]
+            })
+          );
+          server.registerPrompt(
+            `skill_${dirName.replace(/[^a-zA-Z0-9_]/g, "_")}`,
+            {
+              description,
+              title: name,
+              argsSchema: {
+                request: external_exports.string().optional().describe("The user's specific request to apply this skill to.")
+              }
+            },
+            (args) => {
+              const requestText = args?.request ? `\\n\\nUser Request: ${args.request}` : "";
+              return {
+                description: `Apply the ${name} skill.`,
+                messages: [
+                  {
+                    role: "user",
+                    content: {
+                      type: "text",
+                      text: `Please apply the following skill guidelines/workflows to the task.\\n\\nSkill Definition:\\n${content}${requestText}`
+                    }
+                  }
+                ]
+              };
+            }
+          );
+        } catch {
+        }
+      }
+    }
+    function runTool2(callback) {
       try {
-        return jsonResult(callback());
+        return jsonResult2(callback());
       } catch (error51) {
         return {
           content: [
@@ -42368,12 +42882,12 @@ var require_server = __commonJS({
         };
       }
     }
-    function jsonResult(data) {
+    function jsonResult2(data) {
       return {
         content: [
           {
             type: "text",
-            text: toJson(data)
+            text: toJson2(data)
           }
         ],
         structuredContent: {
@@ -42417,7 +42931,7 @@ var require_server = __commonJS({
         useCase: template.useCase
       };
     }
-    function toJson(value) {
+    function toJson2(value) {
       return JSON.stringify(value, null, 2);
     }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@z7589xxz758/slidex-mcp-server",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "MCP server for creating, validating, editing, and exporting SlideX MotionDoc decks.",
   "type": "module",
   "bin": {