reeeliance-skills 1.0.0

package/dist/index.js

@@ -0,0 +1,204 @@
+#!/usr/bin/env node
+import { checkbox } from "@inquirer/prompts";
+import chalk from "chalk";
+import { existsSync, mkdirSync, writeFileSync } from "fs";
+import { join, resolve, dirname } from "path";
+const GITLAB_PROJECT = "eee-main/eee-projects/skills";
+const GITLAB_BRANCH = "main";
+const GITLAB_RAW = `https://gitlab.com/${GITLAB_PROJECT}/-/raw/${GITLAB_BRANCH}`;
+const GITLAB_API = `https://gitlab.com/api/v4/projects/${encodeURIComponent(GITLAB_PROJECT)}/repository`;
+function getToken() {
+    const token = process.env.GITLAB_TOKEN;
+    if (!token) {
+        console.error(chalk.red("\nGITLAB_TOKEN environment variable is not set."));
+        console.error(chalk.dim("Create a token at: https://gitlab.com/-/user_settings/personal_access_tokens"));
+        console.error(chalk.dim("Required scope: read_api\n"));
+        console.error(chalk.dim("Then run:"));
+        console.error(chalk.dim("  export GITLAB_TOKEN=glpat-xxxxxxxxxxxx\n"));
+        process.exit(1);
+    }
+    return token;
+}
+// ── Source: local filesystem ──────────────────────────────────────────────────
+import { readFileSync, cpSync } from "fs";
+function loadLocalManifest(repoPath) {
+    const manifestPath = join(repoPath, "skills.json");
+    if (!existsSync(manifestPath)) {
+        console.error(chalk.red(`No skills.json found at ${manifestPath}`));
+        process.exit(1);
+    }
+    return JSON.parse(readFileSync(manifestPath, "utf8"));
+}
+function installLocalSkill(skill, repoPath, targetDir) {
+    const srcDir = join(repoPath, skill.path);
+    const destDir = join(targetDir, skill.name);
+    if (!existsSync(srcDir)) {
+        console.warn(chalk.yellow(`  Warning: source not found: ${srcDir}`));
+        return;
+    }
+    mkdirSync(destDir, { recursive: true });
+    cpSync(srcDir, destDir, { recursive: true });
+    console.log(chalk.green(`  ✓ ${skill.name}`) + chalk.dim(` → ${destDir}`));
+}
+// ── Source: GitLab (remote) ───────────────────────────────────────────────────
+async function fetchText(url, token) {
+    const res = await fetch(url, { headers: { "PRIVATE-TOKEN": token } });
+    if (!res.ok)
+        throw new Error(`Failed to fetch ${url}: ${res.status} ${res.statusText}`);
+    return res.text();
+}
+async function loadRemoteManifest(token) {
+    process.stdout.write(chalk.dim("Fetching skill list from GitLab…"));
+    const text = await fetchText(`${GITLAB_RAW}/skills.json`, token);
+    process.stdout.write(chalk.dim(" done\n"));
+    return JSON.parse(text);
+}
+async function listRemoteTree(skillPath, token) {
+    const url = `${GITLAB_API}/tree?path=${encodeURIComponent(skillPath)}&recursive=true&per_page=100`;
+    const text = await fetchText(url, token);
+    return JSON.parse(text);
+}
+async function installRemoteSkill(skill, targetDir, token) {
+    const destDir = join(targetDir, skill.name);
+    mkdirSync(destDir, { recursive: true });
+    const entries = await listRemoteTree(skill.path, token);
+    const files = entries.filter((e) => e.type === "blob");
+    for (const file of files) {
+        const rawUrl = `${GITLAB_RAW}/${file.path}`;
+        const content = await fetchText(rawUrl, token);
+        const relative = file.path.slice(skill.path.length + 1);
+        const destFile = join(destDir, relative);
+        mkdirSync(dirname(destFile), { recursive: true });
+        writeFileSync(destFile, content, "utf8");
+    }
+    console.log(chalk.green(`  ✓ ${skill.name}`) + chalk.dim(` → ${destDir}`));
+}
+// ── Shared helpers ────────────────────────────────────────────────────────────
+function groupByCategory(skills) {
+    return skills.reduce((acc, skill) => {
+        const cat = skill.category;
+        if (!acc[cat])
+            acc[cat] = [];
+        acc[cat].push(skill);
+        return acc;
+    }, {});
+}
+// ── Main ──────────────────────────────────────────────────────────────────────
+async function main() {
+    const args = process.argv.slice(2);
+    const command = args[0] ?? "add";
+    // Local repo path: auto-detected (two levels above dist/) or --repo flag
+    const repoFlagIdx = args.indexOf("--repo");
+    const localRepoPath = repoFlagIdx !== -1
+        ? resolve(args[repoFlagIdx + 1])
+        : resolve(join(dirname(new URL(import.meta.url).pathname), "../.."));
+    // Use local source when running from inside the repo, remote otherwise
+    const isLocal = existsSync(join(localRepoPath, "skills.json"));
+    const token = isLocal ? "" : getToken();
+    // Target directory
+    const isGlobal = args.includes("--global");
+    const targetFlagIdx = args.indexOf("--target");
+    const targetDir = isGlobal
+        ? resolve(join(process.env.HOME ?? "~", ".claude", "skills"))
+        : targetFlagIdx !== -1
+            ? resolve(args[targetFlagIdx + 1])
+            : resolve(process.cwd());
+    // ── list ──
+    if (command === "list") {
+        const manifest = isLocal
+            ? loadLocalManifest(localRepoPath)
+            : await loadRemoteManifest(token);
+        console.log(chalk.bold(`\n${manifest.name} — ${manifest.description}\n`));
+        const groups = groupByCategory(manifest.skills);
+        for (const [cat, skills] of Object.entries(groups)) {
+            console.log(chalk.cyan.bold(`  ${cat}`));
+            for (const s of skills) {
+                const badge = s.source ? chalk.dim(` [${s.source}]`) : "";
+                console.log(`    ${chalk.bold(s.name)}${badge} — ${s.description}`);
+            }
+        }
+        console.log();
+        return;
+    }
+    // ── add ──
+    if (command === "add") {
+        const manifest = isLocal
+            ? loadLocalManifest(localRepoPath)
+            : await loadRemoteManifest(token);
+        const install = isLocal
+            ? (skill) => installLocalSkill(skill, localRepoPath, targetDir)
+            : (skill) => installRemoteSkill(skill, targetDir, token);
+        // --all
+        if (args.includes("--all")) {
+            console.log(chalk.bold(`\nInstalling all skills to ${targetDir}\n`));
+            for (const skill of manifest.skills)
+                await install(skill);
+            console.log(chalk.bold("\nDone. Restart your AI agent to load the new skills.\n"));
+            return;
+        }
+        // --skill <name>
+        const skillFlagIdx = args.indexOf("--skill");
+        if (skillFlagIdx !== -1) {
+            const skillName = args[skillFlagIdx + 1];
+            const skill = manifest.skills.find((s) => s.name === skillName);
+            if (!skill) {
+                console.error(chalk.red(`Skill not found: ${skillName}`));
+                console.log("Run `skills list` to see available skills.");
+                process.exit(1);
+            }
+            console.log(chalk.bold(`\nInstalling ${skillName} to ${targetDir}\n`));
+            await install(skill);
+            console.log(chalk.bold("\nDone. Restart your AI agent to load the new skills.\n"));
+            return;
+        }
+        // Interactive
+        console.log(chalk.bold("\nreeeliance Skills Installer\n"));
+        console.log(chalk.dim(`Source: ${isLocal ? localRepoPath : `GitLab (${GITLAB_PROJECT})`}`));
+        console.log(chalk.dim(`Target: ${targetDir}\n`));
+        const groups = groupByCategory(manifest.skills);
+        const choices = Object.values(groups).flat().map((s) => ({
+            name: `${s.name}${s.source ? ` [${s.source}]` : ""} — ${s.description}`,
+            value: s.name,
+        }));
+        const selected = await checkbox({
+            message: "Select skills to install (space to toggle, enter to confirm):",
+            choices,
+            pageSize: 20,
+        });
+        if (selected.length === 0) {
+            console.log(chalk.yellow("\nNo skills selected. Nothing installed.\n"));
+            return;
+        }
+        console.log(chalk.bold(`\nInstalling ${selected.length} skill(s) to ${targetDir}\n`));
+        for (const name of selected) {
+            const skill = manifest.skills.find((s) => s.name === name);
+            await install(skill);
+        }
+        console.log(chalk.bold("\nDone. Restart your AI agent to load the new skills.\n"));
+        return;
+    }
+    console.log(`
+${chalk.bold("reeeliance Skills CLI")}
+
+${chalk.dim("Usage:")}
+  npx reeeliance-skills list                    List all available skills
+  npx reeeliance-skills add                     Interactive skill selection
+  npx reeeliance-skills add --global            Install to ~/.claude/skills (all projects)
+  npx reeeliance-skills add --all               Install all skills
+  npx reeeliance-skills add --skill <name>      Install a single skill
+
+${chalk.dim("Options:")}
+  --global          Install to ~/.claude/skills so all Claude Code projects see the skills
+  --repo <path>     Use a local skills repo instead of fetching from GitLab
+  --target <path>   Custom destination directory
+
+${chalk.dim("Authentication (required for remote use):")}
+  export GITLAB_TOKEN=glpat-xxxxxxxxxxxx
+  Create a token at: https://gitlab.com/-/user_settings/personal_access_tokens
+  Required scope: read_api
+`);
+}
+main().catch((err) => {
+    console.error(chalk.red(err.message));
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "reeeliance-skills",
+  "version": "1.0.0",
+  "description": "reeeliance GmbH AI skill installer — select and install skills from the library into any AI agent",
+  "type": "module",
+  "bin": {
+    "skills": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "start": "node dist/index.js"
+  },
+  "dependencies": {
+    "@inquirer/prompts": "^7.0.0",
+    "chalk": "^5.6.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.0.0"
+  }
+}

package/src/index.ts

@@ -0,0 +1,251 @@
+#!/usr/bin/env node
+import { checkbox } from "@inquirer/prompts";
+import chalk from "chalk";
+import { existsSync, mkdirSync, writeFileSync } from "fs";
+import { join, resolve, dirname, basename } from "path";
+
+const GITLAB_PROJECT = "eee-main/eee-projects/skills";
+const GITLAB_BRANCH = "main";
+const GITLAB_RAW = `https://gitlab.com/${GITLAB_PROJECT}/-/raw/${GITLAB_BRANCH}`;
+const GITLAB_API = `https://gitlab.com/api/v4/projects/${encodeURIComponent(GITLAB_PROJECT)}/repository`;
+
+function getToken(): string {
+  const token = process.env.GITLAB_TOKEN;
+  if (!token) {
+    console.error(chalk.red("\nGITLAB_TOKEN environment variable is not set."));
+    console.error(chalk.dim("Create a token at: https://gitlab.com/-/user_settings/personal_access_tokens"));
+    console.error(chalk.dim("Required scope: read_api\n"));
+    console.error(chalk.dim("Then run:"));
+    console.error(chalk.dim("  export GITLAB_TOKEN=glpat-xxxxxxxxxxxx\n"));
+    process.exit(1);
+  }
+  return token;
+}
+
+interface Skill {
+  name: string;
+  path: string;
+  description: string;
+  category: string;
+  tags: string[];
+  parent?: string;
+  source?: string;
+}
+
+interface Manifest {
+  name: string;
+  description: string;
+  skills: Skill[];
+}
+
+// ── Source: local filesystem ──────────────────────────────────────────────────
+
+import { readFileSync, cpSync } from "fs";
+
+function loadLocalManifest(repoPath: string): Manifest {
+  const manifestPath = join(repoPath, "skills.json");
+  if (!existsSync(manifestPath)) {
+    console.error(chalk.red(`No skills.json found at ${manifestPath}`));
+    process.exit(1);
+  }
+  return JSON.parse(readFileSync(manifestPath, "utf8"));
+}
+
+function installLocalSkill(skill: Skill, repoPath: string, targetDir: string) {
+  const srcDir = join(repoPath, skill.path);
+  const destDir = join(targetDir, skill.name);
+  if (!existsSync(srcDir)) {
+    console.warn(chalk.yellow(`  Warning: source not found: ${srcDir}`));
+    return;
+  }
+  mkdirSync(destDir, { recursive: true });
+  cpSync(srcDir, destDir, { recursive: true });
+  console.log(chalk.green(`  ✓ ${skill.name}`) + chalk.dim(` → ${destDir}`));
+}
+
+// ── Source: GitLab (remote) ───────────────────────────────────────────────────
+
+async function fetchText(url: string, token: string): Promise<string> {
+  const res = await fetch(url, { headers: { "PRIVATE-TOKEN": token } });
+  if (!res.ok) throw new Error(`Failed to fetch ${url}: ${res.status} ${res.statusText}`);
+  return res.text();
+}
+
+async function loadRemoteManifest(token: string): Promise<Manifest> {
+  process.stdout.write(chalk.dim("Fetching skill list from GitLab…"));
+  const text = await fetchText(`${GITLAB_RAW}/skills.json`, token);
+  process.stdout.write(chalk.dim(" done\n"));
+  return JSON.parse(text);
+}
+
+async function listRemoteTree(skillPath: string, token: string): Promise<{ path: string; type: string }[]> {
+  const url = `${GITLAB_API}/tree?path=${encodeURIComponent(skillPath)}&recursive=true&per_page=100`;
+  const text = await fetchText(url, token);
+  return JSON.parse(text);
+}
+
+async function installRemoteSkill(skill: Skill, targetDir: string, token: string) {
+  const destDir = join(targetDir, skill.name);
+  mkdirSync(destDir, { recursive: true });
+
+  const entries = await listRemoteTree(skill.path, token);
+  const files = entries.filter((e) => e.type === "blob");
+
+  for (const file of files) {
+    const rawUrl = `${GITLAB_RAW}/${file.path}`;
+    const content = await fetchText(rawUrl, token);
+    const relative = file.path.slice(skill.path.length + 1);
+    const destFile = join(destDir, relative);
+    mkdirSync(dirname(destFile), { recursive: true });
+    writeFileSync(destFile, content, "utf8");
+  }
+
+  console.log(chalk.green(`  ✓ ${skill.name}`) + chalk.dim(` → ${destDir}`));
+}
+
+// ── Shared helpers ────────────────────────────────────────────────────────────
+
+function groupByCategory(skills: Skill[]): Record<string, Skill[]> {
+  return skills.reduce((acc, skill) => {
+    const cat = skill.category;
+    if (!acc[cat]) acc[cat] = [];
+    acc[cat].push(skill);
+    return acc;
+  }, {} as Record<string, Skill[]>);
+}
+
+// ── Main ──────────────────────────────────────────────────────────────────────
+
+async function main() {
+  const args = process.argv.slice(2);
+  const command = args[0] ?? "add";
+
+  // Local repo path: auto-detected (two levels above dist/) or --repo flag
+  const repoFlagIdx = args.indexOf("--repo");
+  const localRepoPath = repoFlagIdx !== -1
+    ? resolve(args[repoFlagIdx + 1])
+    : resolve(join(dirname(new URL(import.meta.url).pathname), "../.."));
+
+  // Use local source when running from inside the repo, remote otherwise
+  const isLocal = existsSync(join(localRepoPath, "skills.json"));
+  const token = isLocal ? "" : getToken();
+
+  // Target directory
+  const isGlobal = args.includes("--global");
+  const targetFlagIdx = args.indexOf("--target");
+  const targetDir = isGlobal
+    ? resolve(join(process.env.HOME ?? "~", ".claude", "skills"))
+    : targetFlagIdx !== -1
+      ? resolve(args[targetFlagIdx + 1])
+      : resolve(process.cwd());
+
+  // ── list ──
+  if (command === "list") {
+    const manifest = isLocal
+      ? loadLocalManifest(localRepoPath)
+      : await loadRemoteManifest(token);
+
+    console.log(chalk.bold(`\n${manifest.name} — ${manifest.description}\n`));
+    const groups = groupByCategory(manifest.skills);
+    for (const [cat, skills] of Object.entries(groups)) {
+      console.log(chalk.cyan.bold(`  ${cat}`));
+      for (const s of skills) {
+        const badge = s.source ? chalk.dim(` [${s.source}]`) : "";
+        console.log(`    ${chalk.bold(s.name)}${badge} — ${s.description}`);
+      }
+    }
+    console.log();
+    return;
+  }
+
+  // ── add ──
+  if (command === "add") {
+    const manifest = isLocal
+      ? loadLocalManifest(localRepoPath)
+      : await loadRemoteManifest(token);
+
+    const install = isLocal
+      ? (skill: Skill) => installLocalSkill(skill, localRepoPath, targetDir)
+      : (skill: Skill) => installRemoteSkill(skill, targetDir, token);
+
+    // --all
+    if (args.includes("--all")) {
+      console.log(chalk.bold(`\nInstalling all skills to ${targetDir}\n`));
+      for (const skill of manifest.skills) await install(skill);
+      console.log(chalk.bold("\nDone. Restart your AI agent to load the new skills.\n"));
+      return;
+    }
+
+    // --skill <name>
+    const skillFlagIdx = args.indexOf("--skill");
+    if (skillFlagIdx !== -1) {
+      const skillName = args[skillFlagIdx + 1];
+      const skill = manifest.skills.find((s) => s.name === skillName);
+      if (!skill) {
+        console.error(chalk.red(`Skill not found: ${skillName}`));
+        console.log("Run `skills list` to see available skills.");
+        process.exit(1);
+      }
+      console.log(chalk.bold(`\nInstalling ${skillName} to ${targetDir}\n`));
+      await install(skill);
+      console.log(chalk.bold("\nDone. Restart your AI agent to load the new skills.\n"));
+      return;
+    }
+
+    // Interactive
+    console.log(chalk.bold("\nreeeliance Skills Installer\n"));
+    console.log(chalk.dim(`Source: ${isLocal ? localRepoPath : `GitLab (${GITLAB_PROJECT})`}`));
+    console.log(chalk.dim(`Target: ${targetDir}\n`));
+
+    const groups = groupByCategory(manifest.skills);
+    const choices = Object.values(groups).flat().map((s) => ({
+      name: `${s.name}${s.source ? ` [${s.source}]` : ""} — ${s.description}`,
+      value: s.name,
+    }));
+
+    const selected = await checkbox({
+      message: "Select skills to install (space to toggle, enter to confirm):",
+      choices,
+      pageSize: 20,
+    });
+
+    if (selected.length === 0) {
+      console.log(chalk.yellow("\nNo skills selected. Nothing installed.\n"));
+      return;
+    }
+
+    console.log(chalk.bold(`\nInstalling ${selected.length} skill(s) to ${targetDir}\n`));
+    for (const name of selected) {
+      const skill = manifest.skills.find((s) => s.name === name)!;
+      await install(skill);
+    }
+    console.log(chalk.bold("\nDone. Restart your AI agent to load the new skills.\n"));
+    return;
+  }
+
+  console.log(`
+${chalk.bold("reeeliance Skills CLI")}
+
+${chalk.dim("Usage:")}
+  npx reeeliance-skills list                    List all available skills
+  npx reeeliance-skills add                     Interactive skill selection
+  npx reeeliance-skills add --global            Install to ~/.claude/skills (all projects)
+  npx reeeliance-skills add --all               Install all skills
+  npx reeeliance-skills add --skill <name>      Install a single skill
+
+${chalk.dim("Options:")}
+  --global          Install to ~/.claude/skills so all Claude Code projects see the skills
+  --repo <path>     Use a local skills repo instead of fetching from GitLab
+  --target <path>   Custom destination directory
+
+${chalk.dim("Authentication (required for remote use):")}
+  export GITLAB_TOKEN=glpat-xxxxxxxxxxxx
+  Create a token at: https://gitlab.com/-/user_settings/personal_access_tokens
+  Required scope: read_api
+`);
+}
+
+main().catch((err) => {
+  console.error(chalk.red(err.message));
+  process.exit(1);
+});

package/tsconfig.json

@@ -0,0 +1,13 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "Node16",
+    "moduleResolution": "Node16",
+    "outDir": "dist",
+    "rootDir": "src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true
+  },
+  "include": ["src"]
+}