claudeup 3.8.0 → 3.10.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claudeup",
-  "version": "3.8.0",
+  "version": "3.10.0",
   "description": "TUI tool for managing Claude Code plugins, MCPs, and configuration",
   "type": "module",
   "main": "src/main.tsx",

package/src/data/skill-repos.js

@@ -0,0 +1,86 @@
+export const RECOMMENDED_SKILLS = [
+    {
+        name: "Find Skills",
+        repo: "vercel-labs/skills",
+        skillPath: "skills/find-skills",
+        description: "Discover and install new skills from the ecosystem",
+        category: "search",
+    },
+    {
+        name: "React Best Practices",
+        repo: "vercel-labs/agent-skills",
+        skillPath: "skills/react-best-practices",
+        description: "Modern React patterns and Vercel deployment guidelines",
+        category: "frontend",
+    },
+    {
+        name: "Web Design Guidelines",
+        repo: "vercel-labs/agent-skills",
+        skillPath: "skills/web-design-guidelines",
+        description: "UI/UX design principles and web standards",
+        category: "design",
+    },
+    {
+        name: "Remotion Best Practices",
+        repo: "remotion-dev/skills",
+        skillPath: "skills/remotion-best-practices",
+        description: "Programmatic video creation with Remotion",
+        category: "media",
+    },
+    {
+        name: "UI/UX Pro Max",
+        repo: "jh941213/my-claude-code-asset",
+        skillPath: "skills_en/ui-ux-pro-max",
+        description: "50 styles, 21 palettes, 50 font pairings, 9 stacks. Covers React, Next.js, Vue, Svelte, SwiftUI, Flutter, Tailwind, shadcn/ui",
+        category: "design",
+    },
+    {
+        name: "ElevenLabs TTS",
+        repo: "inferen-sh/skills",
+        skillPath: "skills/elevenlabs-tts",
+        description: "Text-to-speech with ElevenLabs API integration",
+        category: "media",
+    },
+    {
+        name: "Audit Website",
+        repo: "squirrelscan/skills",
+        skillPath: "skills/audit-website",
+        description: "Security and quality auditing for web applications",
+        category: "security",
+    },
+    {
+        name: "Systematic Debugging",
+        repo: "obra/superpowers",
+        skillPath: "skills/systematic-debugging",
+        description: "Structured debugging methodology with root cause analysis",
+        category: "debugging",
+    },
+    {
+        name: "shadcn/ui",
+        repo: "shadcn-ui/ui",
+        skillPath: "packages/shadcn",
+        description: "shadcn/ui component library patterns and usage",
+        category: "frontend",
+    },
+    {
+        name: "Neon Postgres",
+        repo: "neondatabase/agent-skills",
+        skillPath: "skills/neon-postgres",
+        description: "Neon serverless Postgres setup and best practices",
+        category: "database",
+    },
+    {
+        name: "Neon Serverless",
+        repo: "neondatabase/ai-rules",
+        skillPath: "skills/neon-serverless",
+        description: "Serverless database patterns with Neon",
+        category: "database",
+    },
+];
+export const DEFAULT_SKILL_REPOS = [
+    {
+        label: "Vercel Agent Skills",
+        repo: "vercel-labs/agent-skills",
+        skillsPath: "skills",
+    },
+];

package/src/data/skill-repos.ts

