@mars-stack/core 0.4.0

package/dist/test-utils/request-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-helpers.d.ts","sourceRoot":"","sources":["../../src/test-utils/request-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,KAAK,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE9D,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAQ/E;AAED,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,WAAW,CASb"}

package/dist/types.d.ts

@@ -0,0 +1,53 @@
+export interface MarsAppConfig {
+    name: string;
+    description: string;
+    url: string;
+    support: {
+        email: string;
+    };
+    features: {
+        auth: boolean;
+        admin: boolean;
+        darkMode: boolean;
+        [key: string]: boolean;
+    };
+    services: {
+        email: {
+            provider: string;
+        };
+        payments?: {
+            provider: string;
+        };
+        storage?: {
+            provider: string;
+        };
+        [key: string]: {
+            provider: string;
+        } | undefined;
+    };
+}
+export interface PrismaLike {
+    user: {
+        findUnique: (args: {
+            where: {
+                id: string;
+            };
+            select: Record<string, boolean>;
+        }) => Promise<Record<string, unknown> | null>;
+    };
+}
+export interface MarsServices {
+    email: {
+        provider: string;
+    };
+    storage?: {
+        provider: string;
+    };
+    payments?: {
+        provider: string;
+    };
+    [key: string]: {
+        provider: string;
+    } | undefined;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3B,QAAQ,EAAE;QACR,IAAI,EAAE,OAAO,CAAC;QACd,KAAK,EAAE,OAAO,CAAC;QACf,QAAQ,EAAE,OAAO,CAAC;QAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,QAAQ,EAAE;QACR,KAAK,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAA;SAAE,CAAC;QAC5B,QAAQ,CAAC,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAA;SAAE,CAAC;QAChC,OAAO,CAAC,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAA;SAAE,CAAC;QAC/B,CAAC,GAAG,EAAE,MAAM,GAAG;YAAE,QAAQ,EAAE,MAAM,CAAA;SAAE,GAAG,SAAS,CAAC;KACjD,CAAC;CACH;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE;QACJ,UAAU,EAAE,CAAC,IAAI,EAAE;YACjB,KAAK,EAAE;gBAAE,EAAE,EAAE,MAAM,CAAA;aAAE,CAAC;YACtB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;SACjC,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;KAC/C,CAAC;CACH;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5B,OAAO,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/B,QAAQ,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAChC,CAAC,GAAG,EAAE,MAAM,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;CACjD"}

package/dist/utils/math.d.ts

@@ -0,0 +1,2 @@
+export declare function calculatePercentage(x: number, y: number): number;
+//# sourceMappingURL=math.d.ts.map

package/dist/utils/math.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"math.d.ts","sourceRoot":"","sources":["../../src/utils/math.ts"],"names":[],"mappings":"AAAA,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAGhE"}

package/dist/utils/math.js

@@ -0,0 +1,7 @@
+// src/utils/math.ts
+function calculatePercentage(x, y) {
+  if (y === 0) return 0;
+  return x / y * 100;
+}
+
+export { calculatePercentage };

package/dist/utils/optional-import.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Dynamically imports an optional peer dependency at runtime.
+ *
+ * Uses a function parameter as the specifier so that bundlers (webpack,
+ * Turbopack, esbuild) cannot statically resolve the module at compile
+ * time. This prevents "Module not found" errors when an optional peer
+ * dep is not installed in the consuming project.
+ *
+ * The import only executes when the code path is actually reached at
+ * runtime — e.g. only the Resend SDK is imported when the Resend
+ * email provider is configured, never when SendGrid is active.
+ */
+export declare function importOptional<T = unknown>(specifier: string): Promise<T>;
+//# sourceMappingURL=optional-import.d.ts.map

package/dist/utils/optional-import.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"optional-import.d.ts","sourceRoot":"","sources":["../../src/utils/optional-import.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,wBAAsB,cAAc,CAAC,CAAC,GAAG,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAS/E"}

package/package.json

