@storyclaw/talenthub 0.3.0 → 0.3.2

package/dist/commands/agent-install.js

@@ -1,6 +1,6 @@
 import fs from "node:fs";
 import path from "node:path";
-import { isClawhubAvailable, installSkill } from "../lib/clawhub.js";
+import { installAllSkills } from "../lib/skills.js";
 import { addOrUpdateAgent, findAgentEntry, readConfig, writeConfig } from "../lib/config.js";
 import { fetchCatalog, fetchManifest } from "../lib/registry.js";
 import { resolveWorkspaceDir } from "../lib/paths.js";
@@ -21,7 +21,6 @@ export async function agentInstall(name, options) {
         console.error(`Agent "${name}" already exists in config. Use --force to overwrite.`);
         process.exit(1);
     }
-    const hasClawhub = isClawhubAvailable();
     const wsDir = resolveWorkspaceDir(name);
     fs.mkdirSync(wsDir, { recursive: true });
     console.log("Writing agent files...");
@@ -34,35 +33,29 @@ export async function agentInstall(name, options) {
     }
     let installed = 0;
     let failed = 0;
-    if (hasClawhub && manifest.skills.length > 0) {
-        console.log(`Installing ${manifest.skills.length} skills via clawhub...`);
-        for (const skill of manifest.skills) {
-            const ok = installSkill(skill, wsDir);
-            if (ok)
-                installed++;
-            else
-                failed++;
-        }
-    }
-    else if (!hasClawhub && manifest.skills.length > 0) {
-        console.log(`Skipping ${manifest.skills.length} skills (clawhub not installed).`);
-        console.log("Install clawhub later: npm i -g clawhub");
-        console.log(`Then run: talenthub agent update ${name}`);
+    let skipped = 0;
+    if (manifest.skills.length > 0) {
+        console.log(`Installing ${manifest.skills.length} skills via npx skills...`);
+        const result = installAllSkills(manifest.skills, wsDir);
+        installed = result.installed;
+        failed = result.failed;
+        skipped = result.skipped;
     }
-    let updatedCfg = addOrUpdateAgent(cfg, {
+    const updatedCfg = addOrUpdateAgent(cfg, {
         id: manifest.id,
         name: manifest.name,
         skills: manifest.skills,
-        model: manifest.model,
     });
     writeConfig(updatedCfg);
     markInstalled(manifest.id, manifest.version);
-    console.log(`\n${manifest.emoji} Installed ${manifest.name}` +
-        (installed > 0 ? ` with ${installed} skills` : "") +
-        (failed > 0 ? ` (${failed} failed)` : "") +
-        (!hasClawhub && manifest.skills.length > 0
-            ? " (skills pending — install clawhub)"
-            : "") +
-        ".");
+    const parts = [];
+    if (installed > 0)
+        parts.push(`${installed} installed`);
+    if (skipped > 0)
+        parts.push(`${skipped} already present`);
+    if (failed > 0)
+        parts.push(`${failed} failed`);
+    const skillSummary = parts.length > 0 ? ` (skills: ${parts.join(", ")})` : "";
+    console.log(`\n${manifest.emoji} Installed ${manifest.name}${skillSummary}.`);
     console.log("Restart the OpenClaw gateway to apply changes.");
 }

package/dist/commands/agent-publish.js

@@ -102,6 +102,7 @@ export async function agentPublish(name, opts = {}) {
         agents_prompt: files["AGENTS.md"] || "",
         min_openclaw_version: manifest.minOpenClawVersion || null,
         avatar_url: manifest.avatarUrl || null,
+        is_public: true,
     };
     console.log(`\nPublishing ${payload.emoji || ""} ${payload.name} v${finalVersion}...`);
     const base = getRegistryBaseUrl();

package/dist/commands/agent-update.js

@@ -1,6 +1,6 @@
 import fs from "node:fs";
 import path from "node:path";
-import { ensureClawhub, installSkill, updateAllSkills } from "../lib/clawhub.js";
+import { installAllSkills, updateAllSkills } from "../lib/skills.js";
 import { addOrUpdateAgent, readConfig, writeConfig } from "../lib/config.js";
 import { fetchManifest } from "../lib/registry.js";
 import { resolveWorkspaceDir } from "../lib/paths.js";
@@ -15,7 +15,7 @@ async function updateAgent(agentId) {
         if (fs.existsSync(backupDir)) {
             fs.rmSync(backupDir, { recursive: true, force: true });
         }
-        fs.cpSync(wsDir, backupDir, { recursive: true });
+        fs.cpSync(wsDir, backupDir, { recursive: true, dereference: true });
     }
     fs.mkdirSync(wsDir, { recursive: true });
     // Write agent files from the registry response
@@ -26,37 +26,16 @@ async function updateAgent(agentId) {
             }
         }
     }
