claudeup 3.9.0 → 3.11.0

package/package.json

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

package/src/data/skill-repos.js

@@ -2,84 +2,84 @@ export const RECOMMENDED_SKILLS = [
     {
         name: "Find Skills",
         repo: "vercel-labs/skills",
-        skillPath: "find-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: "vercel-react-best-practices",
+        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: "web-design-guidelines",
+        skillPath: "skills/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",
+        skillPath: "skills/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",
+        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: "elevenlabs-tts",
+        skillPath: "skills/elevenlabs-tts",
         description: "Text-to-speech with ElevenLabs API integration",
         category: "media",
     },
     {
         name: "Audit Website",
         repo: "squirrelscan/skills",
-        skillPath: "audit-website",
+        skillPath: "skills/audit-website",
         description: "Security and quality auditing for web applications",
         category: "security",
     },
     {
         name: "Systematic Debugging",
         repo: "obra/superpowers",
-        skillPath: "systematic-debugging",
+        skillPath: "skills/systematic-debugging",
         description: "Structured debugging methodology with root cause analysis",
         category: "debugging",
     },
     {
         name: "shadcn/ui",
-        repo: "shadcn/ui",
-        skillPath: "shadcn",
+        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: "neon-postgres",
+        skillPath: "skills/neon-postgres",
         description: "Neon serverless Postgres setup and best practices",
         category: "database",
     },
     {
         name: "Neon Serverless",
         repo: "neondatabase/ai-rules",
-        skillPath: "neon-serverless",
+        skillPath: "skills/neon-serverless",
         description: "Serverless database patterns with Neon",
         category: "database",
     },
 ];
 export const DEFAULT_SKILL_REPOS = [
     {
-        label: "vercel-labs/agent-skills",
+        label: "Vercel Agent Skills",
         repo: "vercel-labs/agent-skills",
         skillsPath: "skills",
     },

package/src/data/skill-repos.ts

@@ -12,77 +12,77 @@ export const RECOMMENDED_SKILLS: RecommendedSkill[] = [
 	{
 		name: "Find Skills",
 		repo: "vercel-labs/skills",
-		skillPath: "find-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: "vercel-react-best-practices",
+		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: "web-design-guidelines",
+		skillPath: "skills/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",
+		skillPath: "skills/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",
+		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: "elevenlabs-tts",
+		skillPath: "skills/elevenlabs-tts",
 		description: "Text-to-speech with ElevenLabs API integration",
 		category: "media",
 	},
 	{
 		name: "Audit Website",
 		repo: "squirrelscan/skills",
-		skillPath: "audit-website",
+		skillPath: "skills/audit-website",
 		description: "Security and quality auditing for web applications",
 		category: "security",
 	},
 	{
 		name: "Systematic Debugging",
 		repo: "obra/superpowers",
-		skillPath: "systematic-debugging",
+		skillPath: "skills/systematic-debugging",
 		description: "Structured debugging methodology with root cause analysis",
 		category: "debugging",
 	},
 	{
 		name: "shadcn/ui",
-		repo: "shadcn/ui",
-		skillPath: "shadcn",
+		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: "neon-postgres",
+		skillPath: "skills/neon-postgres",
 		description: "Neon serverless Postgres setup and best practices",
 		category: "database",
 	},
 	{
 		name: "Neon Serverless",
 		repo: "neondatabase/ai-rules",
-		skillPath: "neon-serverless",
+		skillPath: "skills/neon-serverless",
 		description: "Serverless database patterns with Neon",
 		category: "database",
 	},
@@ -90,7 +90,7 @@ export const RECOMMENDED_SKILLS: RecommendedSkill[] = [
 
 export const DEFAULT_SKILL_REPOS: SkillSource[] = [
 	{
-		label: "vercel-labs/agent-skills",
+		label: "Vercel Agent Skills",
 		repo: "vercel-labs/agent-skills",
 		skillsPath: "skills",
 	},

package/src/services/skills-manager.js

@@ -1,6 +1,8 @@
 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() {
@@ -122,72 +124,138 @@ export async function getInstalledSkillNames(scope, projectPath) {
     }
     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) {
+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;
+    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 {
-            tree = await fetchGitTree(source.repo);
+            const response = await fetch(url, { signal: AbortSignal.timeout(8000) });
+            if (response.ok) {
+                content = await response.text();
+                break;
+            }
         }
         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}`);
+    if (!content) {
+        throw new Error(`Failed to fetch skill: SKILL.md not found in ${repo}/${repoPath}`);
     }
-    const content = await response.text();
     const installDir = scope === "user"
         ? path.join(getUserSkillsDir(), skill.name)
         : path.join(getProjectSkillsDir(projectPath), skill.name);

package/src/services/skills-manager.ts

@@ -7,6 +7,10 @@ import type {
 	SkillFrontmatter,
 	GitTreeResponse,
 } from "../types/index.js";
+import { RECOMMENDED_SKILLS } from "../data/skill-repos.js";
+
+const SKILLS_API_BASE =
+	"https://us-central1-claudish-6da10.cloudfunctions.net/skills";
 
 // ─── In-process cache ─────────────────────────────────────────────────────────
 
@@ -175,69 +179,122 @@ export async function getInstalledSkillNames(
 	return installed;
 }
 
+// ─── Firebase Skills API ──────────────────────────────────────────────────────
+
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function mapApiSkillToSkillInfo(raw: any): SkillInfo {
+	const repo = (raw.repo as string) || "unknown";
+	const skillPath = (raw.skillPath as string) || (raw.name as string) || "";
+	const source: SkillSource = {
+		label: repo,
+		repo,
+		skillsPath: "",
+	};
+	return {
+		id: `${repo}/${skillPath}`,
+		name: (raw.name as string) || skillPath,
+		description: (raw.description as string) || "",
+		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): Promise<SkillInfo[]> {
+	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()) as { skills?: unknown[] };
+		return (data.skills || []).map(mapApiSkillToSkillInfo);
+	} catch {
+		return [];
+	}
+}
+
 // ─── Fetch available skills ───────────────────────────────────────────────────
 
 export async function fetchAvailableSkills(
-	repos: SkillSource[],
+	_repos: SkillSource[],
 	projectPath?: string,
 ): Promise<SkillInfo[]> {
 	const userInstalled = await getInstalledSkillNames("user");
 	const projectInstalled = await getInstalledSkillNames("project", projectPath);
 
-	const skills: SkillInfo[] = [];
+	const markInstalled = (skill: SkillInfo): SkillInfo => {
+		const isUserInstalled = userInstalled.has(skill.name);
+		const isProjInstalled = projectInstalled.has(skill.name);
+		const installed = isUserInstalled || isProjInstalled;
+		const installedScope: "user" | "project" | null = isProjInstalled
+			? "project"
+			: isUserInstalled
+				? "user"
+				: null;
+		return { ...skill, installed, installedScope };
+	};
 
-	for (const source of repos) {
-		let tree: GitTreeResponse;
-		try {
-			tree = await fetchGitTree(source.repo);
-		} catch {
-			// Skip this repo on error
-			continue;
-		}
+	// 1. Recommended skills from RECOMMENDED_SKILLS constant (no API call)
+	const recommendedSkills: SkillInfo[] = RECOMMENDED_SKILLS.map((rec) => {
+		const source: SkillSource = {
+			label: rec.repo,
+			repo: rec.repo,
+			skillsPath: "",
+		};
+		const skill: SkillInfo = {
+			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);
+	});
 
-		// 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: "user" | "project" | null = 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,
-			});
-		}
+	// 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<string, number>();
+	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()) as { stargazers_count?: number };
+				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;
 	}
 
-	// Sort by name within each repo
-	skills.sort((a, b) => a.name.localeCompare(b.name));
+	// 4. Combine: recommended first, then popular (dedup by name)
+	const seen = new Set<string>(recommendedSkills.map((s) => s.name));
+	const deduped = popularSkills.filter((s) => !seen.has(s.name));
 
-	return skills;
+	return [...recommendedSkills, ...deduped];
 }
 
 // ─── Install / Uninstall ──────────────────────────────────────────────────────
@@ -247,20 +304,36 @@ export async function installSkill(
 	scope: "user" | "project",
 	projectPath?: string,
 ): Promise<void> {
-	const url = `https://raw.githubusercontent.com/${skill.source.repo}/HEAD/${skill.repoPath}`;
+	// 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`,
+	];
 
-	const response = await fetch(url, {
-		signal: AbortSignal.timeout(15000),
-	});
+	let content: string | null = 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 (!response.ok) {
+	if (!content) {
 		throw new Error(
-			`Failed to fetch skill: ${response.status} ${response.statusText}`,
+			`Failed to fetch skill: SKILL.md not found in ${repo}/${repoPath}`,
 		);
 	}
 
-	const content = await response.text();
-
 	const installDir =
 		scope === "user"
 			? path.join(getUserSkillsDir(), skill.name)

package/src/types/index.ts

@@ -164,6 +164,10 @@ export interface SkillInfo {
 	hasUpdate: boolean;
 	/** Whether this is a recommended skill */
 	isRecommended?: boolean;
+	/** GitHub star count from the skills API */
+	stars?: number;
+	/** Short description (from API, before frontmatter is loaded) */
+	description?: string;
 }
 
 // ─── GitHub Tree API types ────────────────────────────────────────────────────