@@ -0,0 +1,205 @@
+{
+  "name": "@mars-stack/core",
+  "version": "0.4.0",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/greaveselliott/mars.git"
+  },
+  "homepage": "https://github.com/greaveselliott/mars#readme",
+  "keywords": [
+    "saas",
+    "nextjs",
+    "prisma",
+    "auth",
+    "fullstack"
+  ],
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./database": {
+      "types": "./dist/database/index.d.ts",
+      "import": "./dist/database/index.js"
+    },
+    "./rate-limit": {
+      "types": "./dist/rate-limit/index.d.ts",
+      "import": "./dist/rate-limit/index.js"
+    },
+    "./auth/password": {
+      "types": "./dist/auth/password.d.ts",
+      "import": "./dist/auth/password.js"
+    },
+    "./auth/verification": {
+      "types": "./dist/auth/verification.d.ts",
+      "import": "./dist/auth/verification.js"
+    },
+    "./auth/validation": {
+      "types": "./dist/auth/validation.d.ts",
+      "import": "./dist/auth/validation.js"
+    },
+    "./auth/responses": {
+      "types": "./dist/auth/responses.d.ts",
+      "import": "./dist/auth/responses.js"
+    },
+    "./auth/link-utils": {
+      "types": "./dist/auth/link-utils.d.ts",
+      "import": "./dist/auth/link-utils.js"
+    },
+    "./auth/hooks": {
+      "types": "./dist/auth/hooks/index.d.ts",
+      "import": "./dist/auth/hooks/index.js"
+    },
+    "./auth/credential-tag": {
+      "types": "./dist/auth/credential-tag.d.ts",
+      "import": "./dist/auth/credential-tag.js"
+    },
+    "./auth/reset-token": {
+      "types": "./dist/auth/reset-token.d.ts",
+      "import": "./dist/auth/reset-token.js"
+    },
+    "./auth/internal-api-key": {
+      "types": "./dist/auth/internal-api-key.d.ts",
+      "import": "./dist/auth/internal-api-key.js"
+    },
+    "./auth/crypto-utils": {
+      "types": "./dist/auth/crypto-utils.d.ts",
+      "import": "./dist/auth/crypto-utils.js"
+    },
+    "./auth/csrf": {
+      "types": "./dist/auth/csrf.d.ts",
+      "import": "./dist/auth/csrf.js"
+    },
+    "./auth/middleware": {
+      "types": "./dist/auth/middleware.d.ts",
+      "import": "./dist/auth/middleware.js"
+    },
+    "./auth/session": {
+      "types": "./dist/auth/session.d.ts",
+      "import": "./dist/auth/session.js"
+    },
+    "./auth/types": {
+      "types": "./dist/auth/types.d.ts",
+      "import": "./dist/auth/types.js"
+    },
+    "./auth/validators": {
+      "types": "./dist/auth/validators.d.ts",
+      "import": "./dist/auth/validators.js"
+    },
+    "./seo": {
+      "types": "./dist/seo/index.d.ts",
+      "import": "./dist/seo/index.js"
+    },
+    "./utils/math": {
+      "types": "./dist/utils/math.d.ts",
+      "import": "./dist/utils/math.js"
+    },
+    "./payments": {
+      "types": "./dist/payments/index.d.ts",
+      "import": "./dist/payments/index.js"
+    },
+    "./storage": {
+      "types": "./dist/storage/index.d.ts",
+      "import": "./dist/storage/index.js"
+    },
+    "./plugin": {
+      "types": "./dist/plugin/index.d.ts",
+      "import": "./dist/plugin/index.js"
+    },
+    "./plugin/builtin": {
+      "types": "./dist/plugin/builtin/index.d.ts",
+      "import": "./dist/plugin/builtin/index.js"
+    },
+    "./test-utils": {
+      "types": "./dist/test-utils/index.d.ts",
+      "import": "./dist/test-utils/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "restricted"
+  },
+  "files": [
+    "dist",
+    "cursor",
+    "scripts"
+  ],
+  "scripts": {
+    "build": "tsup && tsc -p tsconfig.build.json",
+    "dev": "tsup --watch",
+    "postinstall": "node scripts/postinstall.mjs",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "prepublishOnly": "yarn build"
+  },
+  "sideEffects": false,
+  "peerDependencies": {
+    "@aws-sdk/client-s3": ">=3.0.0",
+    "@aws-sdk/s3-request-presigner": ">=3.0.0",
+    "@prisma/client": ">=5",
+    "@sendgrid/mail": ">=7.0.0",
+    "@upstash/ratelimit": ">=2.0.0",
+    "@upstash/redis": ">=1.20.0",
+    "@vercel/blob": ">=0.20.0",
+    "next": ">=14",
+    "react": ">=18",
+    "resend": ">=1.0.0",
+    "stripe": ">=14.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@prisma/client": {
+      "optional": true
+    },
+    "@sendgrid/mail": {
+      "optional": true
+    },
+    "@upstash/ratelimit": {
+      "optional": true
+    },
+    "@upstash/redis": {
+      "optional": true
+    },
+    "resend": {
+      "optional": true
+    },
+    "stripe": {
+      "optional": true
+    },
+    "@vercel/blob": {
+      "optional": true
+    },
+    "@aws-sdk/client-s3": {
+      "optional": true
+    },
+    "@aws-sdk/s3-request-presigner": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "bcryptjs": "^2.4.3",
+    "jose": "^6.2.1",
+    "pino": "^9.6.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@aws-sdk/client-s3": "^3.1007.0",
+    "@aws-sdk/s3-request-presigner": "^3.1007.0",
+    "@testing-library/react": "^16.0.0",
+    "@types/bcryptjs": "^2.4.0",
+    "@types/fs-extra": "^11.0.4",
+    "@types/react": "^19.0.0",
+    "@upstash/ratelimit": "^2.0.0",
+    "@upstash/redis": "^1.36.4",
+    "@vercel/blob": "^2.3.1",
+    "fs-extra": "^11.3.4",
+    "next": "^16.0.0",
+    "react": "^19.0.0",
+    "resend": "^6.9.3",
+    "stripe": "^17.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  }
+}

