rahman-resources 0.3.0 → 0.4.2

package/bin/cli.js

@@ -1,10 +1,13 @@
 #!/usr/bin/env node
 // rahman-resources — installer for the Rahman kitab.
 // Usage:
-//   npx rahman-resources init <app-name> [--lite]
+//   npx rahman-resources init <app-name> [--template <slug>] [--features a,b] [--skills x,y]
 //   npx rahman-resources add <slug> [target-dir]
-//   npx rahman-resources list [layouts|recipes|features]
+//   npx rahman-resources add-skill <slug> [target-dir]
+//   npx rahman-resources list [layouts|recipes|features|skills]
 //   npx rahman-resources info <slug>
+//   npx rahman-resources doctor
+//   npx rahman-resources mcp                # not implemented in CLI; install rahman-resources-mcp
 
 import { createRequire } from "node:module";
 import { spawn } from "node:child_process";
@@ -15,19 +18,29 @@ import { fileURLToPath } from "node:url";
 import kleur from "kleur";
 import tiged from "tiged";
 
+import {
+  readRr,
+  writeRr,
+  rrExists,
+  validateRr,
+  addFeature as rrAddFeature,
+  addSkill as rrAddSkill,
+} from "../lib/rr.mjs";
+import { runPostInit } from "../lib/post-init.mjs";
+
 const require = createRequire(import.meta.url);
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const manifest = require(path.join(__dirname, "../lib/manifest.json"));
+const skillsInventory = require(path.join(__dirname, "../lib/skills.json"));
 
 const REPO = manifest.repo ?? "rahmanef63/resource-site";
 const BRANCH = manifest.branch ?? "main";
+const SKILLS_REPO = "anthropics/skills";
 
 const KINDS = /** @type {const} */ (["layout", "recipe", "feature"]);
 
 const [, , cmd, ...rest] = process.argv;
 
