claudeup 3.8.0 → 3.9.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claudeup",
-  "version": "3.8.0",
+  "version": "3.9.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: "find-skills",
+        description: "Discover and install new skills from the ecosystem",
+        category: "search",
+    },
+    {
+        name: "React Best Practices",
+        repo: "vercel-labs/agent-skills",
+        skillPath: "vercel-react-best-practices",
+        description: "Modern React patterns and Vercel deployment guidelines",
+        category: "frontend",
+    },
+    {
+        name: "Web Design Guidelines",
+        repo: "vercel-labs/agent-skills",
+        skillPath: "web-design-guidelines",
+        description: "UI/UX design principles and web standards",
+        category: "design",
+    },
+    {
+        name: "Remotion Best Practices",
+        repo: "remotion-dev/skills",
+        skillPath: "remotion-best-practices",
+        description: "Programmatic video creation with Remotion",
+        category: "media",
+    },
+    {
+        name: "UI/UX Pro Max",
+        repo: "nextlevelbuilder/ui-ux-pro-max-skill",
+        skillPath: "ui-ux-pro-max",
+        description: "Advanced UI/UX design and implementation patterns",
+        category: "design",
+    },
+    {
+        name: "ElevenLabs TTS",
+        repo: "inferen-sh/skills",
+        skillPath: "elevenlabs-tts",
+        description: "Text-to-speech with ElevenLabs API integration",
+        category: "media",
+    },
+    {
+        name: "Audit Website",
+        repo: "squirrelscan/skills",
+        skillPath: "audit-website",
+        description: "Security and quality auditing for web applications",
+        category: "security",
+    },
+    {
+        name: "Systematic Debugging",
+        repo: "obra/superpowers",
+        skillPath: "systematic-debugging",
+        description: "Structured debugging methodology with root cause analysis",
+        category: "debugging",
+    },
+    {
+        name: "shadcn/ui",
+        repo: "shadcn/ui",
+        skillPath: "shadcn",
+        description: "shadcn/ui component library patterns and usage",
+        category: "frontend",
+    },
+    {
+        name: "Neon Postgres",
+        repo: "neondatabase/agent-skills",
+        skillPath: "neon-postgres",
+        description: "Neon serverless Postgres setup and best practices",
+        category: "database",
+    },
+    {
+        name: "Neon Serverless",
+        repo: "neondatabase/ai-rules",
+        skillPath: "neon-serverless",
+        description: "Serverless database patterns with Neon",
+        category: "database",
+    },
+];
+export const DEFAULT_SKILL_REPOS = [
+    {
+        label: "vercel-labs/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: "find-skills",
+		description: "Discover and install new skills from the ecosystem",
+		category: "search",
+	},
+	{
+		name: "React Best Practices",
+		repo: "vercel-labs/agent-skills",
+		skillPath: "vercel-react-best-practices",
+		description: "Modern React patterns and Vercel deployment guidelines",
+		category: "frontend",
+	},
+	{
+		name: "Web Design Guidelines",
+		repo: "vercel-labs/agent-skills",
+		skillPath: "web-design-guidelines",
+		description: "UI/UX design principles and web standards",
+		category: "design",
+	},
+	{
+		name: "Remotion Best Practices",
+		repo: "remotion-dev/skills",
+		skillPath: "remotion-best-practices",
+		description: "Programmatic video creation with Remotion",
+		category: "media",
+	},
+	{
+		name: "UI/UX Pro Max",
+		repo: "nextlevelbuilder/ui-ux-pro-max-skill",
+		skillPath: "ui-ux-pro-max",
+		description: "Advanced UI/UX design and implementation patterns",
+		category: "design",
+	},
+	{
+		name: "ElevenLabs TTS",
+		repo: "inferen-sh/skills",
+		skillPath: "elevenlabs-tts",
+		description: "Text-to-speech with ElevenLabs API integration",
+		category: "media",
+	},
+	{
+		name: "Audit Website",
+		repo: "squirrelscan/skills",
+		skillPath: "audit-website",
+		description: "Security and quality auditing for web applications",
+		category: "security",
+	},
+	{
+		name: "Systematic Debugging",
+		repo: "obra/superpowers",
+		skillPath: "systematic-debugging",
+		description: "Structured debugging methodology with root cause analysis",
+		category: "debugging",
+	},
+	{
+		name: "shadcn/ui",
+		repo: "shadcn/ui",
+		skillPath: "shadcn",
+		description: "shadcn/ui component library patterns and usage",
+		category: "frontend",
+	},
+	{
+		name: "Neon Postgres",
+		repo: "neondatabase/agent-skills",
+		skillPath: "neon-postgres",
+		description: "Neon serverless Postgres setup and best practices",
+		category: "database",
+	},
+	{
+		name: "Neon Serverless",
+		repo: "neondatabase/ai-rules",
+		skillPath: "neon-serverless",
+		description: "Serverless database patterns with Neon",
+		category: "database",
+	},
+];
+
+export const DEFAULT_SKILL_REPOS: SkillSource[] = [
+	{
+		label: "vercel-labs/agent-skills",
+		repo: "vercel-labs/agent-skills",
+		skillsPath: "skills",
+	},
+];

