claudeup 4.5.5 → 4.6.0

package/package.json

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

package/src/data/skill-repos.js

@@ -88,6 +88,62 @@ export const RECOMMENDED_SKILLS = [
         stars: 81,
     },
 ];
+export const RECOMMENDED_SKILL_SETS = [
+    {
+        name: "Hugging Face",
+        repo: "huggingface/skills",
+        description: "Give your agents the power of the Hugging Face ecosystem",
+        icon: "\u{1F917}",
+        stars: 10000,
+    },
+];
+// ─── Star reliability classification ────────────────────────────────────────
+// Stars from these repos don't reflect individual skill quality.
+/** Mega-repos: huge projects that happen to include skills. Stars are about the project. */
+const MEGA_REPOS = new Set([
+    "microsoft/vscode",
+    "Significant-Gravitas/AutoGPT",
+    "n8n-io/n8n",
+    "anomalyco/opencode",
+    "shadcn-ui/ui",
+]);
+/** Skill-dump repos: large collections where stars reflect quantity, not quality. */
+const SKILL_DUMP_REPOS = new Set([
+    "affaan-m/everything-claude-code",
+    "openclaw/openclaw",
+    "jh941213/my-claude-code-asset",
+    "inferen-sh/skills",
+]);
+/**
+ * Classify how reliable a repo's star count is as a quality signal for its skills.
+ * - "dedicated": Stars reflect skill/repo quality (e.g. huggingface/skills, vercel-labs/agent-skills)
+ * - "mega-repo": Stars are about a larger project, not the skills (e.g. microsoft/vscode)
+ * - "skill-dump": Large skill collection — stars reflect popularity/quantity, not individual quality
+ */
+export function classifyStarReliability(repo, stars) {
+    if (MEGA_REPOS.has(repo))
+        return "mega-repo";
+    if (SKILL_DUMP_REPOS.has(repo))
+        return "skill-dump";
+    // Heuristic: unknown repos with >50K stars are likely mega-repos
+    if (stars && stars > 50000)
+        return "mega-repo";
+    return "dedicated";
+}
+export const STAR_RELIABILITY_INFO = {
+    dedicated: {
+        label: "Skill repo",
+        description: "Stars reflect this skill repository's quality",
+    },
+    "mega-repo": {
+        label: "Project repo",
+        description: "Stars are for the parent project, not the skills. Skill quality may vary.",
+    },
+    "skill-dump": {
+        label: "Skill collection",
+        description: "Large skill collection — stars reflect repo popularity, not individual skill quality.",
+    },
+};
 export const DEFAULT_SKILL_REPOS = [
     {
         label: "Vercel Agent Skills",

package/src/data/skill-repos.ts

@@ -1,4 +1,4 @@
-import type { SkillSource } from "../types/index.js";
+import type { SkillSource, StarReliability } from "../types/index.js";
 
 export interface RecommendedSkill {
 	name: string;
@@ -100,6 +100,75 @@ export const RECOMMENDED_SKILLS: RecommendedSkill[] = [
 	},
 ];
 
+// ─── Skill Sets (grouped skills from a single repo) ──────────────────────────
+
+export interface RecommendedSkillSet {
+  name: string;
+  repo: string;
+  description: string;
+  icon: string;
+  stars?: number;
+}
+
+export const RECOMMENDED_SKILL_SETS: RecommendedSkillSet[] = [
+  {
+    name: "Hugging Face",
+    repo: "huggingface/skills",
+    description: "Give your agents the power of the Hugging Face ecosystem",
+    icon: "\u{1F917}",
+    stars: 10000,
+  },
+];
+
+// ─── Star reliability classification ────────────────────────────────────────
+// Stars from these repos don't reflect individual skill quality.
+
+/** Mega-repos: huge projects that happen to include skills. Stars are about the project. */
+const MEGA_REPOS = new Set([
+  "microsoft/vscode",
+  "Significant-Gravitas/AutoGPT",
+  "n8n-io/n8n",
+  "anomalyco/opencode",
+  "shadcn-ui/ui",
+]);
+
+/** Skill-dump repos: large collections where stars reflect quantity, not quality. */
+const SKILL_DUMP_REPOS = new Set([
+  "affaan-m/everything-claude-code",
+  "openclaw/openclaw",
+  "jh941213/my-claude-code-asset",
+  "inferen-sh/skills",
+]);
+
+/**
+ * Classify how reliable a repo's star count is as a quality signal for its skills.
+ * - "dedicated": Stars reflect skill/repo quality (e.g. huggingface/skills, vercel-labs/agent-skills)
+ * - "mega-repo": Stars are about a larger project, not the skills (e.g. microsoft/vscode)
+ * - "skill-dump": Large skill collection — stars reflect popularity/quantity, not individual quality
+ */
+export function classifyStarReliability(repo: string, stars?: number): StarReliability {
+  if (MEGA_REPOS.has(repo)) return "mega-repo";
+  if (SKILL_DUMP_REPOS.has(repo)) return "skill-dump";
+  // Heuristic: unknown repos with >50K stars are likely mega-repos
+  if (stars && stars > 50000) return "mega-repo";
+  return "dedicated";
+}
+
+export const STAR_RELIABILITY_INFO: Record<StarReliability, { label: string; description: string }> = {
+  dedicated: {
+    label: "Skill repo",
+    description: "Stars reflect this skill repository's quality",
+  },
+  "mega-repo": {
+    label: "Project repo",
+    description: "Stars are for the parent project, not the skills. Skill quality may vary.",
+  },
+  "skill-dump": {
+    label: "Skill collection",
+    description: "Large skill collection — stars reflect repo popularity, not individual skill quality.",
+  },
+};
+
 export const DEFAULT_SKILL_REPOS: SkillSource[] = [
 	{
 		label: "Vercel Agent Skills",

package/src/services/skills-manager.js

@@ -1,7 +1,7 @@
 import fs from "fs-extra";
 import path from "node:path";
 import os from "node:os";
-import { RECOMMENDED_SKILLS } from "../data/skill-repos.js";
+import { RECOMMENDED_SKILLS, classifyStarReliability } from "../data/skill-repos.js";
 const SKILLS_API_BASE = "https://us-central1-claudish-6da10.cloudfunctions.net/skills";
 const treeCache = new Map();
 // ─── Path helpers ──────────────────────────────────────────────────────────────
@@ -48,6 +48,51 @@ async function fetchGitTree(repo) {
     treeCache.set(repo, { etag, tree, fetchedAt: Date.now() });
     return tree;
 }
+// ─── Skill Set fetching ──────────────────────────────────────────────────────
+/**
+ * Fetch all skills from a skill set repo using the GitHub Tree API.
+ * Returns SkillInfo[] with installed status marked via disk scan.
+ */
+export async function fetchSkillSetSkills(repo, projectPath) {
+    const tree = await fetchGitTree(repo);
+    // Find all SKILL.md blobs
+    const skillBlobs = tree.tree.filter((entry) => entry.type === "blob" && entry.path.endsWith("/SKILL.md"));
+    const userInstalled = await getInstalledSkillNames("user");
+    const projectInstalled = await getInstalledSkillNames("project", projectPath);
+    const slugify = (name) => name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
+    const source = {
+        label: repo,
+        repo,
+        skillsPath: "",
+    };
+    return skillBlobs.map((blob) => {
+        // Derive skill name from parent directory of SKILL.md
+        const parts = blob.path.split("/");
+        const name = parts[parts.length - 2]; // e.g. "huggingface-datasets"
+        const repoPath = blob.path; // e.g. "skills/huggingface-datasets/SKILL.md"
+        const slug = slugify(name);
+        const isUser = userInstalled.has(slug) || userInstalled.has(name);
+        const isProj = projectInstalled.has(slug) || projectInstalled.has(name);
+        const installed = isUser || isProj;
+        const installedScope = isProj
+            ? "project"
+            : isUser
+                ? "user"
+                : null;
+        return {
+            id: `${repo}/${blob.path.replace("/SKILL.md", "")}`,
+            name,
+            source,
+            repoPath,
+            gitBlobSha: blob.sha,
+            frontmatter: null,
+            installed,
+            installedScope,
+            hasUpdate: false,
+            description: "",
+        };
+    });
+}
 // ─── Frontmatter parser ───────────────────────────────────────────────────────
 function parseYamlFrontmatter(content) {
     const frontmatterMatch = content.match(/^---\s*\n([\s\S]*?)\n---/);
@@ -134,6 +179,7 @@ function mapApiSkillToSkillInfo(raw) {
         repo,
         skillsPath: "",
     };
+    const stars = typeof raw.stars === "number" ? raw.stars : undefined;
     return {
         id: `${repo}/${skillPath}`,
         name: raw.name || skillPath,
@@ -145,7 +191,8 @@ function mapApiSkillToSkillInfo(raw) {
         installed: false,
         installedScope: null,
         hasUpdate: false,
-        stars: typeof raw.stars === "number" ? raw.stars : undefined,
+        stars,
+        starReliability: classifyStarReliability(repo, stars),
     };
 }
 export async function fetchPopularSkills(limit = 30) {
@@ -196,6 +243,7 @@ export async function fetchAvailableSkills(_repos, projectPath) {
             installedScope: null,
             hasUpdate: false,
             isRecommended: true,
+            starReliability: classifyStarReliability(rec.repo, rec.stars),
         };
         return markInstalled(skill);
     });

package/src/services/skills-manager.ts

@@ -7,7 +7,7 @@ import type {
 	SkillFrontmatter,
 	GitTreeResponse,
 } from "../types/index.js";
-import { RECOMMENDED_SKILLS } from "../data/skill-repos.js";
+import { RECOMMENDED_SKILLS, classifyStarReliability } from "../data/skill-repos.js";
 
 const SKILLS_API_BASE =
 	"https://us-central1-claudish-6da10.cloudfunctions.net/skills";
@@ -85,6 +85,66 @@ async function fetchGitTree(repo: string): Promise<GitTreeResponse> {
 	return tree;
 }
 
+// ─── Skill Set fetching ──────────────────────────────────────────────────────
+
+/**
+ * Fetch all skills from a skill set repo using the GitHub Tree API.
+ * Returns SkillInfo[] with installed status marked via disk scan.
+ */
+export async function fetchSkillSetSkills(
+	repo: string,
+	projectPath?: string,
+): Promise<SkillInfo[]> {
+	const tree = await fetchGitTree(repo);
+
+	// Find all SKILL.md blobs
+	const skillBlobs = tree.tree.filter(
+		(entry) => entry.type === "blob" && entry.path.endsWith("/SKILL.md"),
+	);
+
+	const userInstalled = await getInstalledSkillNames("user");
+	const projectInstalled = await getInstalledSkillNames("project", projectPath);
+
+	const slugify = (name: string) =>
+		name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
+
+	const source: SkillSource = {
+		label: repo,
+		repo,
+		skillsPath: "",
+	};
+
+	return skillBlobs.map((blob) => {
+		// Derive skill name from parent directory of SKILL.md
+		const parts = blob.path.split("/");
+		const name = parts[parts.length - 2]; // e.g. "huggingface-datasets"
+		const repoPath = blob.path; // e.g. "skills/huggingface-datasets/SKILL.md"
+		const slug = slugify(name);
+
+		const isUser = userInstalled.has(slug) || userInstalled.has(name);
+		const isProj = projectInstalled.has(slug) || projectInstalled.has(name);
+		const installed = isUser || isProj;
+		const installedScope: "user" | "project" | null = isProj
+			? "project"
+			: isUser
+				? "user"
+				: null;
+
+		return {
+			id: `${repo}/${blob.path.replace("/SKILL.md", "")}`,
+			name,
+			source,
+			repoPath,
+			gitBlobSha: blob.sha,
+			frontmatter: null,
+			installed,
+			installedScope,
+			hasUpdate: false,
+			description: "",
+		};
+	});
+}
+
 // ─── Frontmatter parser ───────────────────────────────────────────────────────
 
 function parseYamlFrontmatter(content: string): Partial<SkillFrontmatter> {
@@ -190,6 +250,7 @@ function mapApiSkillToSkillInfo(raw: any): SkillInfo {
 		repo,
 		skillsPath: "",
 	};
+	const stars = typeof raw.stars === "number" ? raw.stars : undefined;
 	return {
 		id: `${repo}/${skillPath}`,
 		name: (raw.name as string) || skillPath,
@@ -201,7 +262,8 @@ function mapApiSkillToSkillInfo(raw: any): SkillInfo {
 		installed: false,
 		installedScope: null,
 		hasUpdate: false,
-		stars: typeof raw.stars === "number" ? raw.stars : undefined,
+		stars,
+		starReliability: classifyStarReliability(repo, stars),
 	};
 }
 
@@ -263,6 +325,7 @@ export async function fetchAvailableSkills(
 			installedScope: null,
 			hasUpdate: false,
 			isRecommended: true,
+			starReliability: classifyStarReliability(rec.repo, rec.stars),
 		};
 		return markInstalled(skill);
 	});

package/src/types/index.ts

@@ -168,6 +168,35 @@ export interface SkillInfo {
 	stars?: number;
 	/** Short description (from API, before frontmatter is loaded) */
 	description?: string;
+	/** How reliable the star count is as a quality signal for this skill */
+	starReliability?: "dedicated" | "mega-repo" | "skill-dump";
+}
+
+/** How reliable the star count is as a quality signal for this skill */
+export type StarReliability = "dedicated" | "mega-repo" | "skill-dump";
+
+/** A skill set — a group of skills from a single repo */
+export interface SkillSetInfo {
+	/** Unique key, e.g. "huggingface/skills" */
+	id: string;
+	/** Display name, e.g. "Hugging Face" */
+	name: string;
+	/** Repo description */
+	description: string;
+	/** GitHub owner/repo */
+	repo: string;
+	/** Icon/emoji for display */
+	icon: string;
+	/** GitHub star count */
+	stars?: number;
+	/** Individual skills within this set (fetched lazily via Tree API) */
+	skills: SkillInfo[];
+	/** Whether skills have been fetched yet */
+	loaded: boolean;
+	/** Loading state */
+	loading: boolean;
+	/** Error if fetch failed */
+	error?: string;
 }
 
 // ─── GitHub Tree API types ────────────────────────────────────────────────────

package/src/ui/adapters/skillsAdapter.js

@@ -2,7 +2,7 @@
  * Builds the flat list of items for the SkillsScreen list panel.
  * Extracted from SkillsScreen so it can be tested independently.
  */
-export function buildSkillBrowserItems({ recommended, popular, installed, searchResults, query, isSearchLoading, }) {
+export function buildSkillBrowserItems({ recommended, popular, installed, searchResults, query, isSearchLoading, skillSets = [], expandedSets = new Set(), }) {
     const lowerQuery = query.toLowerCase();
     const items = [];
     // ── INSTALLED: always shown at top (if any) ──
@@ -18,7 +18,7 @@ export function buildSkillBrowserItems({ recommended, popular, installed, search
             categoryKey: "installed",
             count: installedFiltered.length,
             tone: "purple",
-            star: "● ",
+            star: "\u25CF ",
         });
         for (const skill of installedFiltered) {
             items.push({
@@ -29,21 +29,60 @@ export function buildSkillBrowserItems({ recommended, popular, installed, search
             });
         }
     }
-    // ── RECOMMENDED: always shown, filtered when searching ──
+    // ── RECOMMENDED: skill sets + individual skills, all as first-class items ──
+    const filteredSets = lowerQuery
+        ? skillSets.filter((s) => {
+            if (s.name.toLowerCase().includes(lowerQuery))
+                return true;
+            if (s.description.toLowerCase().includes(lowerQuery))
+                return true;
+            if (s.loaded && s.skills.some((sk) => sk.name.toLowerCase().includes(lowerQuery)))
+                return true;
+            return false;
+        })
+        : skillSets;
     const filteredRec = lowerQuery
         ? recommended.filter((s) => s.name.toLowerCase().includes(lowerQuery) ||
             (s.description || "").toLowerCase().includes(lowerQuery))
         : recommended;
+    const recommendedCount = filteredSets.length + filteredRec.length;
     items.push({
         id: "cat:recommended",
         kind: "category",
         label: "Recommended",
         title: "Recommended",
         categoryKey: "recommended",
-        count: filteredRec.length,
+        count: recommendedCount,
         tone: "green",
-        star: "★ ",
+        star: "\u2605 ",
     });
+    // Skill sets first within recommended
+    for (const set of filteredSets) {
+        const isExpanded = expandedSets.has(set.id);
+        items.push({
+            id: `skillset:${set.id}`,
+            kind: "skillset",
+            label: set.name,
+            skillSet: set,
+            expanded: isExpanded,
+        });
+        // When expanded, show child skills as indented skill items
+        if (isExpanded && set.loaded) {
+            const childSkills = lowerQuery
+                ? set.skills.filter((sk) => sk.name.toLowerCase().includes(lowerQuery))
+                : set.skills;
+            for (const skill of childSkills) {
+                items.push({
+                    id: `skill:${skill.id}`,
+                    kind: "skill",
+                    label: skill.name,
+                    skill,
+                    indent: 2,
+                });
+            }
+        }
+    }
+    // Then individual recommended skills
     for (const skill of filteredRec) {
         items.push({
             id: `skill:${skill.id}`,
@@ -82,18 +121,27 @@ export function buildSkillBrowserItems({ recommended, popular, installed, search
         return items;
     }
     // ── POPULAR (default, no search query) — only skills with meaningful stars ──
-    const popularWithStars = popular.filter((s) => (s.stars ?? 0) >= 5);
-    if (popularWithStars.length > 0) {
+    // Dedup by name — API can return same skill name from different repos
+    const seenPopular = new Set();
+    const popularDeduped = popular
+        .filter((s) => (s.stars ?? 0) >= 5)
+        .filter((s) => {
+        if (seenPopular.has(s.name))
+            return false;
+        seenPopular.add(s.name);
+        return true;
+    });
+    if (popularDeduped.length > 0) {
         items.push({
             id: "cat:popular",
             kind: "category",
             label: "Popular",
             title: "Popular",
             categoryKey: "popular",
-            count: popularWithStars.length,
+            count: popularDeduped.length,
             tone: "teal",
         });
-        for (const skill of popularWithStars) {
+        for (const skill of popularDeduped) {
             items.push({
                 id: `skill:${skill.id}`,
                 kind: "skill",

package/src/ui/adapters/skillsAdapter.ts

@@ -1,4 +1,4 @@
-import type { SkillInfo } from "../../types/index.js";
+import type { SkillInfo, SkillSetInfo } from "../../types/index.js";
 
 // ─── Item types ───────────────────────────────────────────────────────────────
 
@@ -19,9 +19,19 @@ export interface SkillSkillItem {
   kind: "skill";
   label: string;
   skill: SkillInfo;
+  /** Extra indent level for child skills inside an expanded skill set */
+  indent?: number;
 }
 
-export type SkillBrowserItem = SkillCategoryItem | SkillSkillItem;
+export interface SkillSetItem {
+  id: string;
+  kind: "skillset";
+  label: string;
+  skillSet: SkillSetInfo;
+  expanded: boolean;
+}
+
+export type SkillBrowserItem = SkillCategoryItem | SkillSkillItem | SkillSetItem;
 
 // ─── Adapter ─────────────────────────────────────────────────────────────────
 
@@ -32,6 +42,8 @@ export interface BuildSkillBrowserItemsArgs {
   searchResults: SkillInfo[];
   query: string;
   isSearchLoading: boolean;
+  skillSets?: SkillSetInfo[];
+  expandedSets?: Set<string>;
 }
 
 /**
@@ -45,6 +57,8 @@ export function buildSkillBrowserItems({
   searchResults,
   query,
   isSearchLoading,
+  skillSets = [],
+  expandedSets = new Set(),
 }: BuildSkillBrowserItemsArgs): SkillBrowserItem[] {
   const lowerQuery = query.toLowerCase();
   const items: SkillBrowserItem[] = [];
@@ -63,7 +77,7 @@ export function buildSkillBrowserItems({
       categoryKey: "installed",
       count: installedFiltered.length,
       tone: "purple",
-      star: "● ",
+      star: "\u25CF ",
     });
     for (const skill of installedFiltered) {
       items.push({
@@ -75,7 +89,16 @@ export function buildSkillBrowserItems({
     }
   }
 
-  // ── RECOMMENDED: always shown, filtered when searching ──
+  // ── RECOMMENDED: skill sets + individual skills, all as first-class items ──
+  const filteredSets = lowerQuery
+    ? skillSets.filter((s) => {
+        if (s.name.toLowerCase().includes(lowerQuery)) return true;
+        if (s.description.toLowerCase().includes(lowerQuery)) return true;
+        if (s.loaded && s.skills.some((sk) => sk.name.toLowerCase().includes(lowerQuery))) return true;
+        return false;
+      })
+    : skillSets;
+
   const filteredRec = lowerQuery
     ? recommended.filter(
         (s) =>
@@ -84,16 +107,47 @@ export function buildSkillBrowserItems({
       )
     : recommended;
 
+  const recommendedCount = filteredSets.length + filteredRec.length;
+
   items.push({
     id: "cat:recommended",
     kind: "category",
     label: "Recommended",
     title: "Recommended",
     categoryKey: "recommended",
-    count: filteredRec.length,
+    count: recommendedCount,
     tone: "green",
-    star: "★ ",
+    star: "\u2605 ",
   });
+
+  // Skill sets first within recommended
+  for (const set of filteredSets) {
+    const isExpanded = expandedSets.has(set.id);
+    items.push({
+      id: `skillset:${set.id}`,
+      kind: "skillset",
+      label: set.name,
+      skillSet: set,
+      expanded: isExpanded,
+    });
+    // When expanded, show child skills as indented skill items
+    if (isExpanded && set.loaded) {
+      const childSkills = lowerQuery
+        ? set.skills.filter((sk) => sk.name.toLowerCase().includes(lowerQuery))
+        : set.skills;
+      for (const skill of childSkills) {
+        items.push({
+          id: `skill:${skill.id}`,
+          kind: "skill",
+          label: skill.name,
+          skill,
+          indent: 2,
+        });
+      }
+    }
+  }
+
+  // Then individual recommended skills
   for (const skill of filteredRec) {
     items.push({
       id: `skill:${skill.id}`,
@@ -135,18 +189,26 @@ export function buildSkillBrowserItems({
   }
 
   // ── POPULAR (default, no search query) — only skills with meaningful stars ──
-  const popularWithStars = popular.filter((s) => (s.stars ?? 0) >= 5);
-  if (popularWithStars.length > 0) {
+  // Dedup by name — API can return same skill name from different repos
+  const seenPopular = new Set<string>();
+  const popularDeduped = popular
+    .filter((s) => (s.stars ?? 0) >= 5)
+    .filter((s) => {
+      if (seenPopular.has(s.name)) return false;
+      seenPopular.add(s.name);
+      return true;
+    });
+  if (popularDeduped.length > 0) {
     items.push({
       id: "cat:popular",
       kind: "category",
       label: "Popular",
       title: "Popular",
       categoryKey: "popular",
-      count: popularWithStars.length,
+      count: popularDeduped.length,
       tone: "teal",
     });
-    for (const skill of popularWithStars) {
+    for (const skill of popularDeduped) {
       items.push({
         id: `skill:${skill.id}`,
         kind: "skill",