@floomhq/floom 1.0.0 → 1.0.1

package/README.md

@@ -8,6 +8,7 @@ floom login
 floom publish my-skill.md
 floom add awesome-skill
 floom list
+floom library list
 ```
 
 Returns a shareable link like `https://floom.dev/s/ffas93ud`. Anyone with the URL can read the raw Markdown — drop it into any AI tool that accepts skills.
@@ -20,8 +21,13 @@ Returns a shareable link like `https://floom.dev/s/ffas93ud`. Anyone with the UR
 - `floom list` — show your published skills. Optional `--json`.
 - `floom add <url-or-slug>` — fetch a skill into `~/.claude/skills/<slug>.md`.
 - `floom info <url-or-slug>` — show skill metadata. Optional `--json`.
-- `floom sync` — preview: pull your own Floom-published skills into `~/.claude/skills/`.
+- `floom sync` — preview: pull your published, saved, and subscribed library skills into `~/.claude/skills/`.
 - `floom watch` — preview: run `floom sync` repeatedly. Optional `--interval <seconds>`; minimum `10`.
+- `floom library list` — list public starter libraries. Optional `--json`.
+- `floom library create <slug> --name <name>` — create a personal or starter library. Optional `--public` / `--private` / `--unlisted`.
+- `floom library add <library> <skill> [--folder <path>] [--tags a,b]` — add a skill to a library.
+- `floom library subscribe <slug>` — subscribe to a public or unlisted library so sync can pull it locally.
+- `floom move <slug> --folder <path>` — set your local folder override for a saved or library skill.
 - `floom delete <url-or-slug>` — delete one of your published skills. Optional `--yes`.
 - `floom doctor` — diagnose your Floom setup.
 - `floom whoami` — show the signed-in account.
@@ -46,7 +52,7 @@ version: 0.1.0
 
 Override the API host with `FLOOM_API_URL` (defaults to `https://floom.dev`).
 
-`floom sync` and `floom watch` are Version 1 preview commands for your own published skills. They store a machine-local manifest at `~/.floom/sync-manifest.json`.
+`floom sync` and `floom watch` are Version 1 preview commands for published, saved, and subscribed library skills. They store a machine-local manifest at `~/.floom/sync-manifest.json`.
 The manifest records hashes for files Floom previously wrote. Version 1 sync writes missing files
 only. Remote updates, existing untracked files, and locally edited tracked files are skipped as
 conflicts. Symlinks are never followed. To accept the Floom version, move or delete the local file

package/dist/cli.js

@@ -11,9 +11,10 @@ import { info } from "./info.js";
 import { deleteSkill } from "./delete.js";
 import { doctor } from "./doctor.js";
 import { sync } from "./sync.js";
+import { libraryAddSkill, libraryCreate, libraryList, libraryRemoveSkill, librarySubscribe, libraryUnsubscribe, moveSkill, } from "./library.js";
 import { c, symbols } from "./ui.js";
 import { printError, FloomError } from "./errors.js";