package/scripts/generate-skill-adapters.ts

@@ -0,0 +1,146 @@
+import fs from 'fs-extra';
+import path from 'path';
+
+interface SkillManifestEntry {
+  file: string;
+  triggers: string[];
+  dependencies?: string[];
+  capabilities?: string[];
+}
+
+interface Manifest {
+  skills: Record<string, SkillManifestEntry>;
+}
+
+const CORE_DIR = path.resolve(__dirname, '..');
+const SKILLS_DIR = path.join(CORE_DIR, 'cursor/skills');
+const MANIFEST_PATH = path.join(CORE_DIR, 'cursor/manifest.json');
+
+async function generateCursorOutput(
+  outputDir: string,
+  manifest: Manifest,
+): Promise<void> {
+  const destDir = path.join(outputDir, '.cursor/skills');
+  await fs.ensureDir(destDir);
+
+  for (const [name] of Object.entries(manifest.skills)) {
+    const srcDir = path.join(SKILLS_DIR, `mars-${name}`);
+    const destSkillDir = path.join(destDir, `mars-${name}`);
+
+    if (await fs.pathExists(srcDir)) {
+      await fs.copy(srcDir, destSkillDir, { overwrite: true });
+    }
+  }
+}
+
+async function generateWindsurfOutput(
+  outputDir: string,
+  manifest: Manifest,
+): Promise<void> {
+  const rules: string[] = ['# Mars Project Rules\n'];
+
+  for (const [name, entry] of Object.entries(manifest.skills)) {
+    const skillPath = path.join(SKILLS_DIR, `mars-${name}`, 'SKILL.md');
+    if (await fs.pathExists(skillPath)) {
+      const content = await fs.readFile(skillPath, 'utf-8');
+      rules.push(`\n## Skill: ${name}\n`);
+      rules.push(`Triggers: ${entry.triggers.join(', ')}\n`);
+      rules.push(content);
+    }
+  }
+
+  await fs.writeFile(path.join(outputDir, '.windsurfrules'), rules.join('\n'));
+}
+
+async function generateCopilotOutput(
+  outputDir: string,
+  manifest: Manifest,
+): Promise<void> {
+  const lines: string[] = [
+    '# Mars Project Instructions for GitHub Copilot\n',
+    '## Architecture\n',
+  ];
+
+  const agentsPath = path.join(outputDir, 'AGENTS.md');
+  if (await fs.pathExists(agentsPath)) {
+    const agentsContent = await fs.readFile(agentsPath, 'utf-8');
+    lines.push(agentsContent);
+  }
+
+  lines.push('\n## Available Skills\n');
+  for (const [name, entry] of Object.entries(manifest.skills)) {
+    lines.push(`- **${name}**: Triggers: ${entry.triggers.join(', ')}`);
+    if (entry.dependencies?.length) {
+      lines.push(`  Dependencies: ${entry.dependencies.join(', ')}`);
+    }
+  }
+
+  await fs.ensureDir(path.join(outputDir, '.github'));
+  await fs.writeFile(
+    path.join(outputDir, '.github/copilot-instructions.md'),
+    lines.join('\n'),
+  );
+}
+
+async function generateCodexOutput(
+  outputDir: string,
+  manifest: Manifest,
+): Promise<void> {
+  const skillsDir = path.join(outputDir, 'docs/skills');
+  await fs.ensureDir(skillsDir);
+
+  for (const [name] of Object.entries(manifest.skills)) {
+    const skillPath = path.join(SKILLS_DIR, `mars-${name}`, 'SKILL.md');
+    if (await fs.pathExists(skillPath)) {
+      await fs.copy(skillPath, path.join(skillsDir, `${name}.md`));
+    }
+  }
+
+  const index: string[] = ['# Available Skills\n'];
+  for (const [name, entry] of Object.entries(manifest.skills)) {
+    index.push(`## ${name}\n`);
+    index.push(`- **Triggers**: ${entry.triggers.join(', ')}`);
+    if (entry.dependencies?.length) {
+      index.push(`- **Dependencies**: ${entry.dependencies.join(', ')}`);
+    }
+    index.push(`- **File**: [${name}.md](./skills/${name}.md)\n`);
+  }
+  await fs.writeFile(
+    path.join(outputDir, 'docs/skill-index.md'),
+    index.join('\n'),
+  );
+}
+
+type GeneratorFn = (dir: string, m: Manifest) => Promise<void>;
+
+const GENERATORS: Record<string, GeneratorFn> = {
+  cursor: generateCursorOutput,
+  windsurf: generateWindsurfOutput,
+  copilot: generateCopilotOutput,
+  codex: generateCodexOutput,
+};
+
+export const SUPPORTED_TARGETS = Object.keys(GENERATORS);
+
+async function main(): Promise<void> {
+  const manifest: Manifest = await fs.readJson(MANIFEST_PATH);
+  const outputDir = process.argv[2] || '.';
+  const target = process.argv[3] || 'all';
+
+  if (target === 'all') {
+    for (const gen of Object.values(GENERATORS)) {
+      await gen(outputDir, manifest);
+    }
+  } else if (GENERATORS[target]) {
+    await GENERATORS[target](outputDir, manifest);
+  } else {
+    console.error(
+      `Unknown target: ${target}. Available: ${SUPPORTED_TARGETS.join(', ')}`,
+    );
+    process.exit(1);
+  }
+
+  console.log(`Generated skill adapters for: ${target}`);
+}
+
+main().catch(console.error);