@@ -0,0 +1,97 @@
+import type { SkillSource } from "../types/index.js";
+
+export interface RecommendedSkill {
+	name: string;
+	repo: string;
+	skillPath: string;
+	description: string;
+	category: string;
+}
+
+export const RECOMMENDED_SKILLS: RecommendedSkill[] = [
+	{
+		name: "Find Skills",
+		repo: "vercel-labs/skills",
+		skillPath: "skills/find-skills",
+		description: "Discover and install new skills from the ecosystem",
+		category: "search",
+	},
+	{
+		name: "React Best Practices",
+		repo: "vercel-labs/agent-skills",
+		skillPath: "skills/react-best-practices",
+		description: "Modern React patterns and Vercel deployment guidelines",
+		category: "frontend",
+	},
+	{
+		name: "Web Design Guidelines",
+		repo: "vercel-labs/agent-skills",
+		skillPath: "skills/web-design-guidelines",
+		description: "UI/UX design principles and web standards",
+		category: "design",
+	},
+	{
+		name: "Remotion Best Practices",
+		repo: "remotion-dev/skills",
+		skillPath: "skills/remotion-best-practices",
+		description: "Programmatic video creation with Remotion",
+		category: "media",
+	},
+	{
+		name: "UI/UX Pro Max",
+		repo: "jh941213/my-claude-code-asset",
+		skillPath: "skills_en/ui-ux-pro-max",
+		description: "50 styles, 21 palettes, 50 font pairings, 9 stacks. Covers React, Next.js, Vue, Svelte, SwiftUI, Flutter, Tailwind, shadcn/ui",
+		category: "design",
+	},
+	{
+		name: "ElevenLabs TTS",
+		repo: "inferen-sh/skills",
+		skillPath: "skills/elevenlabs-tts",
+		description: "Text-to-speech with ElevenLabs API integration",
+		category: "media",
+	},
+	{
+		name: "Audit Website",
+		repo: "squirrelscan/skills",
+		skillPath: "skills/audit-website",
+		description: "Security and quality auditing for web applications",
+		category: "security",
+	},
+	{
+		name: "Systematic Debugging",
+		repo: "obra/superpowers",
+		skillPath: "skills/systematic-debugging",
+		description: "Structured debugging methodology with root cause analysis",
+		category: "debugging",
+	},
+	{
+		name: "shadcn/ui",
+		repo: "shadcn-ui/ui",
+		skillPath: "packages/shadcn",
+		description: "shadcn/ui component library patterns and usage",
+		category: "frontend",
+	},
+	{
+		name: "Neon Postgres",
+		repo: "neondatabase/agent-skills",
+		skillPath: "skills/neon-postgres",
+		description: "Neon serverless Postgres setup and best practices",
+		category: "database",
+	},
+	{
+		name: "Neon Serverless",
+		repo: "neondatabase/ai-rules",
+		skillPath: "skills/neon-serverless",
+		description: "Serverless database patterns with Neon",
+		category: "database",
+	},
+];
+
+export const DEFAULT_SKILL_REPOS: SkillSource[] = [
+	{
+		label: "Vercel Agent Skills",
+		repo: "vercel-labs/agent-skills",
+		skillsPath: "skills",
+	},
+];

package/src/services/skills-manager.js