-// Defer to next tick so all module-level const declarations finish initializing
-// before the dispatch reaches functions that reference them.
 queueMicrotask(() =>
   main().catch((err) => {
     console.error(kleur.red("✖"), err.message ?? err);
@@ -43,11 +56,17 @@ async function main() {
       return runInit(rest);
     case "add":
       return runAdd(rest);
+    case "add-skill":
+      return runAddSkill(rest);
     case "list":
     case "ls":
       return runList(rest);
     case "info":
       return runInfo(rest);
+    case "doctor":
+      return runDoctor(rest);
+    case "mcp":
+      return runMcpHint();
     case undefined:
     case "-h":
     case "--help":
@@ -71,23 +90,58 @@ function printVersion() {
 
 function printHelp() {
   console.log(`
-${kleur.bold("rahman-resources")} — scaffold + install templates, recipes, features
+${kleur.bold("rahman-resources")} — scaffold + install templates, recipes, features, Claude skills
 
 ${kleur.bold("Usage:")}
-  npx rahman-resources init <app-name> [--lite]
+  npx rahman-resources init <app-name> [--template <slug>] [--features a,b] [--skills x,y]
+                                       [--no-install] [--with-shadcn-reinit]
   npx rahman-resources add <slug> [target-dir]
-  npx rahman-resources list [layouts|recipes|features]
+  npx rahman-resources add-skill <slug> [target-dir]
+  npx rahman-resources list [layouts|recipes|features|skills]
   npx rahman-resources info <slug>
+  npx rahman-resources doctor
+  npx rahman-resources mcp
+
+${kleur.bold("Init flags:")}
+  --no-install            skip 'npm install' step (faster scaffolds; you run it manually)
+  --with-shadcn-reinit    delete starter components.json + run 'npx shadcn init -y -d' (canonical shadcn flow)
 
 ${kleur.bold("Examples:")}
-  npx rahman-resources init my-app --lite              ${kleur.dim("# scaffold from template-base, prune notion+builder+communications")}
-  npx rahman-resources add personal-brand-os my-app    ${kleur.dim("# layout — pulls folders + installs deps")}
-  npx rahman-resources add ai-sdk-openrouter my-app    ${kleur.dim("# feature — runs npm install")}
-  npx rahman-resources add block-editor                ${kleur.dim("# recipe — prints code + source URL")}
-  npx rahman-resources list features
+  npx rahman-resources init my-app
+  npx rahman-resources init my-app --template personal-brand-os --skills frontend-design,mcp-builder
+  npx rahman-resources init my-app --no-install
+  npx rahman-resources add personal-brand-os .
+  npx rahman-resources add-skill webapp-testing
+  npx rahman-resources list skills
 `);
 }
 
+// ─── flag parsing ─────────────────────────────────────────────────────────
+
+function parseFlags(rest) {
+  const positional = [];
+  const flags = {};
+  for (let i = 0; i < rest.length; i++) {
+    const a = rest[i];
+    if (a.startsWith("--")) {
+      const key = a.slice(2);
+      const next = rest[i + 1];
+      if (next && !next.startsWith("--")) { flags[key] = next; i++; }
+      else flags[key] = true;
+    } else {
+      positional.push(a);
+    }
+  }
+  return { positional, flags };
+}
+
+function csv(s) {
+  if (!s || s === true) return [];
+  return String(s).split(",").map((x) => x.trim()).filter(Boolean);
+}
+
+// ─── catalog lookups ──────────────────────────────────────────────────────
+
 function findEntry(slug) {
   for (const kind of KINDS) {
     const list = manifest[kind + "s"];
@@ -97,24 +151,49 @@ function findEntry(slug) {
   return null;
 }
 
+function findSkill(slug) {
+  return skillsInventory.skills.find((s) => s.slug === slug) ?? null;
+}
+
+// ─── list / info ──────────────────────────────────────────────────────────
+
 function runList([filter]) {
-  const groups = filter ? [filter] : ["layouts", "recipes", "features"];
+  const groups = filter
+    ? [filter]
+    : ["layouts", "recipes", "features", "skills"];
   for (const g of groups) {
+    if (g === "skills") {
+      console.log(`\n${kleur.bold("SKILLS")} ${kleur.dim(`(${skillsInventory.skills.length})`)}\n`);
+      for (const s of skillsInventory.skills) {
+        console.log(`  ${kleur.cyan(s.slug.padEnd(28))} ${kleur.dim((s.category ?? "").padEnd(12))} ${s.title}`);
+      }
+      continue;
+    }
     const list = manifest[g];
     if (!list || list.length === 0) continue;
     console.log(`\n${kleur.bold(g.toUpperCase())} ${kleur.dim(`(${list.length})`)}\n`);
     for (const t of list) {
       const cat = (t.category ?? t.source ?? "").padEnd(20).slice(0, 20);
-      console.log(
-        `  ${kleur.cyan(t.slug.padEnd(30))} ${kleur.dim(cat)} ${t.title}`,
-      );
+      console.log(`  ${kleur.cyan(t.slug.padEnd(30))} ${kleur.dim(cat)} ${t.title}`);
     }
   }
-  console.log(`\nRun ${kleur.cyan("info <slug>")} for detail, ${kleur.cyan("add <slug> [target]")} to install.\n`);
+  console.log(`\nRun ${kleur.cyan("info <slug>")} for detail, ${kleur.cyan("add <slug>")} or ${kleur.cyan("add-skill <slug>")} to install.\n`);
 }
 
 function runInfo([slug]) {
   if (!slug) throw new Error("Usage: rahman-resources info <slug>");
+  const skill = findSkill(slug);
+  if (skill) {
+    console.log(`
+${kleur.bold(skill.title)}  ${kleur.dim("[skill]")}  ${kleur.dim(skill.category)}
+
+${skill.description}
+
+${kleur.bold("Source:")}  ${skill.source}/${skill.path}
+${kleur.bold("Install:")} ${kleur.cyan(`npx rahman-resources add-skill ${skill.slug}`)}
+`);
+    return;
+  }
   const found = findEntry(slug);
   if (!found) throw new Error(`Slug not found: ${slug}. Run 'list' to see all.`);
   const { kind, entry: t } = found;
@@ -124,7 +203,6 @@ ${kleur.bold(t.title)}  ${kleur.dim(`[${kind}]`)}  ${kleur.dim(t.category ?? "")
 
 ${t.description}
 `);
-
   if (kind === "layout") {
     console.log(`${kleur.bold("Pulls:")}`);
     console.log(t.pullPaths.map((p) => `  · ${p}`).join("\n") || "  (none)");
@@ -142,13 +220,12 @@ ${t.description}
     console.log(`${kleur.bold("Files:")}`);
     console.log(t.files.map((f) => `  · ${f}`).join("\n"));
   }
-
   if (t.docsUrl) console.log(`\n${kleur.dim(`Docs: ${t.docsUrl}`)}`);
   console.log(`${kleur.dim(`Source: ${t.source ?? "—"}`)}\n`);
 }
 
-// Files in lib/starter prefixed with `_` get renamed on copy.
-// Done because npm pack filters .gitignore and warns on nested package.json.
+// ─── starter copy ─────────────────────────────────────────────────────────
+
 const STARTER_RENAME_PAIRS = [
   ["_package", "package"],
   ["_gitignore", ".gitignore"],
@@ -182,9 +259,13 @@ function copyStarterTree(src, dest, appName, slug) {
   }
 }
 
-async function runInit([appName, ...flags]) {
+// ─── init ─────────────────────────────────────────────────────────────────
+
+async function runInit(rest) {
+  const { positional, flags } = parseFlags(rest);
+  const [appName] = positional;
   if (!appName || appName.startsWith("-")) {
-    throw new Error("Usage: rahman-resources init <app-name>");
+    throw new Error("Usage: rahman-resources init <app-name> [--template slug] [--features a,b] [--skills x,y]");
   }
   const slug = appName.replace(/[^a-z0-9-_]/gi, "-").toLowerCase();
   const target = path.resolve(process.cwd(), appName);
@@ -192,34 +273,99 @@ async function runInit([appName, ...flags]) {
     throw new Error(`Directory already exists: ${target}`);
   }
 
+  const features = csv(flags.features);
+  const skills = csv(flags.skills);
+  const template = typeof flags.template === "string" ? flags.template : null;
+
+  if (template && !findEntry(template)) {
+    throw new Error(`Unknown template: ${template}. Run 'list layouts' to see available.`);
+  }
+  for (const s of skills) {
+    if (!findSkill(s)) throw new Error(`Unknown skill: ${s}. Run 'list skills' to see available.`);
+  }
+  for (const f of features) {
+    if (!findEntry(f)) throw new Error(`Unknown feature: ${f}. Run 'list features' to see available.`);
+  }
+
   console.log(kleur.bold(`\n→ Scaffolding ${kleur.cyan(slug)} (Next 16 + Convex + shadcn)\n`));
 
   const starter = path.join(__dirname, "../lib/starter");
-  if (!existsSync(starter)) {
-    throw new Error(`Starter not found at ${starter}`);
-  }
+  if (!existsSync(starter)) throw new Error(`Starter not found at ${starter}`);
 
   process.stdout.write(`  copying starter ... `);
   copyStarterTree(starter, target, appName, slug);
   console.log(kleur.green("ok"));
 
-  // Ignore --lite flag for now (no template-base pull yet — starter is minimal already).
-  if (flags.includes("--lite")) {
-    console.log(kleur.dim(`  (--lite is a no-op — starter is already minimal)`));
+  const skipInstall = !!flags["no-install"];
+  const reinitShadcn = !!flags["with-shadcn-reinit"];
+
+  if (!skipInstall) {
+    console.log(kleur.bold(`\n→ Installing dependencies (npm install --legacy-peer-deps)\n`));
+    try {
+      await runShell("npm", ["install", "--legacy-peer-deps"], target);
+    } catch (err) {
+      console.log(kleur.yellow(`  ⚠ npm install failed (${err.message}). You can rerun manually.`));
+    }
+  } else {
+    console.log(kleur.dim(`\n  (skipping npm install — --no-install)`));
+  }
+
+  if (reinitShadcn && !skipInstall) {
+    console.log(kleur.bold(`\n→ Re-running shadcn init (--with-shadcn-reinit)\n`));
+    try {
+      // Remove pre-baked components.json so shadcn writes a fresh one — post-init re-applies our aliases.
+      const cjPath = path.join(target, "components.json");
+      if (existsSync(cjPath)) writeFileSync(cjPath + ".bak", readFileSync(cjPath, "utf8"));
+      await runShell("npx", ["shadcn@latest", "init", "--yes", "--defaults"], target);
+    } catch (err) {
+      console.log(kleur.yellow(`  ⚠ shadcn init failed (${err.message}). Continuing.`));
+    }
+  } else if (!skipInstall) {
+    console.log(kleur.dim(`\n  (skipping shadcn init — starter already pre-configured. Pass --with-shadcn-reinit to force re-init.)`));
+  }
+
+  process.stdout.write(`\n  post-init restructure ... `);
+  const post = runPostInit(target, { template, features, skills });
+  console.log(kleur.green("ok"));
+  for (const c of post.changed) console.log(`    ${kleur.green("+")} ${c}`);
+  for (const s of post.skipped) console.log(`    ${kleur.dim("-")} ${kleur.dim(s)}`);
+
+  if (template) {
+    console.log(kleur.bold(`\n→ Pulling template ${kleur.cyan(template)}\n`));
+    const t = findEntry(template).entry;
+    for (const p of t.pullPaths ?? []) {
+      const dest = path.join(target, p);
+      process.stdout.write(`  ${kleur.dim(p)} ... `);
+      await pull(p, dest);
+      console.log(kleur.green("ok"));
+    }
+  }
+
+  if (skills.length) {
+    console.log(kleur.bold(`\n→ Pulling ${skills.length} Claude skill(s)\n`));
+    for (const s of skills) await installSkill(s, target);
   }
 
   console.log(`\n${kleur.green("✓")} Done. ${kleur.bold(slug)} scaffolded.\n`);
   console.log(`${kleur.bold("Next:")}`);
   console.log(`  cd ${appName}`);
   console.log(`  cp .env.example .env.local   ${kleur.dim("# fill NEXT_PUBLIC_CONVEX_URL")}`);
-  console.log(`  npm install --legacy-peer-deps`);
+  if (skipInstall) console.log(`  npm install --legacy-peer-deps`);
   console.log(`  npx convex dev --once         ${kleur.dim("# generates convex/_generated")}`);
   console.log(`  npm run dev\n`);
-  console.log(
-    `${kleur.dim("Then drop in a layout:")} ${kleur.cyan("npx rahman-resources add personal-brand-os .")}\n`,
-  );
 }
 
+// Spawn a child process inheriting stdio, resolves on exit 0.
+function runShell(cmd, args, cwd) {
+  return new Promise((resolve, reject) => {
+    const ps = spawn(cmd, args, { cwd, stdio: "inherit", shell: true });
+    ps.on("error", reject);
+    ps.on("exit", (code) => (code === 0 ? resolve() : reject(new Error(`${cmd} exited ${code}`))));
+  });
+}
+
+// ─── add (template / feature / recipe) ────────────────────────────────────
+
 async function runAdd([slug, targetArg = "."]) {
   if (!slug) {
     console.error(kleur.red("Missing slug."));
@@ -227,11 +373,7 @@ async function runAdd([slug, targetArg = "."]) {
     process.exit(1);
   }
   const found = findEntry(slug);
-  if (!found) {
-    throw new Error(
-      `"${slug}" not found. Run ${kleur.cyan("npx rahman-resources list")}.`,
-    );
-  }
+  if (!found) throw new Error(`"${slug}" not found. Run ${kleur.cyan("npx rahman-resources list")}.`);
   const { kind, entry } = found;
   const target = path.resolve(process.cwd(), targetArg);
 
@@ -263,6 +405,12 @@ async function addLayout(t, target, targetArg) {
     }
   }
 
+  if (rrExists(target)) {
+    const rr = readRr(target);
+    rr.template = { slug: t.slug, version: "main" };
+    writeRr(rr, target);
+  }
+
   console.log(`\n${kleur.green("✓")} Done. ${kleur.bold(t.title)} installed.`);
   if (t.agentRecipe) console.log(`\n${kleur.bold("Next:")}\n${indent(t.agentRecipe, 2)}\n`);
 }
@@ -282,11 +430,15 @@ async function addFeature(t, target, targetArg) {
     }
   }
 
-  console.log(`\n${kleur.green("✓")} Feature added: ${kleur.bold(t.title)}`);
-  if (t.exampleCode) {
-    console.log(`\n${kleur.bold("Example:")}`);
-    console.log(indent(t.exampleCode, 2));
+  if (rrExists(target)) {
+    const rr = readRr(target);
+    rrAddFeature(rr, t.slug);
+    writeRr(rr, target);
+    console.log(kleur.dim(`  rr.json: features += ${t.slug}`));
   }
+
+  console.log(`\n${kleur.green("✓")} Feature added: ${kleur.bold(t.title)}`);
+  if (t.exampleCode) console.log(`\n${kleur.bold("Example:")}\n${indent(t.exampleCode, 2)}`);
   if (t.agentRecipe) console.log(`\n${kleur.bold("Wire-up:")}\n${indent(t.agentRecipe, 2)}\n`);
   if (t.docsUrl) console.log(`\n${kleur.dim(`Docs: ${t.docsUrl}`)}\n`);
 }
@@ -297,20 +449,97 @@ function addRecipe(t) {
   console.log(`\n${kleur.bold("Source:")} ${t.source}`);
   console.log(`\n${kleur.bold("Files to port:")}`);
   console.log(t.files.map((f) => `  · ${f}`).join("\n"));
-  if (t.exampleCode) {
-    console.log(`\n${kleur.bold("Example:")}`);
-    console.log(indent(t.exampleCode, 2));
-  }
+  if (t.exampleCode) console.log(`\n${kleur.bold("Example:")}\n${indent(t.exampleCode, 2)}`);
   if (t.agentRecipe) console.log(`\n${kleur.bold("Wire-up:")}\n${indent(t.agentRecipe, 2)}\n`);
   console.log(kleur.dim(`\n(Recipes are educational patterns — copy from source repo into your project manually.)\n`));
 }
 
+// ─── add-skill ────────────────────────────────────────────────────────────
+
+async function runAddSkill([slug, targetArg = "."]) {
+  if (!slug) throw new Error("Usage: rahman-resources add-skill <slug>");
+  const skill = findSkill(slug);
+  if (!skill) throw new Error(`Unknown skill: ${slug}. Run 'list skills' to see available.`);
+  const target = path.resolve(process.cwd(), targetArg);
+  await installSkill(slug, target);
+
+  if (rrExists(target)) {
+    const rr = readRr(target);
+    rrAddSkill(rr, slug, skill.source);
+    writeRr(rr, target);
+    console.log(kleur.dim(`  rr.json: skills += ${slug}`));
+  }
+
+  console.log(`\n${kleur.green("✓")} Skill installed: ${kleur.bold(skill.title)}`);
+  console.log(kleur.dim(`  Location: .claude/skills/${slug}/`));
+}
+
+async function installSkill(slug, target) {
+  const skill = findSkill(slug);
+  if (!skill) throw new Error(`Unknown skill: ${slug}`);
+  const dest = path.join(target, ".claude", "skills", slug);
+  process.stdout.write(`  ${kleur.cyan(slug.padEnd(20))} ${kleur.dim(`→ .claude/skills/${slug}/`)} ... `);
+  if (skill.source === "anthropics") {
+    const emitter = tiged(`${SKILLS_REPO}/${skill.path}`, { cache: false, force: true, verbose: false });
+    await emitter.clone(dest);
+  } else if (skill.source === "rahman") {
+    // Future: ship rahman-authored skills inside this repo. For now, scaffold a stub.
+    mkdirSync(dest, { recursive: true });
+    writeFileSync(
+      path.join(dest, "SKILL.md"),
+      `---\nname: ${skill.slug}\ndescription: ${skill.description}\n---\n\n# ${skill.title}\n\nStub — to be filled by rahman-resources kitab.\n`,
+    );
+  } else {
+    throw new Error(`Unsupported skill source: ${skill.source}`);
+  }
+  console.log(kleur.green("ok"));
+}
+
+// ─── doctor ───────────────────────────────────────────────────────────────
+
+function runDoctor() {
+  const target = process.cwd();
+  if (!rrExists(target)) {
+    console.log(kleur.yellow("⚠ No rr.json found in cwd. Run 'rahman-resources init <app>' first."));
+    process.exit(1);
+  }
+  const rr = readRr(target);
+  const issues = validateRr(rr);
+  if (issues.length === 0) {
+    console.log(kleur.green("✓ rr.json is valid."));
+    console.log(`  template:  ${kleur.cyan(rr.template?.slug ?? "(none)")}`);
+    console.log(`  features:  ${kleur.cyan(rr.features?.length ?? 0)}`);
+    console.log(`  skills:    ${kleur.cyan(rr.skills?.length ?? 0)}`);
+    return;
+  }
+  console.log(kleur.red(`✖ rr.json has ${issues.length} issue(s):`));
+  for (const i of issues) console.log(`  · ${i}`);
+  process.exit(1);
+}
+
+function runMcpHint() {
+  console.log(`
+${kleur.bold("Rahman Resources MCP server")}
+
+Install + wire it into your Claude Code / Cursor config:
+
+${kleur.cyan(`{
+  "mcpServers": {
+    "rahman-resources": {
+      "command": "npx",
+      "args": ["-y", "rahman-resources-mcp"]
+    }
+  }
+}`)}
+
+Then in Claude Code: ${kleur.cyan("/mcp")} to see available rr_* tools.
+`);
+}
+
+// ─── helpers ──────────────────────────────────────────────────────────────
+
 async function pull(repoPath, dest) {
-  const emitter = tiged(`${REPO}/${repoPath}#${BRANCH}`, {
-    cache: false,
-    force: true,
-    verbose: false,
-  });
+  const emitter = tiged(`${REPO}/${repoPath}#${BRANCH}`, { cache: false, force: true, verbose: false });
   await emitter.clone(dest);
 }
 
@@ -330,9 +559,7 @@ function runPM(pm, deps, cwd) {
   return new Promise((resolve, reject) => {
     const ps = spawn(pm, args, { cwd, stdio: "inherit", shell: true });
     ps.on("error", reject);
-    ps.on("exit", (code) =>
-      code === 0 ? resolve() : reject(new Error(`${pm} ${args[0]} exited ${code}`)),
-    );
+    ps.on("exit", (code) => (code === 0 ? resolve() : reject(new Error(`${pm} ${args[0]} exited ${code}`))));
   });
 }
 

package/lib/manifest.json

@@ -1,6 +1,6 @@
 {
   "version": 2,
-  "generatedAt": "2026-05-05T12:19:53.839Z",
+  "generatedAt": "2026-05-06T09:34:49.775Z",
   "repo": "rahmanef63/resource-site",
   "branch": "main",
   "layouts": [
@@ -13,6 +13,7 @@
       "repoPath": "app/preview/personal-brand-os",
       "pullPaths": [
         "app/preview/personal-brand-os",
+        "components/templates/_shared",
         "components/templates/personal-brand",
         "convex/templates/personal-brand-os"
       ],
@@ -48,14 +49,24 @@
         "app/preview/personal-brand-os/admin/settings/site/page.tsx",
         "app/preview/personal-brand-os/admin/settings/team/page.tsx",
         "app/preview/personal-brand-os/admin/settings/ai/page.tsx",
+        "components/templates/_shared/index.ts",
+        "components/templates/_shared/types/common.ts",
+        "components/templates/_shared/utils/index.ts",
+        "components/templates/_shared/hooks/create-template-store.tsx",
+        "components/templates/_shared/ui/section-head.tsx",
+        "components/templates/_shared/ui/site-nav.tsx",
+        "components/templates/_shared/ui/site-footer.tsx",
+        "components/templates/_shared/ui/site-shell.tsx",
+        "components/templates/_shared/ui/admin-sidebar.tsx",
+        "components/templates/_shared/ui/admin-topbar.tsx",
+        "components/templates/_shared/ui/admin-shell.tsx",
+        "components/templates/_shared/ui/stat-card.tsx",
         "components/templates/personal-brand/shared/types.ts",
         "components/templates/personal-brand/shared/store.tsx",
         "components/templates/personal-brand/shared/seed.ts",
         "components/templates/personal-brand/shared/site-config.ts",
-        "components/templates/personal-brand/shared/ui/site-nav.tsx",
-        "components/templates/personal-brand/shared/ui/site-footer.tsx",
+        "components/templates/personal-brand/shared/nav-config.ts",
         "components/templates/personal-brand/shared/ui/chat-fab.tsx",
-        "components/templates/personal-brand/shared/ui/section-head.tsx",
         "components/templates/personal-brand/slices/home/HomePage.tsx",
         "components/templates/personal-brand/slices/home/NewsletterBlock.tsx",
         "components/templates/personal-brand/slices/blog/BlogList.tsx",
@@ -66,8 +77,7 @@
         "components/templates/personal-brand/slices/resources/ResourcesPage.tsx",
         "components/templates/personal-brand/slices/about/AboutPage.tsx",
         "components/templates/personal-brand/slices/contact/ContactPage.tsx",
-        "components/templates/personal-brand/slices/admin/shell/admin-sidebar.tsx",
-        "components/templates/personal-brand/slices/admin/shell/admin-topbar.tsx",
+        "app/preview/personal-brand-os/admin/admin-shell-client.tsx",
         "components/templates/personal-brand/slices/admin/dashboard/DashboardView.tsx",
         "components/templates/personal-brand/slices/admin/posts/PostsList.tsx",
         "components/templates/personal-brand/slices/admin/posts/PostEditor.tsx",
@@ -124,6 +134,94 @@
       ],
       "primaryFile": "app/preview/personal-brand-os/public/page.tsx"
     },
+    {
+      "slug": "agency-studio-os",
+      "title": "Agency Studio OS",
+      "category": "website-template",
+      "description": "Full-app B2B agency / studio site — public (home, services, work + project detail, about, contact) + admin (dashboard, projects pipeline, clients, services, leads, settings). Inspired by saudivisuals.com + cescadesigns.",
+      "source": "saudivisuals.com + cescadesigns",
+      "repoPath": "app/preview/agency-studio-os",
+      "pullPaths": [
+        "app/preview/agency-studio-os",
+        "components/templates/_shared",
+        "components/templates/agency-studio",
+        "convex/templates/agency-studio-os"
+      ],
+      "files": [
+        "app/preview/agency-studio-os/robots.ts",
+        "app/preview/agency-studio-os/sitemap.ts",
+        "app/preview/agency-studio-os/opengraph-image.tsx",
+        "app/preview/agency-studio-os/public/layout.tsx",
+        "app/preview/agency-studio-os/public/page.tsx",
+        "app/preview/agency-studio-os/public/services/page.tsx",
+        "app/preview/agency-studio-os/public/portfolio/page.tsx",
+        "app/preview/agency-studio-os/public/portfolio/[slug]/page.tsx",
+        "app/preview/agency-studio-os/public/about/page.tsx",
+        "app/preview/agency-studio-os/public/contact/page.tsx",
+        "app/preview/agency-studio-os/admin/layout.tsx",
+        "app/preview/agency-studio-os/admin/page.tsx",
+        "app/preview/agency-studio-os/admin/projects/page.tsx",
+        "app/preview/agency-studio-os/admin/projects/new/page.tsx",
+        "app/preview/agency-studio-os/admin/projects/[id]/page.tsx",
+        "app/preview/agency-studio-os/admin/clients/page.tsx",
+        "app/preview/agency-studio-os/admin/services/page.tsx",
+        "app/preview/agency-studio-os/admin/leads/page.tsx",
+        "app/preview/agency-studio-os/admin/settings/page.tsx",
+        "components/templates/agency-studio/shared/types.ts",
+        "components/templates/agency-studio/shared/store.tsx",
+        "components/templates/agency-studio/shared/seed.ts",
+        "components/templates/agency-studio/shared/site-config.ts",
+        "components/templates/agency-studio/shared/nav-config.ts",
+        "components/templates/agency-studio/slices/home/HomePage.tsx",
+        "components/templates/agency-studio/slices/services/ServicesPage.tsx",
+        "components/templates/agency-studio/slices/portfolio/PortfolioListPage.tsx",
+        "components/templates/agency-studio/slices/portfolio/PortfolioDetailPage.tsx",
+        "components/templates/agency-studio/slices/about/AboutPage.tsx",
+        "components/templates/agency-studio/slices/contact/ContactPage.tsx",
+        "app/preview/agency-studio-os/admin/admin-shell-client.tsx",
+        "components/templates/agency-studio/slices/admin/dashboard/DashboardView.tsx",
+        "components/templates/agency-studio/slices/admin/projects/ProjectsList.tsx",
+        "components/templates/agency-studio/slices/admin/projects/ProjectEditor.tsx",
+        "components/templates/agency-studio/slices/admin/clients/ClientsList.tsx",
+        "components/templates/agency-studio/slices/admin/services/ServicesAdminView.tsx",
+        "components/templates/agency-studio/slices/admin/leads/LeadsView.tsx",
+        "components/templates/agency-studio/slices/admin/settings/SettingsView.tsx",
+        "convex/templates/agency-studio-os/schema.ts",
+        "convex/templates/agency-studio-os/projects.ts",
+        "convex/templates/agency-studio-os/clients.ts",
+        "convex/templates/agency-studio-os/services.ts",
+        "convex/templates/agency-studio-os/leads.ts",
+        "convex/templates/agency-studio-os/README.md"
+      ],
+      "dependencies": [
+        "next@^16",
+        "react@^19",
+        "react-dom@^19",
+        "lucide-react",
+        "@tabler/icons-react",
+        "sonner",
+        "next-themes",
+        "tailwindcss@^4",
+        "convex",
+        "@convex-dev/auth",
+        "@radix-ui/react-avatar",
+        "@radix-ui/react-dialog",
+        "@radix-ui/react-label",
+        "@radix-ui/react-separator",
+        "@radix-ui/react-slot"
+      ],
+      "agentRecipe": "Agency Studio OS = full-app B2B agency template (public + admin). 1) Move app/preview/agency-studio-os/{robots,sitemap,opengraph-image}.* to app root. 2) Copy public into app/(public)/, admin into app/(admin)/. 3) Edit components/templates/agency-studio/shared/site-config.ts — set studioName, brandName, baseUrl, twitter, email. 4) Wire convex/templates/agency-studio-os/* to convex/_generated and add @convex-dev/auth on admin routes. 5) Replace localStorage StoreProvider with Convex queries.",
+      "tags": [
+        "template",
+        "agency",
+        "studio",
+        "portfolio",
+        "b2b",
+        "admin",
+        "saas"
+      ],
+      "primaryFile": "app/preview/agency-studio-os/public/page.tsx"
+    },
     {
       "slug": "landing-hero-carousel",
       "title": "Landing — Hero Carousel",
@@ -286,6 +384,147 @@
         "storefront"
       ],
       "primaryFile": "README.md"
+    },
+    {
+      "slug": "saas-marketing-os",
+      "title": "SaaS Marketing OS",
+      "category": "website-template",
+      "status": "stable",
+      "description": "Public-only marketing site for a SaaS product — landing, pricing, features, blog, changelog, about, contact. MDX-driven blog + changelog. No admin (CMS via MDX files in repo).",
+      "source": "synthesized + mdx-blog feature",
+      "repoPath": "app/preview/saas-marketing-os",
+      "pullPaths": [
+        "app/preview/saas-marketing-os",
+        "components/templates/_shared",
+        "components/templates/saas-marketing"
+      ],
+      "files": [
+        "app/preview/saas-marketing-os/public/layout.tsx",
+        "app/preview/saas-marketing-os/public/page.tsx",
+        "app/preview/saas-marketing-os/public/pricing/page.tsx",
+        "app/preview/saas-marketing-os/public/features/page.tsx",
+        "app/preview/saas-marketing-os/public/blog/page.tsx",
+        "app/preview/saas-marketing-os/public/blog/[slug]/page.tsx",
+        "app/preview/saas-marketing-os/public/changelog/page.tsx",
+        "app/preview/saas-marketing-os/public/about/page.tsx",
+        "app/preview/saas-marketing-os/public/contact/page.tsx",
+        "components/templates/saas-marketing/shared/site-config.ts",
+        "components/templates/saas-marketing/shared/nav-config.ts",
+        "components/templates/saas-marketing/shared/types.ts",
+        "components/templates/saas-marketing/shared/store.tsx",
+        "components/templates/saas-marketing/shared/seed.ts",
+        "components/templates/saas-marketing/slices/home/HomePage.tsx",
+        "components/templates/saas-marketing/slices/pricing/PricingPage.tsx",
+        "components/templates/saas-marketing/slices/features/FeaturesPage.tsx",
+        "components/templates/saas-marketing/slices/blog/BlogList.tsx",
+        "components/templates/saas-marketing/slices/blog/BlogDetail.tsx",
+        "components/templates/saas-marketing/slices/changelog/ChangelogPage.tsx",
+        "components/templates/saas-marketing/slices/about/AboutPage.tsx",
+        "components/templates/saas-marketing/slices/contact/ContactPage.tsx"
+      ],
+      "dependencies": [
+        "next@^16",
+        "react@^19",
+        "react-dom@^19",
+        "lucide-react",
+        "sonner",
+        "next-themes",
+        "tailwindcss@^4",
+        "@radix-ui/react-slot"
+      ],
+      "agentRecipe": "SaaS Marketing OS = public-only marketing template. Blog + changelog use MDX (add the mdx-blog feature). Edit components/templates/saas-marketing/shared/site-config.ts to set product name, tagline, pricing tiers, contact email.",
+      "tags": [
+        "template",
+        "saas",
+        "marketing",
+        "mdx",
+        "blog",
+        "changelog"
+      ],
+      "primaryFile": "app/preview/saas-marketing-os/public/page.tsx"
+    },
+    {
+      "slug": "kreator-studio-os",
+      "title": "Kreator Studio OS",
+      "category": "website-template",
+      "status": "coming-soon",
+      "description": "Creator/influencer studio — newsletter-first public site + admin for posts, drops, audience segments. Resend + Midtrans tip jar. Coming soon.",
+      "source": "synthesized",
+      "repoPath": "app/preview/kreator-studio-os",
+      "pullPaths": [],
+      "files": [],
+      "dependencies": [],
+      "agentRecipe": "Coming soon — track at /build for updates.",
+      "tags": [
+        "template",
+        "creator",
+        "newsletter",
+        "coming-soon"
+      ],
+      "primaryFile": "README.md"
+    },
+    {
+      "slug": "konsultan-os",
+      "title": "Konsultan OS",
+      "category": "website-template",
+      "status": "coming-soon",
+      "description": "Consultancy site — services catalog, case studies, booking via Cal.com, Midtrans deposits. Public + lightweight admin. Coming soon.",
+      "source": "synthesized",
+      "repoPath": "app/preview/konsultan-os",
+      "pullPaths": [],
+      "files": [],
+      "dependencies": [],
+      "agentRecipe": "Coming soon — track at /build for updates.",
+      "tags": [
+        "template",
+        "consultant",
+        "booking",
+        "coming-soon"
+      ],
+      "primaryFile": "README.md"
+    },
+    {
+      "slug": "wirausaha-os",
+      "title": "Wirausaha OS",
+      "category": "website-template",
+      "status": "coming-soon",
+      "description": "Indonesian SMB toolkit — public storefront + admin (catalog, orders, Midtrans + QRIS, leads). Bahasa Indonesia first. Coming soon.",
+      "source": "synthesized",
+      "repoPath": "app/preview/wirausaha-os",
+      "pullPaths": [],
+      "files": [],
+      "dependencies": [],
+      "agentRecipe": "Coming soon — track at /build for updates.",
+      "tags": [
+        "template",
+        "smb",
+        "ecommerce",
+        "midtrans",
+        "indonesia",
+        "coming-soon"
+      ],
+      "primaryFile": "README.md"
+    },
+    {
+      "slug": "riset-kit",
+      "title": "Riset Kit",
+      "category": "website-template",
+      "status": "coming-soon",
+      "description": "Research / knowledge-base template — Convex vector search + MDX + threaded comments. Public reading + admin authoring. Coming soon.",
+      "source": "synthesized",
+      "repoPath": "app/preview/riset-kit",
+      "pullPaths": [],
+      "files": [],
+      "dependencies": [],
+      "agentRecipe": "Coming soon — track at /build for updates.",
+      "tags": [
+        "template",
+        "research",
+        "knowledge-base",
+        "vector-search",
+        "coming-soon"
+      ],
+      "primaryFile": "README.md"
     }
   ],
   "recipes": [

package/lib/post-init.mjs

@@ -0,0 +1,102 @@
+// Post-init restructure — runs after `rahman-resources init` finishes copying
+// the bundled starter into the target dir. Steps:
+//
+//   1. Patch components.json with vertical-slice aliases (shared, templates,
+//      slices, features) so future shadcn add commands respect our layout.
+//   2. Write rr.json (project manifest).
+//   3. Patch tsconfig.json paths to mirror the rr.json aliases.
+//
+// Idempotent — safe to re-run. Each step compares before mutating.
+
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import path from "node:path";
+
+import { DEFAULT_RR, writeRr, buildRr } from "./rr.mjs";
+
+const RR_ALIASES_TO_TSCONFIG = {
+  // alias -> tsconfig key target relative-path
+  "@/components/templates/_shared": "components/templates/_shared",
+  "@/components/templates": "components/templates",
+  "@/features": "features",
+};
+
+export function runPostInit(targetDir, opts = {}) {
+  const out = { changed: [], skipped: [] };
+
+  patchComponentsJson(targetDir, out);
+  writeRrJson(targetDir, opts, out);
+  patchTsconfig(targetDir, out);
+
+  return out;
+}
+
+function patchComponentsJson(targetDir, out) {
+  const p = path.join(targetDir, "components.json");
+  if (!existsSync(p)) {
+    out.skipped.push("components.json (not found — run shadcn init first)");
+    return;
+  }
+  const cj = JSON.parse(readFileSync(p, "utf8"));
+  cj.aliases = cj.aliases ?? {};
+  const before = JSON.stringify(cj.aliases);
+  cj.aliases.shared = cj.aliases.shared ?? "@/components/templates/_shared";
+  cj.aliases.templates = cj.aliases.templates ?? "@/components/templates";
+  cj.aliases.slices = cj.aliases.slices ?? "@/components/templates/{template}/slices";
+  cj.aliases.features = cj.aliases.features ?? "@/features";
+  if (JSON.stringify(cj.aliases) !== before) {
+    writeFileSync(p, JSON.stringify(cj, null, 2) + "\n");
+    out.changed.push("components.json (aliases)");
+  } else {
+    out.skipped.push("components.json (already patched)");
+  }
+}
+
+function writeRrJson(targetDir, opts, out) {
+  const p = path.join(targetDir, "rr.json");
+  if (existsSync(p)) {
+    out.skipped.push("rr.json (already exists)");
+    return;
+  }
+  const rr = buildRr({
+    template: opts.template,
+    features: opts.features,
+    skills: opts.skills,
+    templateVersion: opts.templateVersion,
+  });
+  writeRr(rr, targetDir);
+  out.changed.push("rr.json (created)");
+}
+
+function patchTsconfig(targetDir, out) {
+  const p = path.join(targetDir, "tsconfig.json");
+  if (!existsSync(p)) {
+    out.skipped.push("tsconfig.json (not found)");
+    return;
+  }
+  let raw = readFileSync(p, "utf8");
+  let cfg;
+  try { cfg = JSON.parse(raw); } catch {
+    out.skipped.push("tsconfig.json (parse failed — likely has comments; skipped)");
+    return;
+  }
+  cfg.compilerOptions = cfg.compilerOptions ?? {};
+  cfg.compilerOptions.paths = cfg.compilerOptions.paths ?? {};
+  const paths = cfg.compilerOptions.paths;
+  const before = JSON.stringify(paths);
+  paths["@/*"] = paths["@/*"] ?? ["./*"];
+  // Keep tsconfig minimal — @/* covers all aliases. Don't bloat with redundant entries.
+  if (JSON.stringify(paths) !== before) {
+    writeFileSync(p, JSON.stringify(cfg, null, 2) + "\n");
+    out.changed.push("tsconfig.json (paths)");
+  } else {
+    out.skipped.push("tsconfig.json (already configured)");
+  }
+}
+
+// Allow running as a CLI script for re-restructure on existing projects.
+if (import.meta.url === `file://${process.argv[1]}`) {
+  const target = process.argv[2] ?? process.cwd();
+  const result = runPostInit(target);
+  for (const c of result.changed) console.log("  +", c);
+  for (const s of result.skipped) console.log("  -", s);
+}

package/lib/rr-schema.json

@@ -0,0 +1,94 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://rahmanef63.github.io/resource-site/rr.schema.json",
+  "title": "rr.json — Rahman Resources project manifest",
+  "description": "Project-local manifest written by `rahman-resources init` and patched by `add` / `add-skill` / `upgrade`. Mirrors what shadcn's components.json does for shadcn, but for the vertical-slice kitab flow (templates + features + Claude skills).",
+  "type": "object",
+  "required": ["version", "framework", "aliases", "layout"],
+  "additionalProperties": true,
+  "properties": {
+    "$schema": { "type": "string" },
+    "version": { "type": "integer", "minimum": 1 },
+    "framework": { "type": "string", "enum": ["next-16", "next-15", "vite", "remix"] },
+    "style": { "type": "string", "default": "shadcn-new-york" },
+    "rsc": { "type": "boolean", "default": true },
+    "tailwind": {
+      "type": "object",
+      "properties": {
+        "config": { "type": "string" },
+        "css": { "type": "string" }
+      }
+    },
+    "aliases": {
+      "type": "object",
+      "required": ["components", "ui", "shared", "templates", "lib"],
+      "properties": {
+        "components": { "type": "string" },
+        "ui": { "type": "string" },
+        "shared": { "type": "string", "description": "Cross-template _shared scaffolding (site-shell, admin-shell, store factory)." },
+        "templates": { "type": "string", "description": "Per-template folders root (e.g. components/templates)." },
+        "slices": { "type": "string", "description": "Optional slice-root pattern, may use {template} placeholder." },
+        "features": { "type": "string" },
+        "convex": { "type": "string" },
+        "lib": { "type": "string" },
+        "hooks": { "type": "string" }
+      }
+    },
+    "layout": {
+      "type": "object",
+      "required": ["kind"],
+      "properties": {
+        "kind": { "type": "string", "enum": ["vertical-slice", "feature-folders"] },
+        "publicRoute": { "type": "string" },
+        "adminRoute": { "type": "string" },
+        "sliceRoot": { "type": "string" }
+      }
+    },
+    "template": {
+      "type": "object",
+      "required": ["slug", "version"],
+      "properties": {
+        "slug": { "type": "string" },
+        "version": { "type": "string" }
+      }
+    },
+    "features": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["slug"],
+        "properties": {
+          "slug": { "type": "string" },
+          "version": { "type": "string" },
+          "addedAt": { "type": "string", "format": "date" }
+        }
+      }
+    },
+    "skills": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["slug", "source"],
+        "properties": {
+          "slug": { "type": "string" },
+          "source": { "type": "string", "enum": ["anthropics", "rahman", "custom"] },
+          "version": { "type": "string", "default": "main" },
+          "addedAt": { "type": "string", "format": "date" }
+        }
+      }
+    },
+    "auth": {
+      "type": "object",
+      "properties": {
+        "provider": { "type": "string", "enum": ["convex-auth", "clerk", "next-auth", "none"] }
+      }
+    },
+    "convex": {
+      "type": "object",
+      "properties": {
+        "self_hosted": { "type": "boolean" },
+        "deploymentUrl": { "type": "string" }
+      }
+    }
+  }
+}