-const VERSION = "1.0.0";
+const VERSION = "1.0.1";
 const PKG = { name: "@floomhq/floom", version: VERSION };
 const V1_NOT_AVAILABLE = "Not available in Floom Version 1.";
 function usage() {
@@ -57,13 +58,15 @@ function usage() {
    ${c.dim("Account")}
      ${c.cyan("login")}                         Sign in with Google
      ${c.cyan("list")}                          List your published skills ${c.dim("[--json]")}
+     ${c.cyan("library")}                       Create, browse, and subscribe to skill libraries
+     ${c.cyan("move")} ${c.dim("<slug> --folder <path>")}  Place a saved skill in a local folder
      ${c.cyan("delete")} ${c.dim("<url-or-slug>")}          Delete one of your skills ${c.dim("[--yes]")}
      ${c.cyan("whoami")}                        Show the signed-in account
      ${c.cyan("logout")}                        Delete local credentials
 
    ${c.dim("System")}
-     ${c.cyan("sync")}                          Preview: pull your own published skills
-     ${c.cyan("watch")}                         Preview: poll your own published skills ${c.dim("[--interval <seconds>, min 10]")}
+     ${c.cyan("sync")}                          Preview: pull published, saved, and library skills
+     ${c.cyan("watch")}                         Preview: poll published, saved, and library skills ${c.dim("[--interval <seconds>, min 10]")}
      ${c.cyan("doctor")}                        Diagnose auth, API, and local setup
      ${c.cyan("--help")}                        Show this help
      ${c.cyan("--version")}                     Show version
@@ -177,6 +180,133 @@ function parseDeleteFlags(argv) {
     }
     return out;
 }
+function normalizeFolder(value) {
+    return value === "root" || value === "/" || value === "." ? null : value;
+}
+function parseFolderTagFlags(argv) {
+    const out = { tags: [], rest: [] };
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i] ?? "";
+        if (a === "--folder" || a.startsWith("--folder=")) {
+            const { value, nextIndex } = readFlagValue(argv, i, "--folder");
+            out.folder = normalizeFolder(value);
+            i = nextIndex;
+        }
+        else if (a === "--root") {
+            out.folder = null;
+        }
+        else if (a === "--tag" || a.startsWith("--tag=")) {
+            const { value, nextIndex } = readFlagValue(argv, i, "--tag");
+            out.tags.push(value);
+            i = nextIndex;
+        }
+        else if (a === "--tags" || a.startsWith("--tags=")) {
+            const { value, nextIndex } = readFlagValue(argv, i, "--tags");
+            out.tags.push(...value.split(",").map((tag) => tag.trim()).filter(Boolean));
+            i = nextIndex;
+        }
+        else if (a.startsWith("--")) {
+            throw new FloomError(`Unknown flag: ${a}`, "Use --folder <path>, --root, --tag <tag>, or --tags a,b.");
+        }
+        else {
+            out.rest.push(a);
+        }
+    }
+    return out;
+}
+function parseLibraryCreateFlags(argv) {
+    const out = { visibility: "unlisted" };
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i] ?? "";
+        if (a === "--name" || a.startsWith("--name=")) {
+            const { value, nextIndex } = readFlagValue(argv, i, "--name");
+            out.name = value;
+            i = nextIndex;
+        }
+        else if (a === "--description" || a.startsWith("--description=")) {
+            const { value, nextIndex } = readFlagValue(argv, i, "--description");
+            out.description = value;
+            i = nextIndex;
+        }
+        else if (a === "--public")
+            out.visibility = "public";
+        else if (a === "--private")
+            out.visibility = "private";
+        else if (a === "--unlisted")
+            out.visibility = "unlisted";
+        else if (a.startsWith("--")) {
+            throw new FloomError(`Unknown flag: ${a}`, "Try `floom library create team-onboarding --name \"Team onboarding\"`.");
+        }
+        else if (!out.slug)
+            out.slug = a;
+        else
+            throw new FloomError(`Unexpected argument: ${a}`, "Try `floom library create <slug> --name <name>`.");
+    }
+    return out;
+}
+async function runLibrary(argv) {
+    const [subcommand, ...rest] = argv;
+    switch (subcommand ?? "list") {
+        case "list": {
+            const flags = parseListFlags(rest);
+            await libraryList(flags);
+            return;
+        }
+        case "create": {
+            const flags = parseLibraryCreateFlags(rest);
+            if (!flags.slug)
+                throw new FloomError("Missing library slug.", "Try `floom library create team-onboarding --name \"Team onboarding\"`.");
+            if (!flags.name)
+                throw new FloomError("Missing --name.", "Try `floom library create team-onboarding --name \"Team onboarding\"`.");
+            await libraryCreate({
+                slug: flags.slug,
+                name: flags.name,
+                ...(flags.description !== undefined ? { description: flags.description } : {}),
+                visibility: flags.visibility,
+            });
+            return;
+        }
+        case "add": {
+            const flags = parseFolderTagFlags(rest);
+            const [librarySlug, skillSlug] = flags.rest;
+            if (!librarySlug || !skillSlug) {
+                throw new FloomError("Missing library or skill slug.", "Try `floom library add team-onboarding support-tone --folder support`.");
+            }
+            await libraryAddSkill({
+                librarySlug,
+                skillSlug,
+                ...(flags.folder !== undefined ? { folder: flags.folder } : {}),
+                tags: flags.tags,
+            });
+            return;
+        }
+        case "remove":
+        case "rm": {
+            const [librarySlug, skillSlug] = rest;
+            if (!librarySlug || !skillSlug) {
+                throw new FloomError("Missing library or skill slug.", "Try `floom library remove team-onboarding support-tone`.");
+            }
+            await libraryRemoveSkill(librarySlug, skillSlug);
+            return;
+        }
+        case "subscribe": {
+            const slug = rest[0];
+            if (!slug)
+                throw new FloomError("Missing library slug.", "Try `floom library subscribe superpowers`.");
+            await librarySubscribe(slug);
+            return;
+        }
+        case "unsubscribe": {
+            const slug = rest[0];
+            if (!slug)
+                throw new FloomError("Missing library slug.", "Try `floom library unsubscribe superpowers`.");
+            await libraryUnsubscribe(slug);
+            return;
+        }
+        default:
+            throw new FloomError(`Unknown library command: ${subcommand}`, "Use: list, create, add, remove, subscribe, unsubscribe.");
+    }
+}
 function parseWatchFlags(argv) {
     const out = { intervalSeconds: 60 };
     for (let i = 0; i < argv.length; i++) {
@@ -335,9 +465,20 @@ async function main() {
             }
             case "library":
             case "lib":
-                notAvailable("`floom library`");
-            case "move":
-                notAvailable("`floom move`");
+                await runLibrary(rest);
+                return;
+            case "move": {
+                const flags = parseFolderTagFlags(rest);
+                const slug = flags.rest[0];
+                if (!slug) {
+                    throw new FloomError("Missing skill slug.", "Try `floom move support-tone --folder support/tone`.");
+                }
+                if (flags.folder === undefined) {
+                    throw new FloomError("Missing --folder.", "Use --folder <path> or --root. Add --tag or --tags when useful.");
+                }
+                await moveSkill({ slug, folder: flags.folder, tags: flags.tags });
+                return;
+            }
             case "mcp":
                 notAvailable("`floom mcp setup`");
             case "doctor":

package/dist/doctor.js

@@ -3,7 +3,7 @@ import { join } from "node:path";
 import { stat, readFile, access, readdir, constants } from "node:fs/promises";
 import { getApiUrl, readConfig, CONFIG_PATH } from "./config.js";
 import { c, symbols } from "./ui.js";
-const CLI_VERSION = "1.0.0";
+const CLI_VERSION = "1.0.1";
 function statusBadge(s) {
     if (s === "ok")
         return c.green(symbols.ok);

package/dist/info.js

@@ -1,6 +1,7 @@
 import ora from "ora";
 import { getApiUrl, readConfig } from "./config.js";
 import { getJson } from "./lib/api.js";
+import { extractRequires, formatToolList, formatType } from "./lib/skill-labels.js";
 import { c, symbols } from "./ui.js";
 import { FloomError } from "./errors.js";
 function slugFromInput(input) {
@@ -29,9 +30,12 @@ export async function info(opts) {
         spinner?.stop();
     }
     if (opts.json) {
-        // Strip body_md from JSON output to keep it summary-shaped.
+        // Strip body_md from JSON output to keep it summary-shaped, but expose
+        // the parsed `requires` list so scripted consumers don't need to parse
+        // YAML themselves.
         const { body_md: _body, ...summary } = detail;
-        process.stdout.write(`${JSON.stringify(summary, null, 2)}\n`);
+        const requires = extractRequires(detail.body_md);
+        process.stdout.write(`${JSON.stringify({ ...summary, requires }, null, 2)}\n`);
         return;
     }
     const title = detail.title ?? c.dim("(untitled)");
@@ -41,7 +45,11 @@ export async function info(opts) {
         process.stdout.write(`   ${c.dim("About:      ")}${detail.description}\n`);
     }
     process.stdout.write(`   ${c.dim("Visibility: ")}${detail.visibility}\n`);
-    process.stdout.write(`   ${c.dim("Type:       ")}${detail.asset_type ?? "skill"}\n`);
+    process.stdout.write(`   ${c.dim("Type:       ")}${formatType(detail.asset_type)}\n`);
+    const requires = extractRequires(detail.body_md);
+    if (requires.length > 0) {
+        process.stdout.write(`   ${c.dim("Needs:      ")}${formatToolList(requires)}\n`);
+    }
     if (detail.version) {
         process.stdout.write(`   ${c.dim("Version:    ")}${detail.version}\n`);
     }

package/dist/lib/skill-labels.js

@@ -0,0 +1,140 @@
+/**
+ * CLI-side mirror of the web's skill-labels: type label + tool label + a tiny
+ * frontmatter parser for `requires:`. No React, no `gray-matter` — keep the
+ * CLI dep tree thin.
+ *
+ * The frontmatter parser intentionally only supports two `requires` shapes:
+ *   requires: [gmail, linear]
+ *   requires:
+ *     - gmail
+ *     - linear
+ *
+ * That covers >99% of real skills. If a skill uses a more exotic YAML shape
+ * we silently get an empty list — not a crash.
+ */
+const SKILL_TYPE_LABELS = {
+    knowledge: "Knowledge",
+    instruction: "Instruction",
+    workflow: "Workflow",
+    skill: "Skill",
+};
+const TOOL_LABELS = {
+    gmail: "Gmail",
+    "google-mail": "Gmail",
+    calendar: "Google Calendar",
+    "google-calendar": "Google Calendar",
+    drive: "Google Drive",
+    "google-drive": "Google Drive",
+    docs: "Google Docs",
+    "google-docs": "Google Docs",
+    sheets: "Google Sheets",
+    "google-sheets": "Google Sheets",
+    github: "GitHub",
+    gitlab: "GitLab",
+    linear: "Linear",
+    notion: "Notion",
+    slack: "Slack",
+    intercom: "Intercom",
+    zendesk: "Zendesk",
+    hubspot: "HubSpot",
+    salesforce: "Salesforce",
+    stripe: "Stripe",
+    airtable: "Airtable",
+    jira: "Jira",
+    asana: "Asana",
+    trello: "Trello",
+    zapier: "Zapier",
+    composio: "Composio",
+    whatsapp: "WhatsApp",
+    telegram: "Telegram",
+    discord: "Discord",
+    twitter: "Twitter",
+    x: "X",
+    linkedin: "LinkedIn",
+    openai: "OpenAI",
+    anthropic: "Anthropic",
+    gemini: "Gemini",
+    claude: "Claude",
+    perplexity: "Perplexity",
+    supabase: "Supabase",
+    vercel: "Vercel",
+    resend: "Resend",
+    twilio: "Twilio",
+    webhook: "Webhook",
+    http: "HTTP",
+};
+export function formatType(value) {
+    if (!value)
+        return "Skill";
+    const normalized = value.toLowerCase();
+    return SKILL_TYPE_LABELS[normalized] ?? "Skill";
+}
+export function formatTool(slug) {
+    const normalized = slug.trim().toLowerCase();
+    if (!normalized)
+        return slug;
+    if (TOOL_LABELS[normalized])
+        return TOOL_LABELS[normalized];
+    return normalized
+        .split(/[-_\s]+/)
+        .filter(Boolean)
+        .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
+        .join(" ");
+}
+export function formatToolList(tools) {
+    return tools.map(formatTool).join(", ");
+}
+/**
+ * Pull `requires:` out of YAML frontmatter. Returns a deduped lowercase list
+ * or [] if absent / malformed.
+ */
+export function extractRequires(body) {
+    if (!body)
+        return [];
+    const trimmed = body.replace(/^/, "");
+    if (!trimmed.startsWith("---"))
+        return [];
+    const end = trimmed.indexOf("\n---", 3);
+    if (end === -1)
+        return [];
+    const headerBlock = trimmed.slice(3, end);
+    const lines = headerBlock.split(/\r?\n/);
+    const seen = new Set();
+    const out = [];
+    for (let i = 0; i < lines.length; i++) {
+        const raw = lines[i] ?? "";
+        const line = raw.trim();
+        const inlineMatch = /^requires\s*:\s*\[(.*?)\]\s*$/i.exec(line);
+        if (inlineMatch) {
+            const inner = inlineMatch[1] ?? "";
+            for (const part of inner.split(",")) {
+                const value = part.trim().replace(/^['"]|['"]$/g, "").toLowerCase();
+                if (value && !seen.has(value)) {
+                    seen.add(value);
+                    out.push(value);
+                }
+            }
+            return out;
+        }
+        if (/^requires\s*:\s*$/i.test(line)) {
+            // Block form. Scan subsequent indented `- foo` lines until indent breaks.
+            for (let j = i + 1; j < lines.length; j++) {
+                const next = lines[j] ?? "";
+                const itemMatch = /^\s+-\s+(.+?)\s*$/.exec(next);
+                if (!itemMatch) {
+                    // First non-list line ends the block.
+                    if (next.trim() === "")
+                        continue;
+                    break;
+                }
+                const value = (itemMatch[1] ?? "").replace(/^['"]|['"]$/g, "").trim().toLowerCase();
+                if (value && !seen.has(value)) {
+                    seen.add(value);
+                    out.push(value);
+                }
+            }
+            return out;
+        }
+    }
+    return out;
+}

package/dist/library.js

@@ -44,7 +44,32 @@ export async function libraryCreate(opts) {
         ...(opts.visibility ? { visibility: opts.visibility } : {}),
     });
     process.stdout.write(`\n${symbols.ok}  Library created: ${c.cyan(result.slug)}\n`);
-    process.stdout.write(`   ${c.dim("View:")} ${apiUrl}/library/${result.slug}\n\n`);
+    process.stdout.write(`   ${c.dim("API:")}  ${apiUrl}/api/v1/libraries/${result.slug}\n`);
+    process.stdout.write(`   ${c.dim("Sync:")} floom library subscribe ${result.slug}\n\n`);
+}
+export async function libraryAddSkill(opts) {
+    const cfg = await readConfig();
+    if (!cfg)
+        throw new FloomError("Not signed in.", "Run `floom login` first.");
+    const apiUrl = cfg.apiUrl ?? getApiUrl();
+    await postJson(`${apiUrl}/api/v1/libraries/${encodeURIComponent(opts.librarySlug)}/skills`, "add skill to library", cfg.accessToken, {
+        skill_slug: opts.skillSlug,
+        ...(opts.folder !== undefined ? { folder: opts.folder } : {}),
+        ...(opts.tags ? { tags: opts.tags } : {}),
+    });
+    const folderText = opts.folder ?? c.dim("(root)");
+    const tagsText = opts.tags?.length ? opts.tags.join(", ") : c.dim("(none)");
+    process.stdout.write(`\n${symbols.ok}  Added ${c.cyan(opts.skillSlug)} to ${c.cyan(opts.librarySlug)}\n`);
+    process.stdout.write(`   ${c.dim("folder:")} ${folderText}\n`);
+    process.stdout.write(`   ${c.dim("tags:")}   ${tagsText}\n\n`);
+}
+export async function libraryRemoveSkill(librarySlug, skillSlug) {
+    const cfg = await readConfig();
+    if (!cfg)
+        throw new FloomError("Not signed in.", "Run `floom login` first.");
+    const apiUrl = cfg.apiUrl ?? getApiUrl();
+    await deleteRequest(`${apiUrl}/api/v1/libraries/${encodeURIComponent(librarySlug)}/skills/${encodeURIComponent(skillSlug)}`, "remove skill from library", cfg.accessToken);
+    process.stdout.write(`\n${symbols.ok}  Removed ${c.cyan(skillSlug)} from ${c.cyan(librarySlug)}\n\n`);
 }
 export async function librarySubscribe(slug) {
     const cfg = await readConfig();

package/dist/list.js

@@ -1,15 +1,18 @@
 import ora from "ora";
 import { getApiUrl, readConfig } from "./config.js";
 import { getJson } from "./lib/api.js";
+import { extractRequires, formatToolList, formatType } from "./lib/skill-labels.js";
 import { c, symbols } from "./ui.js";
 import { FloomError } from "./errors.js";
 function formatRow(s) {
     const title = s.title ?? c.dim("(untitled)");
     const visibility = c.dim(`[${s.visibility}]`);
-    const type = c.dim(`[${s.asset_type ?? "skill"}]`);
+    const type = c.dim(`[${formatType(s.asset_type)}]`);
     const version = s.version ? c.dim(`v${s.version}`) : "";
     const updated = c.dim(formatRelative(s.updated_at));
-    return `   ${c.cyan(s.slug.padEnd(14))}  ${title}  ${type}  ${visibility}  ${version}  ${updated}`;
+    const requires = extractRequires(s.body_md);
+    const needs = requires.length > 0 ? c.dim(`needs ${formatToolList(requires)}`) : "";
+    return `   ${c.cyan(s.slug.padEnd(14))}  ${title}  ${type}  ${visibility}  ${version}  ${updated}${needs ? `  ${needs}` : ""}`;
 }
 function formatRelative(iso) {
     const diff = Date.now() - new Date(iso).getTime();

package/dist/sync.js

@@ -223,7 +223,7 @@ export async function sync(opts = {}) {
     }
     for (const skill of payload.skills)
         validateSyncSkillShape(skill);
-    // Version 1 preview syncs owned published skills only.
+    // Version 1 preview syncs published, saved, and subscribed library skills.
     const all = payload.skills;
     const seen = new Set();
     let unchanged = 0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@floomhq/floom",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Publish AI skills from your terminal. Share with a link.",
   "license": "MIT",
   "type": "module",