aicoding-rules 0.1.0 → 0.3.0

package/bin/cli.js

@@ -2,59 +2,81 @@
 
 import { Command } from "commander";
 import { loadConfig, getRuleKeys } from "../src/config.js";
-import { downloadAndExtract, downloadMultiple } from "../src/download.js";
-import { selectRules } from "../src/interactive.js";
+import { downloadAndExtract, downloadMultiple, downloadMultipleSkills } from "../src/download.js";
+import { selectRules, selectSkills } from "../src/interactive.js";
 
 const config = loadConfig();
 const targetDir = process.cwd();
 
+function wrapAction(fn) {
+  return async (...args) => {
+    try {
+      await fn(...args);
+    } catch (err) {
+      console.error(`Error: ${err.message}`);
+      process.exit(1);
+    }
+  };
+}
+
 const program = new Command();
 
 program
   .name("aicoding-rules")
-  .description("Download and install AI coding rules for Cursor, Claude, Antigravity, and Copilot")
+  .description("Download and install AI coding rules and skills for Cursor, Claude, Antigravity, and Copilot")
   .version("1.0.0");
 
 program
   .command("cursor")
   .description("Install Cursor rules")
-  .action(async () => {
+  .action(wrapAction(async () => {
     await downloadAndExtract(config, "cursor", targetDir);
-  });
+  }));
 
 program
   .command("claude")
   .description("Install Claude rules")
-  .action(async () => {
+  .action(wrapAction(async () => {
     await downloadAndExtract(config, "claude", targetDir);
-  });
+  }));
 
 program
   .command("antigravity")
   .description("Install Antigravity rules")
-  .action(async () => {
+  .action(wrapAction(async () => {
     await downloadAndExtract(config, "antigravity", targetDir);
-  });
+  }));
 
 program
   .command("copilot")
   .description("Install Copilot prompts")
-  .action(async () => {
+  .action(wrapAction(async () => {
     await downloadAndExtract(config, "copilot", targetDir);
-  });
+  }));
 
 program
   .command("all")
   .description("Install all rules")
-  .action(async () => {
+  .action(wrapAction(async () => {
     const allKeys = getRuleKeys(config);
     await downloadMultiple(config, allKeys, targetDir);
-  });
+  }));
+
+program
+  .command("skills")
+  .description("Install AI coding skills (interactive selection)")
+  .option("--replace", "Remove existing folders that match the zip contents before extracting (only those folders; other skills stay intact)")
+  .action(wrapAction(async (opts) => {
+    const { selectedSkills, targetDir: skillsDir } = await selectSkills(config);
+    if (selectedSkills.length > 0) {
+      await downloadMultipleSkills(config, selectedSkills, skillsDir, { replaceExtracted: opts.replace });
+    }
+  }));
 
 program
-  .action(async () => {
+  .action(wrapAction(async () => {
     const selectedKeys = await selectRules(config);
     await downloadMultiple(config, selectedKeys, targetDir);
-  });
+  }));
 
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aicoding-rules",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Download and install AI coding rules for Cursor, Claude, Antigravity, and Copilot",
   "license": "MIT",
   "type": "module",

package/src/config.js

@@ -12,6 +12,9 @@ const DEFAULT_CONFIG = {
     claude: { fileOid: "68872b563e3eb464f2214263", name: "Claude rules" },
     antigravity: { fileOid: "69202dcfacf31067955cfc1c", name: "Antigravity rules" },
     copilot: { fileOid: "67eab73e899a1711f6cc106f", name: "Copilot prompts" }
+  },
+  skills: {
+    uu_skills: { fileOid: "69786bfc45c7ce292846341e", name: "UU Skills" }
   }
 };
 