-    // Determine new skills to install
-    const lockPath = path.join(wsDir, ".clawhub", "lock.json");
-    const existingSkills = new Set();
-    if (fs.existsSync(lockPath)) {
-        try {
-            const lock = JSON.parse(fs.readFileSync(lockPath, "utf-8"));
-            for (const entry of lock.skills ?? []) {
-                if (entry.slug)
-                    existingSkills.add(entry.slug);
-            }
-        }
-        catch {
-            // Ignore parse errors
-        }
-    }
-    const newSkills = manifest.skills.filter((s) => !existingSkills.has(s));
-    if (newSkills.length > 0) {
-        ensureClawhub();
-        for (const skill of newSkills) {
-            installSkill(skill, wsDir);
-        }
+    // Install any new skills and re-sync symlinks for all
+    if (manifest.skills.length > 0) {
+        installAllSkills(manifest.skills, wsDir);
     }
-    // Update all existing skills
-    updateAllSkills(wsDir);
     // Update config
     const cfg = readConfig();
     const updatedCfg = addOrUpdateAgent(cfg, {
         id: manifest.id,
         name: manifest.name,
         skills: manifest.skills,
-        model: manifest.model,
     });
     writeConfig(updatedCfg);
     markInstalled(manifest.id, manifest.version);
@@ -69,8 +48,10 @@ export async function agentUpdate(name, options) {
             console.log("All agents are up to date.");
             return;
         }
-        ensureClawhub();
-        console.log(`Found ${updates.length} update(s):\n`);
+        // Update shared skills first
+        console.log("Updating shared skills...");
+        updateAllSkills();
+        console.log(`\nFound ${updates.length} update(s):\n`);
         for (const u of updates) {
             console.log(`  Updating ${u.name}: ${u.currentVersion} → ${u.latestVersion}`);
             await updateAgent(u.agentId);
@@ -84,7 +65,8 @@ export async function agentUpdate(name, options) {
         console.error(`Agent "${name}" is not installed. Use "talenthub agent install ${name}" first.`);
         process.exit(1);
     }
-    ensureClawhub();
+    console.log("Updating shared skills...");
+    updateAllSkills();
     console.log(`Updating agent "${name}"...`);
     await updateAgent(name);
     console.log(`✓ Agent "${name}" updated. Restart the OpenClaw gateway to apply changes.`);

package/dist/lib/skill-sources.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Mapping of skill slugs (as used in agent manifests) to their GitHub source
+ * repositories, verified via `npx skills find <slug>`.
+ *
+ * Used by: `node skills add <repo> --skill <skill> --agent openclaw -y`
+ *
+ * When the skill name in the repo differs from the manifest slug, the `skill`
+ * field provides the repo-side name.
+ */
+export type SkillSource = {
+    repo: string;
+    /** Override when the skill name in the repo differs from the manifest slug. */
+    skill?: string;
+};
+/**
+ * Canonical source map.
+ * Key   = slug used in agent manifests.
+ * Value = { repo, skill? } for `skills add <repo> --skill <skill|key>`.
+ *
+ * Sources picked by highest install count from `npx skills find`,
+ * except StoryClaw-owned skills which always come from the talenthub repo.
+ */
+export declare const SKILL_SOURCES: Record<string, SkillSource>;
+export declare function getSkillSource(slug: string): SkillSource | undefined;
+export declare function getInstallArgs(slug: string): {
+    repo: string;
+    skill: string;
+} | undefined;

package/dist/lib/skill-sources.js

@@ -0,0 +1,107 @@
+/**
+ * Mapping of skill slugs (as used in agent manifests) to their GitHub source
+ * repositories, verified via `npx skills find <slug>`.
+ *
+ * Used by: `node skills add <repo> --skill <skill> --agent openclaw -y`
+ *
+ * When the skill name in the repo differs from the manifest slug, the `skill`
+ * field provides the repo-side name.
+ */
+const TALENTHUB = "storyclaw-official/talenthub";
+/**
+ * Canonical source map.
+ * Key   = slug used in agent manifests.
+ * Value = { repo, skill? } for `skills add <repo> --skill <skill|key>`.
+ *
+ * Sources picked by highest install count from `npx skills find`,
+ * except StoryClaw-owned skills which always come from the talenthub repo.
+ */
+export const SKILL_SOURCES = {
+    // ── storyclaw-official/talenthub (our own skills) ──────────────────────
+    "storyclaw-x2c-publish": { repo: TALENTHUB },
+    "storyclaw-x-manager": { repo: TALENTHUB },
+    "giggle-files-management": { repo: TALENTHUB },
+    "storyclaw-alpaca-trading": { repo: TALENTHUB },
+    "storyclaw-polymarket-trading": { repo: TALENTHUB },
+    "storyclaw-trade-executor": { repo: TALENTHUB },
+    "giggle-market-monitor": { repo: TALENTHUB },
+    // ── browsing & search ──────────────────────────────────────────────────
+    // browser-use/browser-use@browser-use  49.6K installs
+    "browser-use": { repo: "browser-use/browser-use" },
+    // inferen-sh/skills@web-search  5.3K installs
+    "web-search": { repo: "inferen-sh/skills" },
+    // jamditis/claude-skills-journalism@web-scraping  1.5K installs
+    "web-scraping": { repo: "jamditis/claude-skills-journalism" },
+    // ── tavily suite (tavily-ai/skills uses short names) ───────────────────
+    // tavily-ai/skills@search  11.4K installs
+    "tavily-search": { repo: "tavily-ai/skills", skill: "search" },
+    // tavily-ai/skills@research  6.4K installs
+    "tavily-research": { repo: "tavily-ai/skills", skill: "research" },
+    // tavily-ai/skills@extract  4.7K installs
+    "tavily-extract": { repo: "tavily-ai/skills", skill: "extract" },
+    // tavily-ai/skills@crawl  3.4K installs
+    "tavily-crawl": { repo: "tavily-ai/skills", skill: "crawl" },
+    // ── documents (anthropics/skills) ──────────────────────────────────────
+    // anthropics/skills@pdf  38.8K installs
+    pdf: { repo: "anthropics/skills" },
+    // anthropics/skills@docx  30.6K installs
+    docx: { repo: "anthropics/skills" },
+    // anthropics/skills@xlsx  28.2K installs
+    xlsx: { repo: "anthropics/skills" },
+    // anthropics/skills@pptx  34.6K installs
+    pptx: { repo: "anthropics/skills" },
+    // ── design & creative (anthropics/skills) ──────────────────────────────
+    // anthropics/skills@frontend-design  159.8K installs
+    "frontend-design": { repo: "anthropics/skills" },
+    // anthropics/skills@canvas-design  19K installs
+    "canvas-design": { repo: "anthropics/skills" },
+    // anthropics/skills@skill-creator  83.9K installs
+    "skill-creator": { repo: "anthropics/skills" },
+    // ── media ──────────────────────────────────────────────────────────────
+    // remotion-dev/skills@remotion-best-practices  147.6K installs
+    remotion: { repo: "remotion-dev/skills", skill: "remotion-best-practices" },
+    // steipete/clawdis@video-frames  286 installs
+    "video-frames": { repo: "steipete/clawdis" },
+    // steipete/clawdis@openai-image-gen  198 installs
+    "openai-image-gen": { repo: "steipete/clawdis" },
+    // inferen-sh/skills@text-to-speech  2.5K installs
+    speech: { repo: "inferen-sh/skills", skill: "text-to-speech" },
+    // elevenlabs/skills@speech-to-text  1.6K installs
+    "speech-to-text": { repo: "elevenlabs/skills" },
+    // github/awesome-copilot@nano-banana-pro-openrouter  7.3K installs
+    "nano-banana-pro": { repo: "github/awesome-copilot", skill: "nano-banana-pro-openrouter" },
+    // ── productivity ───────────────────────────────────────────────────────
+    // steipete/clawdis@summarize  3.6K installs
+    summarize: { repo: "steipete/clawdis" },
+    // steipete/clawdis@weather  1.6K installs
+    weather: { repo: "steipete/clawdis" },
+    // steipete/clawdis@session-logs  322 installs
+    "session-logs": { repo: "steipete/clawdis" },
+    // boomsystel-code/openclaw-workspace@imap-smtp-email  432 installs
+    "imap-smtp-email": { repo: "boomsystel-code/openclaw-workspace" },
+    // netease-youdao/lobsterai@scheduled-task  34 installs
+    "scheduled-task": { repo: "netease-youdao/lobsterai" },
+    // netease-youdao/lobsterai@local-tools  27 installs
+    "local-tools": { repo: "netease-youdao/lobsterai" },
+    // ── agent system ───────────────────────────────────────────────────────
+    // cantinaxyz/clawdstrike@clawdstrike  351 installs
+    clawdstrike: { repo: "cantinaxyz/clawdstrike" },
+    // vercel-labs/skills@find-skills  562.5K installs
+    "find-skills": { repo: "vercel-labs/skills" },
+    // ── third-party agent tools ────────────────────────────────────────────
+    // panniantong/agent-reach@agent-reach  1.9K installs
+    "agent-reach": { repo: "panniantong/agent-reach" },
+    // netease-youdao/lobsterai@films-search  41 installs
+    "films-search": { repo: "netease-youdao/lobsterai" },
+    // netease-youdao/lobsterai@music-search  36 installs
+    "music-search": { repo: "netease-youdao/lobsterai" },
+};
+export function getSkillSource(slug) {
+    return SKILL_SOURCES[slug];
+}
+export function getInstallArgs(slug) {
+    const src = SKILL_SOURCES[slug];
+    if (!src)
+        return undefined;
+    return { repo: src.repo, skill: src.skill ?? slug };
+}

package/dist/lib/skills.d.ts

@@ -0,0 +1,51 @@
+export type SkillSpec = {
+    repo: string;
+    skill: string;
+};
+/**
+ * Parse a fully-qualified skill string ("owner/repo@skill") into its parts.
+ * Returns undefined if the string is not in the expected format.
+ */
+export declare function parseSkillSpec(entry: string): SkillSpec | undefined;
+/**
+ * Extract just the skill name (directory name) from a fully-qualified entry.
+ */
+export declare function skillName(entry: string): string;
+/**
+ * Where installed skill folders live: `~/.openclaw/skills/<name>/`.
+ * The `skills` CLI creates a `skills/` subdirectory under its cwd,
+ * so we pass `resolveStateDir()` (~/.openclaw/) as the cwd.
+ */
+export declare function resolveSharedSkillsDir(): string;
+export declare function isSkillInstalled(name: string): boolean;
+/**
+ * Install a single skill via `skills add` into the shared directory,
+ * then symlink it into the agent workspace.
+ *
+ * @param entry Fully-qualified skill string ("owner/repo@skill")
+ * @param workspaceDir Agent workspace directory
+ * Returns true on success, false on failure (logged, non-fatal).
+ */
+export declare function installSkill(entry: string, workspaceDir: string): boolean;
+/**
+ * Install all skills for an agent: skip already-installed, batch-install
+ * missing skills grouped by repo (one clone per repo), then symlink
+ * everything into the workspace.
+ *
+ * @param skills Array of fully-qualified skill strings ("owner/repo@skill")
+ * Returns { installed, skipped, failed } counts.
+ */
+export declare function installAllSkills(skills: string[], workspaceDir: string): {
+    installed: number;
+    skipped: number;
+    failed: number;
+};
+/**
+ * Update all installed skills via `skills update`.
+ */
+export declare function updateAllSkills(): boolean;
+/**
+ * Re-sync symlinks for an agent workspace.
+ * Ensures every skill in the list is linked; adds new links, preserves existing.
+ */
+export declare function syncSkillLinks(skills: string[], workspaceDir: string): void;

package/dist/lib/skills.js

@@ -0,0 +1,197 @@
+import { execSync } from "node:child_process";
+import fs from "node:fs";
+import path from "node:path";
+import { createRequire } from "node:module";
+import { resolveStateDir } from "./paths.js";
+/**
+ * Resolve the `skills` binary shipped as a dependency rather than relying on
+ * `npx` (which re-downloads on every invocation). Falls back to bare `skills`
+ * on PATH if the local binary cannot be resolved.
+ */
+function resolveSkillsBin() {
+    try {
+        const require = createRequire(import.meta.url);
+        const pkgJson = require.resolve("skills/package.json");
+        return path.join(path.dirname(pkgJson), "bin", "cli.mjs");
+    }
+    catch {
+        return "skills";
+    }
+}
+const SKILLS_BIN = resolveSkillsBin();
+/**
+ * Parse a fully-qualified skill string ("owner/repo@skill") into its parts.
+ * Returns undefined if the string is not in the expected format.
+ */
+export function parseSkillSpec(entry) {
+    const atIdx = entry.lastIndexOf("@");
+    if (atIdx <= 0)
+        return undefined;
+    const repo = entry.slice(0, atIdx);
+    const skill = entry.slice(atIdx + 1);
+    if (!repo.includes("/") || !skill)
+        return undefined;
+    return { repo, skill };
+}
+/**
+ * Extract just the skill name (directory name) from a fully-qualified entry.
+ */
+export function skillName(entry) {
+    const spec = parseSkillSpec(entry);
+    return spec ? spec.skill : entry;
+}
+// ── Shared skills directory ──────────────────────────────────────────────────
+/**
+ * Where installed skill folders live: `~/.openclaw/skills/<name>/`.
+ * The `skills` CLI creates a `skills/` subdirectory under its cwd,
+ * so we pass `resolveStateDir()` (~/.openclaw/) as the cwd.
+ */
+export function resolveSharedSkillsDir() {
+    return path.join(resolveStateDir(), "skills");
+}
+function resolveSkillDir(name) {
+    return path.join(resolveSharedSkillsDir(), name);
+}
+export function isSkillInstalled(name) {
+    const dir = resolveSkillDir(name);
+    if (!fs.existsSync(dir))
+        return false;
+    return fs.existsSync(path.join(dir, "SKILL.md"));
+}
+// ── Install / link ───────────────────────────────────────────────────────────
+/**
+ * Install one or more skills from a single repo via `skills add` into the
+ * shared directory. Accepts multiple skill names so only one clone is needed.
+ *
+ * Returns the list of skill names that were successfully installed.
+ */
+function installSkillsFromRepo(repo, skillNames) {
+    const skillFlag = skillNames.join(" ");
+    try {
+        const cmd = `node ${SKILLS_BIN} add ${repo} --skill ${skillFlag} --agent openclaw -y`;
+        execSync(cmd, { stdio: "inherit", cwd: resolveStateDir(), timeout: 300_000 });
+    }
+    catch {
+        console.error(`  Warning: failed to install skills from ${repo}: ${skillNames.join(", ")}`);
+    }
+    return skillNames.filter((s) => isSkillInstalled(s));
+}
+/**
+ * Install a single skill via `skills add` into the shared directory,
+ * then symlink it into the agent workspace.
+ *
+ * @param entry Fully-qualified skill string ("owner/repo@skill")
+ * @param workspaceDir Agent workspace directory
+ * Returns true on success, false on failure (logged, non-fatal).
+ */
+export function installSkill(entry, workspaceDir) {
+    const spec = parseSkillSpec(entry);
+    if (!spec) {
+        console.error(`  Warning: invalid skill spec "${entry}" — expected "owner/repo@skill"`);
+        return false;
+    }
+    if (!isSkillInstalled(spec.skill)) {
+        const ok = installSkillsFromRepo(spec.repo, [spec.skill]);
+        if (ok.length === 0)
+            return false;
+    }
+    if (!isSkillInstalled(spec.skill)) {
+        console.error(`  Warning: skill "${spec.skill}" not found after install`);
+        return false;
+    }
+    linkSkillToWorkspace(spec.skill, workspaceDir);
+    return true;
+}
+/**
+ * Create a symlink from the shared skill dir into the agent workspace.
+ */
+function linkSkillToWorkspace(name, workspaceDir) {
+    const target = resolveSkillDir(name);
+    const wsSkillsDir = path.join(workspaceDir, "skills");
+    fs.mkdirSync(wsSkillsDir, { recursive: true });
+    const link = path.join(wsSkillsDir, name);
+    if (fs.existsSync(link)) {
+        const stat = fs.lstatSync(link);
+        if (stat.isSymbolicLink()) {
+            const existing = fs.readlinkSync(link);
+            if (existing === target)
+                return;
+            fs.unlinkSync(link);
+        }
+        else {
+            fs.rmSync(link, { recursive: true, force: true });
+        }
+    }
+    fs.symlinkSync(target, link, "dir");
+}
+/**
+ * Install all skills for an agent: skip already-installed, batch-install
+ * missing skills grouped by repo (one clone per repo), then symlink
+ * everything into the workspace.
+ *
+ * @param skills Array of fully-qualified skill strings ("owner/repo@skill")
+ * Returns { installed, skipped, failed } counts.
+ */
+export function installAllSkills(skills, workspaceDir) {
+    fs.mkdirSync(resolveStateDir(), { recursive: true });
+    let installed = 0;
+    let skipped = 0;
+    let failed = 0;
+    // Group missing skills by repo so each repo is cloned only once
+    const needInstall = new Map();
+    for (const entry of skills) {
+        const spec = parseSkillSpec(entry);
+        if (!spec) {
+            console.error(`  Warning: invalid skill spec "${entry}" — expected "owner/repo@skill"`);
+            failed++;
+            continue;
+        }
+        if (isSkillInstalled(spec.skill)) {
+            linkSkillToWorkspace(spec.skill, workspaceDir);
+            skipped++;
+        }
+        else {
+            const list = needInstall.get(spec.repo) ?? [];
+            list.push(spec.skill);
+            needInstall.set(spec.repo, list);
+        }
+    }
+    // Batch install: one `skills add` per repo
+    for (const [repo, skillNames] of needInstall) {
+        const ok = installSkillsFromRepo(repo, skillNames);
+        installed += ok.length;
+        failed += skillNames.length - ok.length;
+        for (const name of ok) {
+            linkSkillToWorkspace(name, workspaceDir);
+        }
+    }
+    return { installed, skipped, failed };
+}
+/**
+ * Update all installed skills via `skills update`.
+ */
+export function updateAllSkills() {
+    try {
+        execSync(`node ${SKILLS_BIN} update --agent openclaw`, {
+            stdio: "inherit",
+            cwd: resolveStateDir(),
+        });
+        return true;
+    }
+    catch {
+        console.error("  Warning: failed to update skills");
+        return false;
+    }
+}
+/**
+ * Re-sync symlinks for an agent workspace.
+ * Ensures every skill in the list is linked; adds new links, preserves existing.
+ */
+export function syncSkillLinks(skills, workspaceDir) {
+    for (const entry of skills) {
+        const name = skillName(entry);
+        if (isSkillInstalled(name)) {
+            linkSkillToWorkspace(name, workspaceDir);
+        }
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@storyclaw/talenthub",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "CLI tool to manage StoryClaw AI agents",
   "type": "module",
   "bin": {
@@ -16,7 +16,8 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "commander": "^13.0.0"
+    "commander": "^13.0.0",
+    "skills": "^1.4.5"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",