package/lib/rr.mjs

@@ -0,0 +1,134 @@
+// Read / write / validate rr.json — the project-local Rahman Resources manifest.
+//
+// Schema lives at lib/rr-schema.json (JSON Schema draft-07). Validation is
+// hand-rolled (shape-only) to avoid pulling in ajv as a runtime dep — the CLI
+// stays small. Full schema validation is available via `npx ajv` if desired.
+
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import path from "node:path";
+
+const RR_FILENAME = "rr.json";
+const SCHEMA_URL = "https://rahmanef63.github.io/resource-site/rr.schema.json";
+
+export const DEFAULT_RR = {
+  $schema: SCHEMA_URL,
+  version: 1,
+  framework: "next-16",
+  style: "shadcn-new-york",
+  rsc: true,
+  tailwind: { config: "tailwind.config.ts", css: "app/globals.css" },
+  aliases: {
+    components: "@/components",
+    ui: "@/components/ui",
+    shared: "@/components/templates/_shared",
+    templates: "@/components/templates",
+    slices: "@/components/templates/{template}/slices",
+    features: "@/features",
+    convex: "@/convex",
+    lib: "@/lib",
+    hooks: "@/hooks",
+  },
+  layout: {
+    kind: "vertical-slice",
+    publicRoute: "app/(public)",
+    adminRoute: "app/(admin)",
+    sliceRoot: "components/templates",
+  },
+  template: null,
+  features: [],
+  skills: [],
+  auth: { provider: "convex-auth" },
+  convex: { self_hosted: true },
+};
+
+export function rrPath(targetDir = process.cwd()) {
+  return path.join(targetDir, RR_FILENAME);
+}
+
+export function rrExists(targetDir = process.cwd()) {
+  return existsSync(rrPath(targetDir));
+}
+
+export function readRr(targetDir = process.cwd()) {
+  const p = rrPath(targetDir);
+  if (!existsSync(p)) throw new Error(`No rr.json at ${p}. Run 'rahman-resources init' first.`);
+  try {
+    return JSON.parse(readFileSync(p, "utf8"));
+  } catch (err) {
+    throw new Error(`Failed to parse ${p}: ${err.message}`);
+  }
+}
+
+export function writeRr(rr, targetDir = process.cwd()) {
+  const p = rrPath(targetDir);
+  writeFileSync(p, JSON.stringify(rr, null, 2) + "\n");
+  return p;
+}
+
+export function buildRr(opts = {}) {
+  const rr = JSON.parse(JSON.stringify(DEFAULT_RR));
+  if (opts.template) {
+    rr.template = { slug: opts.template, version: opts.templateVersion ?? "main" };
+  }
+  if (opts.features?.length) {
+    const stamp = today();
+    rr.features = opts.features.map((slug) => ({ slug, version: opts.templateVersion ?? "main", addedAt: stamp }));
+  }
+  if (opts.skills?.length) {
+    const stamp = today();
+    rr.skills = opts.skills.map((s) => {
+      if (typeof s === "string") return { slug: s, source: "anthropics", version: "main", addedAt: stamp };
+      return { source: "anthropics", version: "main", addedAt: stamp, ...s };
+    });
+  }
+  return rr;
+}
+
+export function addFeature(rr, slug, version = "main") {
+  rr.features = rr.features ?? [];
+  if (rr.features.find((f) => f.slug === slug)) return rr;
+  rr.features.push({ slug, version, addedAt: today() });
+  return rr;
+}
+
+export function addSkill(rr, slug, source = "anthropics", version = "main") {
+  rr.skills = rr.skills ?? [];
+  if (rr.skills.find((s) => s.slug === slug && s.source === source)) return rr;
+  rr.skills.push({ slug, source, version, addedAt: today() });
+  return rr;
+}
+
+export function removeFeature(rr, slug) {
+  rr.features = (rr.features ?? []).filter((f) => f.slug !== slug);
+  return rr;
+}
+
+export function removeSkill(rr, slug) {
+  rr.skills = (rr.skills ?? []).filter((s) => s.slug !== slug);
+  return rr;
+}
+
+// Shape-only validation — returns string[] of issues (empty = ok).
+export function validateRr(rr) {
+  const issues = [];
+  if (!rr || typeof rr !== "object") return ["rr.json is not an object"];
+  if (typeof rr.version !== "number") issues.push("version must be a number");
+  if (!rr.framework) issues.push("framework is required");
+  if (!rr.aliases || typeof rr.aliases !== "object") issues.push("aliases is required");
+  else {
+    for (const k of ["components", "ui", "shared", "templates", "lib"]) {
+      if (typeof rr.aliases[k] !== "string") issues.push(`aliases.${k} must be a string`);
+    }
+  }
+  if (!rr.layout || typeof rr.layout !== "object") issues.push("layout is required");
+  else if (!["vertical-slice", "feature-folders"].includes(rr.layout.kind)) {
+    issues.push(`layout.kind must be vertical-slice|feature-folders (got ${rr.layout.kind})`);
+  }
+  if (rr.features && !Array.isArray(rr.features)) issues.push("features must be an array");
+  if (rr.skills && !Array.isArray(rr.skills)) issues.push("skills must be an array");
+  return issues;
+}
+
+function today() {
+  return new Date().toISOString().slice(0, 10);
+}