@@ -50,3 +53,11 @@ export function getRuleKeys(config) {
 export function getRule(config, key) {
   return config.rules[key];
 }
+
+export function getSkillKeys(config) {
+  return Object.keys(config.skills || {});
+}
+
+export function getSkill(config, key) {
+  return config.skills?.[key];
+}

package/src/download.js

@@ -1,9 +1,49 @@
 import AdmZip from "adm-zip";
+import { mkdirSync, rmSync, existsSync } from "fs";
+import { join } from "path";
 import { getAuthenticatedClient } from "./auth.js";
 
+const OVERWRITE_FILES = true;
+
+function getZipTopLevelNames(zip) {
+  const entries = zip.getEntries();
+  const topLevel = new Set();
+  for (const entry of entries) {
+    const name = entry.entryName.replace(/^\/+/, "");
+    if (!name) continue;
+
+    const firstSegment = name.split("/")[0];
+    if (firstSegment && firstSegment !== ".") {
+      topLevel.add(firstSegment);
+    }
+  }
+  return [...topLevel];
+}
+
+function removePathsInDir(targetDir, pathNames) {
+  for (const name of pathNames) {
+    const fullPath = join(targetDir, name);
+    if (existsSync(fullPath)) {
+      try {
+        rmSync(fullPath, { recursive: true, force: true });
+      } catch (err) {
+        throw new Error(`Failed to remove ${fullPath}: ${err.message}`);
+      }
+    }
+  }
+}
+
+function extractZip(zip, outputPath) {
+  zip.extractAllTo(outputPath, OVERWRITE_FILES);
+}
+
 function extractZipBuffer(buffer, outputPath) {
   const zip = new AdmZip(buffer);
-  zip.extractAllTo(outputPath, true);
+  zip.extractAllTo(outputPath, OVERWRITE_FILES);
+}
+
+function ensureDir(dirPath) {
+  mkdirSync(dirPath, { recursive: true });
 }
 
 export async function downloadAndExtract(config, ruleKey, targetDir) {
@@ -38,3 +78,50 @@ export async function downloadMultiple(config, ruleKeys, targetDir) {
     await downloadAndExtract(config, key, targetDir);
   }
 }
+
+export async function downloadSkill(config, skillKey, targetDir, options = {}) {
+  const { replaceExtracted = false } = options;
+  const skill = config.skills?.[skillKey];
+  if (!skill) {
+    throw new Error(`Unknown skill: ${skillKey}`);
+  }
+
+  if (!skill.fileOid) {
+    throw new Error(`Skill ${skillKey} has no fileOid configured. Please update your config.`);
+  }
+
+  const appClient = await getAuthenticatedClient();
+  
+  const url = `${config.baseUrl}/document/ebc/file/getDataByOid?oid=${config.documentOid}&uuEbcData.fileOid=${skill.fileOid}`;
+  
+  console.log(`Downloading ${skill.name}...`);
+  
+  const response = await appClient.exchange(
+    url,
+    "get",
+    {},
+    {},
+    0,
+    { responseType: "buffer" }
+  );
+
+  ensureDir(targetDir);
+
+  const zip = new AdmZip(response.body);
+  if (replaceExtracted) {
+    const topLevelNames = getZipTopLevelNames(zip);
+    if (topLevelNames.length > 0) {
+      console.log(`  Replacing: ${topLevelNames.join(", ")}`);
+    }
+    removePathsInDir(targetDir, topLevelNames);
+  }
+  extractZip(zip, targetDir);
+  
+  console.log(`${skill.name} installed to ${targetDir}`);
+}
+
+export async function downloadMultipleSkills(config, skillKeys, targetDir, options = {}) {
+  for (const key of skillKeys) {
+    await downloadSkill(config, key, targetDir, options);
+  }
+}

package/src/interactive.js

@@ -1,5 +1,7 @@
 import inquirer from "inquirer";
-import { getRuleKeys, getRule } from "./config.js";
+import { homedir } from "os";
+import { join } from "path";
+import { getRuleKeys, getRule, getSkillKeys, getSkill } from "./config.js";
 
 export async function selectRules(config) {
   const ruleKeys = getRuleKeys(config);
@@ -26,3 +28,72 @@ export async function selectRules(config) {
 
   return selectedRules;
 }
+
+export async function selectSkills(config) {
+  const skillKeys = getSkillKeys(config);
+  
+  if (skillKeys.length === 0) {
+    console.log("No skills available in configuration.");
+    return { selectedSkills: [], targetDir: null };
+  }
+
+  const choices = skillKeys.map(key => ({
+    name: getSkill(config, key).name,
+    value: key
+  }));
+
+  const { selectedSkills } = await inquirer.prompt([
+    {
+      type: "checkbox",
+      name: "selectedSkills",
+      message: "Select skills to install:",
+      choices,
+      validate: (answer) => {
+        if (answer.length === 0) {
+          return "You must select at least one skill.";
+        }
+        return true;
+      }
+    }
+  ]);
+
+  const targetDir = await selectSkillsLocation();
+
+  return { selectedSkills, targetDir };
+}
+
+export async function selectSkillsLocation() {
+  const { location } = await inquirer.prompt([
+    {
+      type: "list",
+      name: "location",
+      message: "Where do you want to extract the skills?",
+      choices: [
+        { name: "~/.claude/skills (Claude global skills)", value: "claude-global" },
+        { name: "~/.cursor/skills (Cursor global skills)", value: "cursor-global" },
+        { name: "Current directory - .claude/skills", value: "claude-local" },
+        { name: "Current directory - .cursor/skills", value: "cursor-local" }
+      ]
+    }
+  ]);
+
+  return resolveSkillsPath(location);
+}
+
+function resolveSkillsPath(location) {
+  const cwd = process.cwd();
+  const home = homedir();
+
+  switch (location) {
+    case "claude-global":
+      return join(home, ".claude", "skills");
+    case "cursor-global":
+      return join(home, ".cursor", "skills");
+    case "claude-local":
+      return join(cwd, ".claude", "skills");
+    case "cursor-local":
+      return join(cwd, ".cursor", "skills");
+    default:
+      return cwd;
+  }
+}