cursor-kit-cli 1.2.0-beta → 1.2.0-beta.3

package/dist/index.d.cts

@@ -16,14 +16,19 @@ declare function dirExists(path: string): boolean;
 declare function readFile(path: string): string;
 declare function writeFile(path: string, content: string): void;
 declare function removeFile(path: string): void;
+declare function copyDir(src: string, dest: string): void;
 declare function listFiles(dir: string, extension?: string): string[];
+declare function listDirs(dir: string): string[];
 declare function getCursorDir(cwd?: string): string;
 declare function getCommandsDir(cwd?: string): string;
 declare function getRulesDir(cwd?: string): string;
+declare function getSkillsDir(cwd?: string): string;
 declare function resolveFromCwd(...paths: string[]): string;
 declare function getPackageJson(cwd?: string): Record<string, unknown> | null;
 declare function getConflictingFiles(dir: string, files: string[]): string[];
+declare function getConflictingDirs(dir: string, dirs: string[]): string[];
 declare function getNonConflictingFiles(dir: string, files: string[]): string[];
+declare function getNonConflictingDirs(dir: string, dirs: string[]): string[];
 
 declare const REPO_URL = "github:duongductrong/cursor-kit";
 declare const REPO_REF = "master";
@@ -31,12 +36,15 @@ declare const REPO_RAW_URL = "https://raw.githubusercontent.com/duongductrong/cu
 declare const CURSOR_DIR = ".cursor";
 declare const COMMANDS_DIR = "commands";
 declare const RULES_DIR = "rules";
+declare const SKILLS_DIR = "skills";
 declare const COMMAND_EXTENSION = ".md";
 declare const RULE_EXTENSION = ".mdc";
+declare const SKILL_EXTENSION = ".mdc";
 declare const CONFIG_FILE = ".cursorkit";
 declare const TEMPLATE_PATHS: {
     readonly commands: "templates/commands";
     readonly rules: "templates/rules";
+    readonly skills: "templates/skills";
 };
 
-export { COMMANDS_DIR, COMMAND_EXTENSION, CONFIG_FILE, CURSOR_DIR, REPO_RAW_URL, REPO_REF, REPO_URL, RULES_DIR, RULE_EXTENSION, TEMPLATE_PATHS, bold, dim, dirExists, ensureDir, fileExists, getCommandsDir, getConflictingFiles, getCursorDir, getNonConflictingFiles, getPackageJson, getRulesDir, gradientText, highlight, listFiles, printBanner, printDivider, printError, printInfo, printSuccess, printVersion, printWarning, readFile, removeFile, resolveFromCwd, writeFile };
+export { COMMANDS_DIR, COMMAND_EXTENSION, CONFIG_FILE, CURSOR_DIR, REPO_RAW_URL, REPO_REF, REPO_URL, RULES_DIR, RULE_EXTENSION, SKILLS_DIR, SKILL_EXTENSION, TEMPLATE_PATHS, bold, copyDir, dim, dirExists, ensureDir, fileExists, getCommandsDir, getConflictingDirs, getConflictingFiles, getCursorDir, getNonConflictingDirs, getNonConflictingFiles, getPackageJson, getRulesDir, getSkillsDir, gradientText, highlight, listDirs, listFiles, printBanner, printDivider, printError, printInfo, printSuccess, printVersion, printWarning, readFile, removeFile, resolveFromCwd, writeFile };

package/dist/index.d.ts

@@ -16,14 +16,19 @@ declare function dirExists(path: string): boolean;
 declare function readFile(path: string): string;
 declare function writeFile(path: string, content: string): void;
 declare function removeFile(path: string): void;
+declare function copyDir(src: string, dest: string): void;
 declare function listFiles(dir: string, extension?: string): string[];
+declare function listDirs(dir: string): string[];
 declare function getCursorDir(cwd?: string): string;
 declare function getCommandsDir(cwd?: string): string;
 declare function getRulesDir(cwd?: string): string;
+declare function getSkillsDir(cwd?: string): string;
 declare function resolveFromCwd(...paths: string[]): string;
 declare function getPackageJson(cwd?: string): Record<string, unknown> | null;
 declare function getConflictingFiles(dir: string, files: string[]): string[];
+declare function getConflictingDirs(dir: string, dirs: string[]): string[];
 declare function getNonConflictingFiles(dir: string, files: string[]): string[];
+declare function getNonConflictingDirs(dir: string, dirs: string[]): string[];
 
 declare const REPO_URL = "github:duongductrong/cursor-kit";
 declare const REPO_REF = "master";
@@ -31,12 +36,15 @@ declare const REPO_RAW_URL = "https://raw.githubusercontent.com/duongductrong/cu
 declare const CURSOR_DIR = ".cursor";
 declare const COMMANDS_DIR = "commands";
 declare const RULES_DIR = "rules";