package/scripts/postinstall.mjs

@@ -0,0 +1,146 @@
+import fs from 'fs';
+import path from 'path';
+
+const packageDir = path.dirname(new URL(import.meta.url).pathname);
+const projectRoot = process.env.INIT_CWD || process.cwd();
+const pkgJsonPath = path.join(projectRoot, 'package.json');
+
+if (!fs.existsSync(pkgJsonPath)) process.exit(0);
+
+let pkgJson;
+try {
+  pkgJson = JSON.parse(fs.readFileSync(pkgJsonPath, 'utf-8'));
+} catch {
+  process.exit(0);
+}
+
+const isMarsProject = pkgJson.mars !== undefined
+  || pkgJson.dependencies?.['@mars-stack/core'] !== undefined;
+
+if (!isMarsProject) process.exit(0);
+
+/**
+ * Detect which IDE environment the project is running in.
+ * Falls back to 'cursor' as the default since that's the primary target.
+ */
+function detectIdeEnvironment() {
+  if (fs.existsSync(path.join(projectRoot, '.windsurf')) ||
+      process.env.WINDSURF_WORKSPACE) {
+    return 'windsurf';
+  }
+
+  if (fs.existsSync(path.join(projectRoot, '.github', 'copilot-instructions.md')) ||
+      process.env.GITHUB_COPILOT) {
+    return 'copilot';
+  }
+
+  if (fs.existsSync(path.join(projectRoot, '.codex')) ||
+      process.env.CODEX_HOME) {
+    return 'codex';
+  }
+
+  return 'cursor';
+}
+
+const ide = detectIdeEnvironment();
+
+// Cursor: copy rules + skills into .cursor/ (primary target)
+const copies = [
+  { src: 'rules', dest: '.cursor/rules' },
+  { src: 'skills', dest: '.cursor/skills' },
+];
+
+for (const { src, dest } of copies) {
+  const srcDir = path.join(packageDir, '..', 'cursor', src);
+  const destDir = path.join(projectRoot, dest);
+  if (!fs.existsSync(srcDir)) continue;
+
+  fs.mkdirSync(destDir, { recursive: true });
+
+  const entries = fs.readdirSync(srcDir, { withFileTypes: true });
+  for (const entry of entries) {
+    if (entry.isFile() && entry.name.startsWith('mars-')) {
+      fs.copyFileSync(
+        path.join(srcDir, entry.name),
+        path.join(destDir, entry.name),
+      );
+    } else if (entry.isDirectory() && entry.name.startsWith('mars-')) {
+      fs.cpSync(
+        path.join(srcDir, entry.name),
+        path.join(destDir, entry.name),
+        { recursive: true },
+      );
+    }
+  }
+}
+
+// Generate IDE-specific adapter files for non-Cursor environments
+if (ide !== 'cursor') {
+  const manifestPath = path.join(packageDir, '..', 'cursor', 'manifest.json');
+  if (!fs.existsSync(manifestPath)) process.exit(0);
+
+  const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf-8'));
+  const skillsDir = path.join(packageDir, '..', 'cursor', 'skills');
+
+  if (ide === 'windsurf') {
+    const rules = ['# Mars Project Rules\n'];
+
+    for (const [name, entry] of Object.entries(manifest.skills)) {
+      const skillPath = path.join(skillsDir, `mars-${name}`, 'SKILL.md');
+      if (fs.existsSync(skillPath)) {
+        const content = fs.readFileSync(skillPath, 'utf-8');
+        rules.push(`\n## Skill: ${name}\n`);
+        rules.push(`Triggers: ${/** @type {{ triggers: string[] }} */ (entry).triggers.join(', ')}\n`);
+        rules.push(content);
+      }
+    }
+
+    fs.writeFileSync(path.join(projectRoot, '.windsurfrules'), rules.join('\n'));
+  }
+
+  if (ide === 'copilot') {
+    const lines = ['# Mars Project Instructions for GitHub Copilot\n'];
+
+    const agentsPath = path.join(projectRoot, 'AGENTS.md');
+    if (fs.existsSync(agentsPath)) {
+      lines.push(fs.readFileSync(agentsPath, 'utf-8'));
+    }
+
+    lines.push('\n## Available Skills\n');
+    for (const [name, entry] of Object.entries(manifest.skills)) {
+      const typedEntry = /** @type {{ triggers: string[]; dependencies?: string[] }} */ (entry);
+      lines.push(`- **${name}**: Triggers: ${typedEntry.triggers.join(', ')}`);
+      if (typedEntry.dependencies?.length) {
+        lines.push(`  Dependencies: ${typedEntry.dependencies.join(', ')}`);
+      }
+    }
+
+    const ghDir = path.join(projectRoot, '.github');
+    fs.mkdirSync(ghDir, { recursive: true });
+    fs.writeFileSync(path.join(ghDir, 'copilot-instructions.md'), lines.join('\n'));
+  }
+
+  if (ide === 'codex') {
+    const docsSkillsDir = path.join(projectRoot, 'docs', 'skills');
+    fs.mkdirSync(docsSkillsDir, { recursive: true });
+
+    for (const [name] of Object.entries(manifest.skills)) {
+      const skillPath = path.join(skillsDir, `mars-${name}`, 'SKILL.md');
+      if (fs.existsSync(skillPath)) {
+        fs.copyFileSync(skillPath, path.join(docsSkillsDir, `${name}.md`));
+      }
+    }
+
+    const index = ['# Available Skills\n'];
+    for (const [name, entry] of Object.entries(manifest.skills)) {
+      const typedEntry = /** @type {{ triggers: string[]; dependencies?: string[] }} */ (entry);
+      index.push(`## ${name}\n`);
+      index.push(`- **Triggers**: ${typedEntry.triggers.join(', ')}`);
+      if (typedEntry.dependencies?.length) {
+        index.push(`- **Dependencies**: ${typedEntry.dependencies.join(', ')}`);
+      }
+      index.push(`- **File**: [${name}.md](./skills/${name}.md)\n`);
+    }
+    fs.writeFileSync(path.join(projectRoot, 'docs', 'skill-index.md'), index.join('\n'));
+  }
+}