package/src/services/skills-manager.js

@@ -0,0 +1,239 @@
+import fs from "fs-extra";
+import path from "node:path";
+import os from "node:os";
+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;
+}
+// ─── Fetch available skills ───────────────────────────────────────────────────
+export async function fetchAvailableSkills(repos, projectPath) {
+    const userInstalled = await getInstalledSkillNames("user");
+    const projectInstalled = await getInstalledSkillNames("project", projectPath);
+    const skills = [];
+    for (const source of repos) {
+        let tree;
+        try {
+            tree = await fetchGitTree(source.repo);
+        }
+        catch {
+            // Skip this repo on error
+            continue;
+        }
+        // Filter for SKILL.md files under skillsPath
+        const prefix = source.skillsPath ? `${source.skillsPath}/` : "";
+        for (const item of tree.tree) {
+            if (item.type !== "blob")
+                continue;
+            if (!item.path.endsWith("/SKILL.md"))
+                continue;
+            if (prefix && !item.path.startsWith(prefix))
+                continue;
+            // Extract skill name: second-to-last segment of path
+            const parts = item.path.split("/");
+            if (parts.length < 2)
+                continue;
+            const skillName = parts[parts.length - 2];
+            // Validate name (prevent traversal)
+            if (!/^[a-z0-9][a-z0-9-_]*$/i.test(skillName))
+                continue;
+            const isUserInstalled = userInstalled.has(skillName);
+            const isProjInstalled = projectInstalled.has(skillName);
+            const installed = isUserInstalled || isProjInstalled;
+            const installedScope = isProjInstalled
+                ? "project"
+                : isUserInstalled
+                    ? "user"
+                    : null;
+            skills.push({
+                id: `${source.repo}/${item.path}`,
+                name: skillName,
+                source,
+                repoPath: item.path,
+                gitBlobSha: item.sha,
+                frontmatter: null,
+                installed,
+                installedScope,
+                hasUpdate: false,
+            });
+        }
+    }
+    // Sort by name within each repo
+    skills.sort((a, b) => a.name.localeCompare(b.name));
+    return skills;
+}
+// ─── Install / Uninstall ──────────────────────────────────────────────────────
+export async function installSkill(skill, scope, projectPath) {
+    const url = `https://raw.githubusercontent.com/${skill.source.repo}/HEAD/${skill.repoPath}`;
+    const response = await fetch(url, {
+        signal: AbortSignal.timeout(15000),
+    });
+    if (!response.ok) {
+        throw new Error(`Failed to fetch skill: ${response.status} ${response.statusText}`);
+    }
+    const content = await response.text();
+    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;
+}