+declare const SKILLS_DIR = "skills";
 declare const COMMAND_EXTENSION = ".md";
 declare const RULE_EXTENSION = ".mdc";
+declare const SKILL_EXTENSION = ".mdc";
 declare const CONFIG_FILE = ".cursorkit";
 declare const TEMPLATE_PATHS: {
     readonly commands: "templates/commands";
     readonly rules: "templates/rules";
+    readonly skills: "templates/skills";
 };
 
-export { COMMANDS_DIR, COMMAND_EXTENSION, CONFIG_FILE, CURSOR_DIR, REPO_RAW_URL, REPO_REF, REPO_URL, RULES_DIR, RULE_EXTENSION, TEMPLATE_PATHS, bold, dim, dirExists, ensureDir, fileExists, getCommandsDir, getConflictingFiles, getCursorDir, getNonConflictingFiles, getPackageJson, getRulesDir, gradientText, highlight, listFiles, printBanner, printDivider, printError, printInfo, printSuccess, printVersion, printWarning, readFile, removeFile, resolveFromCwd, writeFile };
+export { COMMANDS_DIR, COMMAND_EXTENSION, CONFIG_FILE, CURSOR_DIR, REPO_RAW_URL, REPO_REF, REPO_URL, RULES_DIR, RULE_EXTENSION, SKILLS_DIR, SKILL_EXTENSION, TEMPLATE_PATHS, bold, copyDir, dim, dirExists, ensureDir, fileExists, getCommandsDir, getConflictingDirs, getConflictingFiles, getCursorDir, getNonConflictingDirs, getNonConflictingFiles, getPackageJson, getRulesDir, getSkillsDir, gradientText, highlight, listDirs, listFiles, printBanner, printDivider, printError, printInfo, printSuccess, printVersion, printWarning, readFile, removeFile, resolveFromCwd, writeFile };

package/dist/index.js

@@ -52,7 +52,7 @@ function gradientText(text) {
 }
 
 // src/utils/fs.ts