package/lib/skills.json

@@ -0,0 +1,154 @@
+{
+  "_meta": {
+    "description": "Claude Skills inventory — 18 entries (sync'd from site/lib/content/claude-skills.ts). Used by CLI add-skill + builder UI + MCP server.",
+    "anthropicsRepo": "anthropics/skills",
+    "branch": "main",
+    "lastSynced": "2026-05-05"
+  },
+  "skills": [
+    {
+      "slug": "algorithmic-art",
+      "title": "Algorithmic Art",
+      "category": "creative",
+      "source": "anthropics",
+      "path": "skills/algorithmic-art",
+      "description": "Generate generative-art pieces (p5.js, processing-style algorithms)."
+    },
+    {
+      "slug": "brand-guidelines",
+      "title": "Brand Guidelines",
+      "category": "design",
+      "source": "anthropics",
+      "path": "skills/brand-guidelines",
+      "description": "Apply a brand's visual language consistently across artifacts."
+    },
+    {
+      "slug": "canvas-design",
+      "title": "Canvas Design",
+      "category": "design",
+      "source": "anthropics",
+      "path": "skills/canvas-design",
+      "description": "Design canvas layouts (Canva-style) — slides, posters, social posts."
+    },
+    {
+      "slug": "claude-api",
+      "title": "Claude API",
+      "category": "development",
+      "source": "anthropics",
+      "path": "skills/claude-api",
+      "description": "Call the Claude API correctly — auth, models, tools, streaming patterns."
+    },
+    {
+      "slug": "doc-coauthoring",
+      "title": "Doc Co-authoring",
+      "category": "enterprise",
+      "source": "anthropics",
+      "path": "skills/doc-coauthoring",
+      "description": "Collaborate on long-form documents with section-aware editing."
+    },
+    {
+      "slug": "docx",
+      "title": "DOCX",
+      "category": "documents",
+      "source": "anthropics",
+      "path": "skills/docx",
+      "description": "Read, write, and edit Microsoft Word .docx files."
+    },
+    {
+      "slug": "frontend-design",
+      "title": "Frontend Design",
+      "category": "development",
+      "source": "anthropics",
+      "path": "skills/frontend-design",
+      "description": "Design and build polished frontend UIs with modern patterns."
+    },
+    {
+      "slug": "internal-comms",
+      "title": "Internal Comms",
+      "category": "enterprise",
+      "source": "anthropics",
+      "path": "skills/internal-comms",
+      "description": "Draft internal company communications (announcements, memos, all-hands)."
+    },
+    {
+      "slug": "mcp-builder",
+      "title": "MCP Builder",
+      "category": "development",
+      "source": "anthropics",
+      "path": "skills/mcp-builder",
+      "description": "Build Model Context Protocol servers — tools, resources, transports."
+    },
+    {
+      "slug": "pdf",
+      "title": "PDF",
+      "category": "documents",
+      "source": "anthropics",
+      "path": "skills/pdf",
+      "description": "Read, fill, and generate PDF files."
+    },
+    {
+      "slug": "pptx",
+      "title": "PPTX",
+      "category": "documents",
+      "source": "anthropics",
+      "path": "skills/pptx",
+      "description": "Read, write, and edit Microsoft PowerPoint .pptx files."
+    },
+    {
+      "slug": "skill-creator",
+      "title": "Skill Creator",
+      "category": "development",
+      "source": "anthropics",
+      "path": "skills/skill-creator",
+      "description": "Create new Claude Skills — scaffold SKILL.md, references, scripts."
+    },
+    {
+      "slug": "slack-gif-creator",
+      "title": "Slack GIF Creator",
+      "category": "creative",
+      "source": "anthropics",
+      "path": "skills/slack-gif-creator",
+      "description": "Make small animated GIFs for Slack reactions and team messaging."
+    },
+    {
+      "slug": "theme-factory",
+      "title": "Theme Factory",
+      "category": "design",
+      "source": "anthropics",
+      "path": "skills/theme-factory",
+      "description": "Generate cohesive design-system themes (colors, typography, spacing)."
+    },
+    {
+      "slug": "web-artifacts-builder",
+      "title": "Web Artifacts Builder",
+      "category": "development",
+      "source": "anthropics",
+      "path": "skills/web-artifacts-builder",
+      "description": "Build self-contained web artifacts (HTML/CSS/JS) for Claude artifacts surface."
+    },
+    {
+      "slug": "webapp-testing",
+      "title": "Webapp Testing",
+      "category": "development",
+      "source": "anthropics",
+      "path": "skills/webapp-testing",
+      "description": "Test web applications — Playwright/Puppeteer flows, snapshot, a11y."
+    },
+    {
+      "slug": "xlsx",
+      "title": "XLSX",
+      "category": "documents",
+      "source": "anthropics",
+      "path": "skills/xlsx",
+      "description": "Read, write, and edit Microsoft Excel .xlsx files."
+    },
+    {
+      "slug": "rahman-resources",
+      "title": "Rahman Resources",
+      "category": "development",
+      "source": "rahman",
+      "path": "skills/rahman-resources",
+      "description": "Use the Rahman Resources kitab — discover templates, features, recipes; assemble bundles; emit npx commands."
+    }
+  ]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rahman-resources",
-  "version": "0.3.0",
+  "version": "0.4.2",
   "description": "Scaffolder + installer for Rahman Resources kitab — npx rahman-resources init <app>; add <template>; list; info",
   "type": "module",
   "license": "MIT",
@@ -25,7 +25,9 @@
   "scripts": {
     "gen": "node scripts/gen-manifest.mjs",
     "validate": "node scripts/validate.mjs",
-    "prepublishOnly": "node scripts/validate.mjs"
+    "sync:skills": "node scripts/sync-skills.mjs",
+    "sync:skills:check": "node scripts/sync-skills.mjs --check",
+    "prepublishOnly": "node scripts/sync-skills.mjs --check && node scripts/validate.mjs"
   },
   "dependencies": {
     "kleur": "^4.1.5",