@@ -0,0 +1,307 @@
+import fs from "fs-extra";
+import path from "node:path";
+import os from "node:os";
+import { RECOMMENDED_SKILLS } from "../data/skill-repos.js";
+const SKILLS_API_BASE = "https://us-central1-claudish-6da10.cloudfunctions.net/skills";
+const treeCache = new Map();
+// ─── Path helpers ──────────────────────────────────────────────────────────────
+export function getUserSkillsDir() {
+    return path.join(os.homedir(), ".claude", "skills");
+}
+export function getProjectSkillsDir(projectPath) {
+    return path.join(projectPath ?? process.cwd(), ".claude", "skills");
+}
+// ─── GitHub Tree API ──────────────────────────────────────────────────────────
+async function fetchGitTree(repo) {
+    const cached = treeCache.get(repo);
+    const url = `https://api.github.com/repos/${repo}/git/trees/HEAD?recursive=1`;
+    const headers = {
+        Accept: "application/vnd.github+json",
+        "X-GitHub-Api-Version": "2022-11-28",
+    };
+    if (cached?.etag) {
+        headers["If-None-Match"] = cached.etag;
+    }
+    const token = process.env.GITHUB_TOKEN || process.env.GITHUB_PERSONAL_ACCESS_TOKEN;
+    if (token) {
+        headers.Authorization = `Bearer ${token}`;
+    }
+    const response = await fetch(url, {
+        headers,
+        signal: AbortSignal.timeout(10000),
+    });
+    if (response.status === 304 && cached) {
+        return cached.tree;
+    }
+    if (response.status === 403 || response.status === 429) {
+        const resetHeader = response.headers.get("X-RateLimit-Reset");
+        const resetTime = resetHeader
+            ? new Date(Number(resetHeader) * 1000).toLocaleTimeString()
+            : "unknown";
+        throw new Error(`GitHub API rate limit exceeded. Resets at ${resetTime}. Set GITHUB_TOKEN to increase limits.`);
+    }
+    if (!response.ok) {
+        throw new Error(`GitHub API error: ${response.status} ${response.statusText}`);
+    }
+    const etag = response.headers.get("ETag") || "";
+    const tree = (await response.json());
+    treeCache.set(repo, { etag, tree, fetchedAt: Date.now() });
+    return tree;
+}
+// ─── Frontmatter parser ───────────────────────────────────────────────────────
+function parseYamlFrontmatter(content) {
+    const frontmatterMatch = content.match(/^---\s*\n([\s\S]*?)\n---/);
+    if (!frontmatterMatch)
+        return {};
+    const yaml = frontmatterMatch[1];
+    const result = {};
+    for (const line of yaml.split("\n")) {
+        const colonIdx = line.indexOf(":");
+        if (colonIdx === -1)
+            continue;
+        const key = line.slice(0, colonIdx).trim();
+        const rawValue = line.slice(colonIdx + 1).trim();
+        if (!key)
+            continue;
+        // Handle arrays (simple inline: [a, b, c])
+        if (rawValue.startsWith("[") && rawValue.endsWith("]")) {
+            const items = rawValue
+                .slice(1, -1)
+                .split(",")
+                .map((s) => s.trim().replace(/^["']|["']$/g, ""))
+                .filter(Boolean);
+            result[key] = items;
+        }
+        else {
+            // Strip quotes
+            result[key] = rawValue.replace(/^["']|["']$/g, "");
+        }
+    }
+    return result;
+}
+export async function fetchSkillFrontmatter(skill) {
+    const url = `https://raw.githubusercontent.com/${skill.source.repo}/HEAD/${skill.repoPath}`;
+    const response = await fetch(url, {
+        signal: AbortSignal.timeout(10000),
+    });
+    if (!response.ok) {
+        return {
+            name: skill.name,
+            description: "(no description)",
+            category: "general",
+        };
+    }
+    const content = await response.text();
+    const parsed = parseYamlFrontmatter(content);
+    return {
+        name: parsed.name || skill.name,
+        description: parsed.description || "(no description)",
+        category: parsed.category,
+        author: parsed.author,
+        version: parsed.version,
+        tags: parsed.tags,
+    };
+}
+// ─── Check installation ───────────────────────────────────────────────────────
+export async function getInstalledSkillNames(scope, projectPath) {
+    const dir = scope === "user"
+        ? getUserSkillsDir()
+        : getProjectSkillsDir(projectPath);
+    const installed = new Set();
+    try {
+        if (!(await fs.pathExists(dir)))
+            return installed;
+        const entries = await fs.readdir(dir);
+        for (const entry of entries) {
+            const skillMd = path.join(dir, entry, "SKILL.md");
+            if (await fs.pathExists(skillMd)) {
+                installed.add(entry);
+            }
+        }
+    }
+    catch {
+        // ignore
+    }
+    return installed;
+}
+// ─── Firebase Skills API ──────────────────────────────────────────────────────
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function mapApiSkillToSkillInfo(raw) {
+    const repo = raw.repo || "unknown";
+    const skillPath = raw.skillPath || raw.name || "";
+    const source = {
+        label: repo,
+        repo,
+        skillsPath: "",
+    };
+    return {
+        id: `${repo}/${skillPath}`,
+        name: raw.name || skillPath,
+        description: raw.description || "",
+        source,
+        repoPath: skillPath ? `${skillPath}/SKILL.md` : "SKILL.md",
+        gitBlobSha: "",
+        frontmatter: null,
+        installed: false,
+        installedScope: null,
+        hasUpdate: false,
+        stars: typeof raw.stars === "number" ? raw.stars : undefined,
+    };
+}
+export async function fetchPopularSkills(limit = 30) {
+    try {
+        const res = await fetch(`${SKILLS_API_BASE}/search?q=development&limit=${limit}&sortBy=stars`, { signal: AbortSignal.timeout(10000) });
+        if (!res.ok)
+            return [];
+        const data = (await res.json());
+        return (data.skills || []).map(mapApiSkillToSkillInfo);
+    }
+    catch {
+        return [];
+    }
+}
+// ─── Fetch available skills ───────────────────────────────────────────────────
+export async function fetchAvailableSkills(_repos, projectPath) {
+    const userInstalled = await getInstalledSkillNames("user");
+    const projectInstalled = await getInstalledSkillNames("project", projectPath);
+    const markInstalled = (skill) => {
+        const isUserInstalled = userInstalled.has(skill.name);
+        const isProjInstalled = projectInstalled.has(skill.name);
+        const installed = isUserInstalled || isProjInstalled;
+        const installedScope = isProjInstalled
+            ? "project"
+            : isUserInstalled
+                ? "user"
+                : null;
+        return { ...skill, installed, installedScope };
+    };
+    // 1. Recommended skills from RECOMMENDED_SKILLS constant (no API call)
+    const recommendedSkills = RECOMMENDED_SKILLS.map((rec) => {
+        const source = {
+            label: rec.repo,
+            repo: rec.repo,
+            skillsPath: "",
+        };
+        const skill = {
+            id: `${rec.repo}/${rec.skillPath}`,
+            name: rec.name,
+            description: rec.description,
+            source,
+            repoPath: `${rec.skillPath}/SKILL.md`,
+            gitBlobSha: "",
+            frontmatter: null,
+            installed: false,
+            installedScope: null,
+            hasUpdate: false,
+            isRecommended: true,
+        };
+        return markInstalled(skill);
+    });
+    // 2. Fetch popular skills from Firebase API
+    const popular = await fetchPopularSkills(30);
+    const popularSkills = popular.map((s) => markInstalled({ ...s, isRecommended: false }));
+    // 3. Enrich recommended skills with GitHub repo stars
+    //    Fetch stars for each unique repo (typically ~7 repos, parallel)
+    const uniqueRepos = [...new Set(recommendedSkills.map((s) => s.source.repo))];
+    const repoStars = new Map();
+    try {
+        const starResults = await Promise.allSettled(uniqueRepos.map(async (repo) => {
+            const res = await fetch(`https://api.github.com/repos/${repo}`, {
+                headers: { Accept: "application/vnd.github+json" },
+                signal: AbortSignal.timeout(5000),
+            });
+            if (!res.ok)
+                return;
+            const data = (await res.json());
+            if (data.stargazers_count)
+                repoStars.set(repo, data.stargazers_count);
+        }));
+    }
+    catch {
+        // Non-fatal — stars are cosmetic
+    }
+    for (const rec of recommendedSkills) {
+        rec.stars = repoStars.get(rec.source.repo) || undefined;
+    }
+    // 4. Combine: recommended first, then popular (dedup by name)
+    const seen = new Set(recommendedSkills.map((s) => s.name));
+    const deduped = popularSkills.filter((s) => !seen.has(s.name));
+    return [...recommendedSkills, ...deduped];
+}
+// ─── Install / Uninstall ──────────────────────────────────────────────────────
+export async function installSkill(skill, scope, projectPath) {
+    // Try multiple URL patterns — repos structure SKILL.md differently
+    const repo = skill.source.repo;
+    const repoPath = skill.repoPath.replace(/\/SKILL\.md$/, "");
+    const candidates = [
+        `https://raw.githubusercontent.com/${repo}/HEAD/${repoPath}/SKILL.md`,
+        `https://raw.githubusercontent.com/${repo}/main/${repoPath}/SKILL.md`,
+        `https://raw.githubusercontent.com/${repo}/master/${repoPath}/SKILL.md`,
+        `https://raw.githubusercontent.com/${repo}/HEAD/SKILL.md`,
+        `https://raw.githubusercontent.com/${repo}/main/SKILL.md`,
+    ];
+    let content = null;
+    for (const url of candidates) {
+        try {
+            const response = await fetch(url, { signal: AbortSignal.timeout(8000) });
+            if (response.ok) {
+                content = await response.text();
+                break;
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    if (!content) {
+        throw new Error(`Failed to fetch skill: SKILL.md not found in ${repo}/${repoPath}`);
+    }
+    const installDir = scope === "user"
+        ? path.join(getUserSkillsDir(), skill.name)
+        : path.join(getProjectSkillsDir(projectPath), skill.name);
+    await fs.ensureDir(installDir);
+    await fs.writeFile(path.join(installDir, "SKILL.md"), content, "utf8");
+}
+export async function uninstallSkill(skillName, scope, projectPath) {
+    const installDir = scope === "user"
+        ? path.join(getUserSkillsDir(), skillName)
+        : path.join(getProjectSkillsDir(projectPath), skillName);
+    const skillMdPath = path.join(installDir, "SKILL.md");
+    if (await fs.pathExists(skillMdPath)) {
+        await fs.remove(skillMdPath);
+    }
+    // Try to remove directory if empty
+    try {
+        await fs.rmdir(installDir);
+    }
+    catch {
+        // Ignore if not empty or doesn't exist
+    }
+}
+// ─── Check installed skills from file system ──────────────────────────────────
+export async function getInstalledSkillsFromFs(projectPath) {
+    const result = [];
+    const userDir = getUserSkillsDir();
+    const projDir = getProjectSkillsDir(projectPath);
+    const scopedDirs = [
+        [userDir, "user"],
+        [projDir, "project"],
+    ];
+    for (const [dir, scope] of scopedDirs) {
+        try {
+            if (!(await fs.pathExists(dir)))
+                continue;
+            const entries = await fs.readdir(dir);
+            for (const entry of entries) {
+                const skillMd = path.join(dir, entry, "SKILL.md");
+                if (await fs.pathExists(skillMd)) {
+                    result.push({ name: entry, scope });
+                }
+            }
+        }
+        catch {
+            // ignore
+        }
+    }
+    return result;
+}