add skills to docs (#576)

docs/src/lib/docs-navigation.ts

@@ -15,6 +15,7 @@ export const navigation: NavSection[] = [
       { name: "Introduction", href: "/" },
       { name: "Installation", href: "/installation" },
       { name: "Quick Start", href: "/quick-start" },
+      { name: "Skills", href: "/skills" },
     ],
   },
   {

docs/src/lib/mdx-to-markdown.ts

@@ -1,11 +1,8 @@
 /**
  * Converts raw MDX content to clean Markdown suitable for AI agents.
  *
- * Transformations:
- * - Remove `export` statements (metadata, etc.)
- * - Remove `import` statements
- * - Strip standalone JSX divs with className attributes
- * - Pass everything else through as-is (already valid Markdown)
+ * Strips export/import statements and standalone JSX divs with className
+ * attributes, passing everything else through as valid Markdown.
  */
 export function mdxToCleanMarkdown(raw: string): string {
   const lines = raw.split("\n");
@@ -16,12 +13,10 @@ export function mdxToCleanMarkdown(raw: string): string {
   for (const line of lines) {
     const trimmed = line.trim();
 
-    // Skip export and import statements
     if (trimmed.startsWith("export ") || trimmed.startsWith("import ")) {
       continue;
     }
 
-    // Track JSX blocks (like callout divs) and skip them
     if (
       !inJsxBlock &&
       trimmed.startsWith("<div ") &&
@@ -33,7 +28,6 @@ export function mdxToCleanMarkdown(raw: string): string {
     }
 
     if (inJsxBlock) {
-      // Count opening/closing div tags to handle nesting
       const opens = (line.match(/<div[\s>]/g) || []).length;
       const closes = (line.match(/<\/div>/g) || []).length;
       jsxDepth += opens - closes;
@@ -47,7 +41,6 @@ export function mdxToCleanMarkdown(raw: string): string {
     out.push(line);
   }
 
-  // Clean up leading blank lines
   let result = out.join("\n");
   result = result.replace(/^\n+/, "\n").trim();
   return result;

docs/src/lib/page-titles.ts

@@ -2,6 +2,7 @@ export const PAGE_TITLES: Record<string, string> = {
   "": "Headless Browser\nAutomation for AI",
   installation: "Installation",
   "quick-start": "Quick Start",
+  skills: "Skills",
   commands: "Commands",
   configuration: "Configuration",
   selectors: "Selectors",