-import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync, rmSync, statSync } from "fs";
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync, rmSync, statSync, cpSync } from "fs";
 import { dirname, join, resolve } from "path";
 function ensureDir(path) {
   if (!existsSync(path)) {
@@ -77,6 +77,9 @@ function removeFile(path) {
     rmSync(path, { recursive: true });
   }
 }
+function copyDir(src, dest) {
+  cpSync(src, dest, { recursive: true });
+}
 function listFiles(dir, extension) {
   if (!dirExists(dir)) return [];
   const files = readdirSync(dir);
@@ -85,6 +88,13 @@ function listFiles(dir, extension) {
   }
   return files;
 }
+function listDirs(dir) {
+  if (!dirExists(dir)) return [];
+  return readdirSync(dir).filter((item) => {
+    const itemPath = join(dir, item);
+    return statSync(itemPath).isDirectory();
+  });
+}
 function getCursorDir(cwd = process.cwd()) {
   return join(cwd, ".cursor");
 }
@@ -94,6 +104,9 @@ function getCommandsDir(cwd = process.cwd()) {
 function getRulesDir(cwd = process.cwd()) {
   return join(getCursorDir(cwd), "rules");
 }
+function getSkillsDir(cwd = process.cwd()) {
+  return join(getCursorDir(cwd), "skills");
+}
 function resolveFromCwd(...paths) {
   return resolve(process.cwd(), ...paths);
 }
@@ -110,10 +123,18 @@ function getConflictingFiles(dir, files) {
   if (!dirExists(dir)) return [];
   return files.filter((file) => fileExists(join(dir, file)));
 }
+function getConflictingDirs(dir, dirs) {
+  if (!dirExists(dir)) return [];
+  return dirs.filter((d) => dirExists(join(dir, d)));
+}
 function getNonConflictingFiles(dir, files) {
   if (!dirExists(dir)) return files;
   return files.filter((file) => !fileExists(join(dir, file)));
 }
+function getNonConflictingDirs(dir, dirs) {
+  if (!dirExists(dir)) return dirs;
+  return dirs.filter((d) => !dirExists(join(dir, d)));
+}
 
 // src/utils/constants.ts
 var REPO_URL = "github:duongductrong/cursor-kit";
@@ -122,12 +143,15 @@ var REPO_RAW_URL = "https://raw.githubusercontent.com/duongductrong/cursor-kit/m
 var CURSOR_DIR = ".cursor";
 var COMMANDS_DIR = "commands";
 var RULES_DIR = "rules";
+var SKILLS_DIR = "skills";
 var COMMAND_EXTENSION = ".md";
 var RULE_EXTENSION = ".mdc";
+var SKILL_EXTENSION = ".mdc";
 var CONFIG_FILE = ".cursorkit";
 var TEMPLATE_PATHS = {
   commands: "templates/commands",
-  rules: "templates/rules"
+  rules: "templates/rules",
+  skills: "templates/skills"
 };
 export {
   COMMANDS_DIR,
@@ -139,20 +163,27 @@ export {
   REPO_URL,
   RULES_DIR,
   RULE_EXTENSION,
+  SKILLS_DIR,
+  SKILL_EXTENSION,
   TEMPLATE_PATHS,
   bold,
+  copyDir,
   dim,
   dirExists,
   ensureDir,
   fileExists,
   getCommandsDir,
+  getConflictingDirs,
   getConflictingFiles,
   getCursorDir,
+  getNonConflictingDirs,
   getNonConflictingFiles,
   getPackageJson,
   getRulesDir,
+  getSkillsDir,
   gradientText,
   highlight,
+  listDirs,
   listFiles,
   printBanner,
   printDivider,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/utils/branding.ts","../src/utils/fs.ts","../src/utils/constants.ts"],"sourcesContent":["import figlet from \"figlet\";\nimport gradient from \"gradient-string\";\nimport pc from \"picocolors\";\n\nconst cursorGradient = gradient([\"#00DC82\", \"#36E4DA\", \"#0047E1\"]);\n\nexport function printBanner(): void {\n  const banner = figlet.textSync(\"Cursor Kit\", {\n    font: \"ANSI Shadow\",\n    horizontalLayout: \"fitted\",\n  });\n\n  console.log(cursorGradient.multiline(banner));\n  console.log();\n  console.log(\n    pc.dim(\"  \") +\n      pc.bold(pc.cyan(\"✦\")) +\n      pc.dim(\" Supercharge your Cursor IDE with rules & commands\")\n  );\n  console.log();\n}\n\nexport function printSuccess(message: string): void {\n  console.log(pc.green(\"✓\") + pc.dim(\" \") + message);\n}\n\nexport function printError(message: string): void {\n  console.log(pc.red(\"✗\") + pc.dim(\" \") + message);\n}\n\nexport function printInfo(message: string): void {\n  console.log(pc.cyan(\"ℹ\") + pc.dim(\" \") + message);\n}\n\nexport function printWarning(message: string): void {\n  console.log(pc.yellow(\"⚠\") + pc.dim(\" \") + message);\n}\n\nexport function printDivider(): void {\n  console.log(pc.dim(\"─\".repeat(50)));\n}\n\nexport function printVersion(version: string): void {\n  console.log(\n    pc.dim(\"  \") + cursorGradient(`v${version}`) + pc.dim(\" • Made with ♥\")\n  );\n  console.log();\n}\n\nexport function highlight(text: string): string {\n  return pc.cyan(text);\n}\n\nexport function dim(text: string): string {\n  return pc.dim(text);\n}\n\nexport function bold(text: string): string {\n  return pc.bold(text);\n}\n\nexport function gradientText(text: string): string {\n  return cursorGradient(text);\n}\n\n","import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync, rmSync, statSync } from \"node:fs\";\nimport { dirname, join, resolve } from \"node:path\";\n\nexport function ensureDir(path: string): void {\n  if (!existsSync(path)) {\n    mkdirSync(path, { recursive: true });\n  }\n}\n\nexport function fileExists(path: string): boolean {\n  return existsSync(path);\n}\n\nexport function dirExists(path: string): boolean {\n  return existsSync(path) && statSync(path).isDirectory();\n}\n\nexport function readFile(path: string): string {\n  return readFileSync(path, \"utf-8\");\n}\n\nexport function writeFile(path: string, content: string): void {\n  ensureDir(dirname(path));\n  writeFileSync(path, content, \"utf-8\");\n}\n\nexport function removeFile(path: string): void {\n  if (existsSync(path)) {\n    rmSync(path, { recursive: true });\n  }\n}\n\nexport function listFiles(dir: string, extension?: string): string[] {\n  if (!dirExists(dir)) return [];\n  \n  const files = readdirSync(dir);\n  if (extension) {\n    return files.filter((f) => f.endsWith(extension));\n  }\n  return files;\n}\n\nexport function getCursorDir(cwd: string = process.cwd()): string {\n  return join(cwd, \".cursor\");\n}\n\nexport function getCommandsDir(cwd: string = process.cwd()): string {\n  return join(getCursorDir(cwd), \"commands\");\n}\n\nexport function getRulesDir(cwd: string = process.cwd()): string {\n  return join(getCursorDir(cwd), \"rules\");\n}\n\nexport function resolveFromCwd(...paths: string[]): string {\n  return resolve(process.cwd(), ...paths);\n}\n\nexport function getPackageJson(cwd: string = process.cwd()): Record<string, unknown> | null {\n  const pkgPath = join(cwd, \"package.json\");\n  if (!fileExists(pkgPath)) return null;\n  \n  try {\n    return JSON.parse(readFile(pkgPath));\n  } catch {\n    return null;\n  }\n}\n\nexport function getConflictingFiles(dir: string, files: string[]): string[] {\n  if (!dirExists(dir)) return [];\n  return files.filter((file) => fileExists(join(dir, file)));\n}\n\nexport function getNonConflictingFiles(dir: string, files: string[]): string[] {\n  if (!dirExists(dir)) return files;\n  return files.filter((file) => !fileExists(join(dir, file)));\n}\n\n","export const REPO_URL = \"github:duongductrong/cursor-kit\";\nexport const REPO_REF = \"master\";\nexport const REPO_RAW_URL = \"https://raw.githubusercontent.com/duongductrong/cursor-kit/master\";\n\nexport const CURSOR_DIR = \".cursor\";\nexport const COMMANDS_DIR = \"commands\";\nexport const RULES_DIR = \"rules\";\n\nexport const COMMAND_EXTENSION = \".md\";\nexport const RULE_EXTENSION = \".mdc\";\n\nexport const CONFIG_FILE = \".cursorkit\";\n\nexport const TEMPLATE_PATHS = {\n  commands: \"templates/commands\",\n  rules: \"templates/rules\",\n} as const;\n\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/utils/branding.ts","../src/utils/fs.ts","../src/utils/constants.ts"],"sourcesContent":["import figlet from \"figlet\";\nimport gradient from \"gradient-string\";\nimport pc from \"picocolors\";\n\nconst cursorGradient = gradient([\"#00DC82\", \"#36E4DA\", \"#0047E1\"]);\n\nexport function printBanner(): void {\n  const banner = figlet.textSync(\"Cursor Kit\", {\n    font: \"ANSI Shadow\",\n    horizontalLayout: \"fitted\",\n  });\n\n  console.log(cursorGradient.multiline(banner));\n  console.log();\n  console.log(\n    pc.dim(\"  \") +\n      pc.bold(pc.cyan(\"✦\")) +\n      pc.dim(\" Supercharge your Cursor IDE with rules & commands\")\n  );\n  console.log();\n}\n\nexport function printSuccess(message: string): void {\n  console.log(pc.green(\"✓\") + pc.dim(\" \") + message);\n}\n\nexport function printError(message: string): void {\n  console.log(pc.red(\"✗\") + pc.dim(\" \") + message);\n}\n\nexport function printInfo(message: string): void {\n  console.log(pc.cyan(\"ℹ\") + pc.dim(\" \") + message);\n}\n\nexport function printWarning(message: string): void {\n  console.log(pc.yellow(\"⚠\") + pc.dim(\" \") + message);\n}\n\nexport function printDivider(): void {\n  console.log(pc.dim(\"─\".repeat(50)));\n}\n\nexport function printVersion(version: string): void {\n  console.log(\n    pc.dim(\"  \") + cursorGradient(`v${version}`) + pc.dim(\" • Made with ♥\")\n  );\n  console.log();\n}\n\nexport function highlight(text: string): string {\n  return pc.cyan(text);\n}\n\nexport function dim(text: string): string {\n  return pc.dim(text);\n}\n\nexport function bold(text: string): string {\n  return pc.bold(text);\n}\n\nexport function gradientText(text: string): string {\n  return cursorGradient(text);\n}\n\n","import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync, rmSync, statSync, cpSync } from \"node:fs\";\nimport { dirname, join, resolve } from \"node:path\";\n\nexport function ensureDir(path: string): void {\n  if (!existsSync(path)) {\n    mkdirSync(path, { recursive: true });\n  }\n}\n\nexport function fileExists(path: string): boolean {\n  return existsSync(path);\n}\n\nexport function dirExists(path: string): boolean {\n  return existsSync(path) && statSync(path).isDirectory();\n}\n\nexport function readFile(path: string): string {\n  return readFileSync(path, \"utf-8\");\n}\n\nexport function writeFile(path: string, content: string): void {\n  ensureDir(dirname(path));\n  writeFileSync(path, content, \"utf-8\");\n}\n\nexport function removeFile(path: string): void {\n  if (existsSync(path)) {\n    rmSync(path, { recursive: true });\n  }\n}\n\nexport function copyDir(src: string, dest: string): void {\n  cpSync(src, dest, { recursive: true });\n}\n\nexport function listFiles(dir: string, extension?: string): string[] {\n  if (!dirExists(dir)) return [];\n  \n  const files = readdirSync(dir);\n  if (extension) {\n    return files.filter((f) => f.endsWith(extension));\n  }\n  return files;\n}\n\nexport function listDirs(dir: string): string[] {\n  if (!dirExists(dir)) return [];\n  \n  return readdirSync(dir).filter((item) => {\n    const itemPath = join(dir, item);\n    return statSync(itemPath).isDirectory();\n  });\n}\n\nexport function getCursorDir(cwd: string = process.cwd()): string {\n  return join(cwd, \".cursor\");\n}\n\nexport function getCommandsDir(cwd: string = process.cwd()): string {\n  return join(getCursorDir(cwd), \"commands\");\n}\n\nexport function getRulesDir(cwd: string = process.cwd()): string {\n  return join(getCursorDir(cwd), \"rules\");\n}\n\nexport function getSkillsDir(cwd: string = process.cwd()): string {\n  return join(getCursorDir(cwd), \"skills\");\n}\n\nexport function resolveFromCwd(...paths: string[]): string {\n  return resolve(process.cwd(), ...paths);\n}\n\nexport function getPackageJson(cwd: string = process.cwd()): Record<string, unknown> | null {\n  const pkgPath = join(cwd, \"package.json\");\n  if (!fileExists(pkgPath)) return null;\n  \n  try {\n    return JSON.parse(readFile(pkgPath));\n  } catch {\n    return null;\n  }\n}\n\nexport function getConflictingFiles(dir: string, files: string[]): string[] {\n  if (!dirExists(dir)) return [];\n  return files.filter((file) => fileExists(join(dir, file)));\n}\n\nexport function getConflictingDirs(dir: string, dirs: string[]): string[] {\n  if (!dirExists(dir)) return [];\n  return dirs.filter((d) => dirExists(join(dir, d)));\n}\n\nexport function getNonConflictingFiles(dir: string, files: string[]): string[] {\n  if (!dirExists(dir)) return files;\n  return files.filter((file) => !fileExists(join(dir, file)));\n}\n\nexport function getNonConflictingDirs(dir: string, dirs: string[]): string[] {\n  if (!dirExists(dir)) return dirs;\n  return dirs.filter((d) => !dirExists(join(dir, d)));\n}\n","export const REPO_URL = \"github:duongductrong/cursor-kit\";\nexport const REPO_REF = \"master\";\nexport const REPO_RAW_URL = \"https://raw.githubusercontent.com/duongductrong/cursor-kit/master\";\n\nexport const CURSOR_DIR = \".cursor\";\nexport const COMMANDS_DIR = \"commands\";\nexport const RULES_DIR = \"rules\";\nexport const SKILLS_DIR = \"skills\";\n\nexport const COMMAND_EXTENSION = \".md\";\nexport const RULE_EXTENSION = \".mdc\";\nexport const SKILL_EXTENSION = \".mdc\";\n\nexport const CONFIG_FILE = \".cursorkit\";\n\nexport const TEMPLATE_PATHS = {\n  commands: \"templates/commands\",\n  rules: \"templates/rules\",\n  skills: \"templates/skills\",\n} as const;\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cursor-kit-cli",
-  "version": "1.2.0-beta",
+  "version": "1.2.0-beta.3",
   "description": "CLI toolkit to manage Cursor IDE rules and commands",
   "type": "module",
   "exports": {

package/templates/commands/docs.md

@@ -1,7 +1,9 @@
 Before answering:
-- Use `toc.mdc` to pick the most relevant rules (e.g.`frontend-design.mdc`, `performance.mdc` etc..).
-- Apply ONLY those selected rules.
-- If no rule clearly matches, ignore all rules and answer normally.
+- Use `toc.mdc` to identify the most relevant **Skills** and **Rules** for this task.
+- Skills are comprehensive guides (e.g. `frontend-development`, `ui-styling`, `backend-development`).
+- Rules are concise best practices (e.g. `git.mdc`, `coding-style.mdc`).
+- Apply ONLY the selected skills/rules that match the task context.
+- If no skill or rule clearly matches, ignore all and answer normally.
 
 ## Purpose
 You are a technical writer. Your mission is to create or update documentation that is clear, accurate, and synced with the codebase.

package/templates/commands/explain.md

@@ -1,7 +1,9 @@
 Before answering:
-- Use `toc.mdc` to pick the most relevant rules (e.g.`frontend-design.mdc`, `performance.mdc` etc..).
-- Apply ONLY those selected rules.
-- If no rule clearly matches, ignore all rules and answer normally.
+- Use `toc.mdc` to identify the most relevant **Skills** and **Rules** for this task.
+- Skills are comprehensive guides (e.g. `frontend-development`, `ui-styling`, `backend-development`).
+- Rules are concise best practices (e.g. `git.mdc`, `coding-style.mdc`).
+- Apply ONLY the selected skills/rules that match the task context.
+- If no skill or rule clearly matches, ignore all and answer normally.
 
 You are a patient technical educator. Your job is to explain code or concepts clearly.
 

package/templates/commands/fix.md

@@ -1,7 +1,9 @@
 Before answering:
-- Use `toc.mdc` to pick the most relevant rules (e.g. `security.mdc`, `frontend-design.mdc`).
-- Apply ONLY those rules.
-- If none clearly match, ignore all rules.
+- Use `toc.mdc` to identify the most relevant **Skills** and **Rules** for this task.
+- Skills are comprehensive guides (e.g. `frontend-development`, `ui-styling`, `backend-development`).
+- Rules are concise best practices (e.g. `git.mdc`, `coding-style.mdc`).
+- Apply ONLY the selected skills/rules that match the task context.
+- If no skill or rule clearly matches, ignore all and answer normally.
 
 ## Purpose
 Act as an expert bug fixer. Find the root cause, apply a safe fix, and avoid regressions.

package/templates/commands/implement.md

@@ -1,7 +1,9 @@
 Before answering:
-- Use `toc.mdc` to pick the most relevant rules (e.g.`frontend-design.mdc`, `performance.mdc` etc..).
-- Apply ONLY those selected rules.
-- If no rule clearly matches, ignore all rules and answer normally.
+- Use `toc.mdc` to identify the most relevant **Skills** and **Rules** for this task.
+- Skills are comprehensive guides (e.g. `frontend-development`, `ui-styling`, `backend-development`).
+- Rules are concise best practices (e.g. `git.mdc`, `coding-style.mdc`).
+- Apply ONLY the selected skills/rules that match the task context.
+- If no skill or rule clearly matches, ignore all and answer normally.
 
 ## Purpose
 You are a senior software engineer. Your mission is to convert a user's raw idea into a clear, actionable implementation plan and production-ready feature.

package/templates/commands/refactor.md

@@ -1,7 +1,9 @@
 Before answering:
-- Use `toc.mdc` to pick the most relevant rules (e.g.`frontend-design.mdc`, `performance.mdc` etc..).
-- Apply ONLY those selected rules.
-- If no rule clearly matches, ignore all rules and answer normally.
+- Use `toc.mdc` to identify the most relevant **Skills** and **Rules** for this task.
+- Skills are comprehensive guides (e.g. `frontend-development`, `ui-styling`, `backend-development`).
+- Rules are concise best practices (e.g. `git.mdc`, `coding-style.mdc`).
+- Apply ONLY the selected skills/rules that match the task context.
+- If no skill or rule clearly matches, ignore all and answer normally.
 
 ## Purpose
 

package/templates/commands/review.md

@@ -1,7 +1,9 @@
 Before answering:
-- Use `toc.mdc` to pick the most relevant rules (e.g.`frontend-design.mdc`, `performance.mdc` etc..).
-- Apply ONLY those selected rules.
-- If no rule clearly matches, ignore all rules and answer normally.
+- Use `toc.mdc` to identify the most relevant **Skills** and **Rules** for this task.
+- Skills are comprehensive guides (e.g. `frontend-development`, `ui-styling`, `backend-development`).
+- Rules are concise best practices (e.g. `git.mdc`, `coding-style.mdc`).
+- Apply ONLY the selected skills/rules that match the task context.
+- If no skill or rule clearly matches, ignore all and answer normally.
 
 You are a senior code reviewer performing a thorough code review.
 

package/templates/commands/test.md

@@ -1,7 +1,9 @@
 Before answering:
-- Use `toc.mdc` to pick the most relevant rules (e.g.`frontend-design.mdc`, `performance.mdc` etc..).
-- Apply ONLY those selected rules.
-- If no rule clearly matches, ignore all rules and answer normally.
+- Use `toc.mdc` to identify the most relevant **Skills** and **Rules** for this task.
+- Skills are comprehensive guides (e.g. `frontend-development`, `ui-styling`, `backend-development`).
+- Rules are concise best practices (e.g. `git.mdc`, `coding-style.mdc`).
+- Apply ONLY the selected skills/rules that match the task context.
+- If no skill or rule clearly matches, ignore all and answer normally.
 
 ## Purpose
 You are a test engineering specialist. Your mission is to generate comprehensive tests for the provided code.

package/templates/manifest.json

@@ -10,14 +10,17 @@
   ],
   "rules": [
     "coding-style.mdc",
-    "frontend-design.mdc",
     "git.mdc",
-    "performance.mdc",
-    "react.mdc",
-    "security.mdc",
-    "testing.mdc",
-    "toc.mdc",
-    "typescript.mdc"
+    "toc.mdc"
+  ],
+  "skills": [
+    "aesthetic",
+    "backend-development",
+    "frontend-design",
+    "frontend-development",
+    "problem-solving",
+    "research",
+    "sequential-thinking",
+    "ui-styling"
   ]
 }
-

package/templates/rules/git.mdc

@@ -1,6 +1,4 @@
 ---
-description: Git commit and branching conventions
-globs: 
 alwaysApply: true
 ---
 

package/templates/rules/toc.mdc

@@ -2,19 +2,27 @@
 alwaysApply: true
 ---
 
-You have multiple specialized rules:
+You have multiple specialized rules organized into **Skills** (comprehensive guides with references) and **Rules** (concise best practices).
+
+## Skills
+
+- [Aesthetic](../skills/aesthetic/SKILL.mdc) - Visual design principles, storytelling, and micro-interactions for distinctive interfaces
+- [Backend Development](../skills/backend-development/SKILL.mdc) - API design, architecture, authentication, security, and DevOps patterns
+- [Frontend Design](../skills/frontend-design/SKILL.mdc) - Create distinctive, production-grade interfaces with bold aesthetics (avoid generic AI slop)
+- [Frontend Development](../skills/frontend-development/SKILL.mdc) - React/TypeScript patterns: Suspense, lazy loading, TanStack Query/Router, MUI v7, file organization
+- [UI Styling](../skills/ui-styling/SKILL.mdc) - shadcn/ui components, Tailwind CSS utilities, theming, accessibility, and canvas-based visual design
+- [Sequential Thinking](../skills/sequential-thinking/SKILL.mdc) - Structured problem-solving with revision, branching, and hypothesis verification
+- [Problem Solving](../skills/problem-solving/SKILL.mdc) - Techniques for complexity spirals, innovation blocks, meta-patterns, and scale testing
+- [Research](../skills/research/SKILL.mdc) - Systematic research methodology for technical solutions with report generation
+
+## Rules
 
-- [TypeScript](./typescript.mdc) - TypeScript best practices and code style
-- [Frontend Design](./frontend-design.mdc) - Frontend design best practices
-- [React](./react.mdc) - React component patterns and best practices
-- [Testing](./testing.mdc) - Testing standards and patterns
 - [Git](./git.mdc) - Git commit and branching conventions
-- [Security](./security.mdc) - Security best practices
 - [Coding Style](./coding-style.mdc) - Coding style and best practices
-- [Performance](./performance.mdc) - Performance best practices
 
-Routing guidelines:
+## Routing Guidelines
+
 1. For each user request, first infer which domains are relevant.
-2. Select 0–3 rules that best match the request, prefer the SINGLE most specific rule when possible.
+2. Select 0–3 rules/skills that best match the request, prefer the SINGLE most specific one when possible.
 3. If both security and performance apply, prioritize `security.mdc` first, then `performance.mdc`.
 4. If no rule clearly matches, ignore all rules and answer normally.

package/templates/skills/aesthetic/SKILL.md

@@ -0,0 +1,121 @@
+---
+name: aesthetic
+description: Create aesthetically beautiful interfaces following proven design principles. Use when building UI/UX, analyzing designs from inspiration sites, generating design images with ai-multimodal, implementing visual hierarchy and color theory, adding micro-interactions, or creating design documentation. Includes workflows for capturing and analyzing inspiration screenshots with chrome-devtools and ai-multimodal, iterative design image generation until aesthetic standards are met, and comprehensive design system guidance covering BEAUTIFUL (aesthetic principles), RIGHT (functionality/accessibility), SATISFYING (micro-interactions), and PEAK (storytelling) stages. Integrates with chrome-devtools, ai-multimodal, media-processing, ui-styling, and web-frameworks skills.
+---
+
+# Aesthetic
+
+Create aesthetically beautiful interfaces by following proven design principles and systematic workflows.
+
+## When to Use This Skill
+
+Use when:
+- Building or designing user interfaces
+- Analyzing designs from inspiration websites (Dribbble, Mobbin, Behance)
+- Generating design images and evaluating aesthetic quality
+- Implementing visual hierarchy, typography, color theory
+- Adding micro-interactions and animations
+- Creating design documentation and style guides
+- Need guidance on accessibility and design systems
+
+## Core Framework: Four-Stage Approach
+
+### 1. BEAUTIFUL: Understanding Aesthetics
+Study existing designs, identify patterns, extract principles. AI lacks aesthetic sense—standards must come from analyzing high-quality examples and aligning with market tastes.
+
+**Reference**: [`references/design-principles.md`](references/design-principles.md) - Visual hierarchy, typography, color theory, white space principles.
+
+### 2. RIGHT: Ensuring Functionality
+Beautiful designs lacking usability are worthless. Study design systems, component architecture, accessibility requirements.
+
+**Reference**: [`references/design-principles.md`](references/design-principles.md) - Design systems, component libraries, WCAG accessibility standards.
+
+### 3. SATISFYING: Micro-Interactions
+Incorporate subtle animations with appropriate timing (150-300ms), easing curves (ease-out for entry, ease-in for exit), sequential delays.
+
+**Reference**: [`references/micro-interactions.md`](references/micro-interactions.md) - Duration guidelines, easing curves, performance optimization.
+
+### 4. PEAK: Storytelling Through Design
+Elevate with narrative elements—parallax effects, particle systems, thematic consistency. Use restraint: "too much of anything isn't good."
+
+**Reference**: [`references/storytelling-design.md`](references/storytelling-design.md) - Narrative elements, scroll-based storytelling, interactive techniques.
+
+## Workflows
+
+### Workflow 1: Capture & Analyze Inspiration
+
+**Purpose**: Extract design guidelines from inspiration websites.
+
+**Steps**:
+1. Browse inspiration sites (Dribbble, Mobbin, Behance, Awwwards)
+2. Use **chrome-devtools** skill to capture full-screen screenshots (not full page)
+3. Use **ai-multimodal** skill to analyze screenshots and extract:
+   - Design style (Minimalism, Glassmorphism, Neo-brutalism, etc.)
+   - Layout structure & grid systems
+   - Typography system & hierarchy
+     **IMPORTANT:** Try to predict the font name (Google Fonts) and font size in the given screenshot, don't just use Inter or Poppins.
+   - Color palette with hex codes
+   - Visual hierarchy techniques
+   - Component patterns & styling
+   - Micro-interactions
+   - Accessibility considerations
+   - Overall aesthetic quality rating (1-10)
+4. Document findings in project design guidelines using templates
+
+### Workflow 2: Generate & Iterate Design Images
+
+**Purpose**: Create aesthetically pleasing design images through iteration.
+
+**Steps**:
+1. Define design prompt with: style, colors, typography, audience, animation specs
+2. Use **ai-multimodal** skill to generate design images with Gemini API
+3. Use **ai-multimodal** skill to analyze output images and evaluate aesthetic quality
+4. If score < 7/10 or fails professional standards:
+   - Identify specific weaknesses (color, typography, layout, spacing, hierarchy)
+   - Refine prompt with improvements
+   - Regenerate with **ai-multimodal** or use **media-processing** skill to modify outputs (resize, crop, filters, composition)
+5. Repeat until aesthetic standards met (score ≥ 7/10)
+6. Document final design decisions using templates
+
+## Design Documentation
+
+### Create Design Guidelines
+Use [`assets/design-guideline-template.md`](assets/design-guideline-template.md) to document:
+- Color patterns & psychology
+- Typography system & hierarchy
+- Layout principles & spacing
+- Component styling standards
+- Accessibility considerations
+- Design highlights & rationale
+
+Save in project `./docs/design-guideline.md`.
+
+### Create Design Story
+Use [`assets/design-story-template.md`](assets/design-story-template.md) to document:
+- Narrative elements & themes
+- Emotional journey
+- User journey & peak moments
+- Design decision rationale
+
+Save in project `./docs/design-story.md`.
+
+## Resources & Integration
+
+### Related Skills
+- **ai-multimodal**: Analyze documents, screenshots & videos, generate design images, edit generated images, evaluate aesthetic quality using Gemini API
+- **chrome-devtools**: Capture full-screen screenshots from inspiration websites, navigate between pages, interact with elements, read console logs & network requests
+- **media-processing**: Refine generated images (FFmpeg for video, ImageMagick for images)
+- **ui-styling**: Implement designs with shadcn/ui components + Tailwind CSS utility-first styling
+- **web-frameworks**: Build with Next.js (App Router, Server Components, SSR/SSG)
+
+### Reference Documentation
+**References**: [`references/design-resources.md`](references/design-resources.md) - Inspiration platforms, design systems, AI tools, MCP integrations, development strategies.
+
+## Key Principles
+
+1. Aesthetic standards come from humans, not AI—study quality examples
+2. Iterate based on analysis—never settle for first output
+3. Balance beauty with functionality and accessibility
+4. Document decisions for consistency across development
+5. Use progressive disclosure in design—reveal complexity gradually
+6. Always evaluate aesthetic quality objectively (score ≥ 7/10)