@hasna/skills 0.0.3 → 0.1.1

package/src/cli/cli.test.ts

@@ -1,325 +0,0 @@
-import { describe, test, expect } from "bun:test";
-import { join } from "path";
-
-const CLI_PATH = join(import.meta.dir, "index.tsx");
-
-async function runCli(args: string[]): Promise<{ stdout: string; stderr: string; exitCode: number }> {
-  const proc = Bun.spawn(["bun", "run", CLI_PATH, "--", ...args], {
-    stdout: "pipe",
-    stderr: "pipe",
-    env: { ...process.env, NO_COLOR: "1" },
-  });
-  const stdout = await new Response(proc.stdout).text();
-  const stderr = await new Response(proc.stderr).text();
-  const exitCode = await proc.exited;
-  return { stdout, stderr, exitCode };
-}
-
-describe("CLI", () => {
-  describe("help", () => {
-    test("shows help with no arguments", async () => {
-      const { stdout } = await runCli([]);
-      expect(stdout).toContain("Install AI agent skills");
-      expect(stdout).toContain("install|add");
-      expect(stdout).toContain("list|ls");
-      expect(stdout).toContain("search");
-      expect(stdout).toContain("info");
-      expect(stdout).toContain("remove|rm");
-      expect(stdout).toContain("categories");
-    });
-
-    test("shows help with --help", async () => {
-      const { stdout } = await runCli(["--help"]);
-      expect(stdout).toContain("Install AI agent skills");
-    });
-
-    test("shows version with --version", async () => {
-      const { stdout } = await runCli(["--version"]);
-      expect(stdout.trim()).toBe("0.0.3");
-    });
-  });
-
-  describe("categories", () => {
-    test("lists categories", async () => {
-      const { stdout } = await runCli(["categories"]);
-      expect(stdout).toContain("Development Tools");
-      expect(stdout).toContain("Business & Marketing");
-      expect(stdout).toContain("Health & Wellness");
-    });
-
-    test("outputs JSON with --json", async () => {
-      const { stdout } = await runCli(["categories", "--json"]);
-      const data = JSON.parse(stdout);
-      expect(Array.isArray(data)).toBe(true);
-      expect(data.length).toBe(17);
-      expect(data[0]).toHaveProperty("name");
-      expect(data[0]).toHaveProperty("count");
-    });
-  });
-
-  describe("list", () => {
-    test("lists all skills", async () => {
-      const { stdout } = await runCli(["list"]);
-      expect(stdout).toContain("Available skills (200)");
-      expect(stdout).toContain("Development Tools");
-    });
-
-    test("lists by category", async () => {
-      const { stdout } = await runCli(["list", "--category", "Health & Wellness"]);
-      expect(stdout).toContain("Health & Wellness (8)");
-      expect(stdout).toContain("workout-cycle-planner");
-    });
-
-    test("fails for invalid category", async () => {
-      const { stderr, exitCode } = await runCli(["list", "--category", "Fake Category"]);
-      expect(stderr).toContain("Unknown category");
-      expect(exitCode).not.toBe(0);
-    });
-
-    test("outputs JSON with --json", async () => {
-      const { stdout } = await runCli(["list", "--json"]);
-      const data = JSON.parse(stdout);
-      expect(Array.isArray(data)).toBe(true);
-      expect(data.length).toBe(200);
-    });
-
-    test("lists by category with --json", async () => {
-      const { stdout } = await runCli(["list", "--category", "Event Management", "--json"]);
-      const data = JSON.parse(stdout);
-      expect(Array.isArray(data)).toBe(true);
-      expect(data.length).toBe(4);
-      for (const skill of data) {
-        expect(skill.category).toBe("Event Management");
-      }
-    });
-  });
-
-  describe("search", () => {
-    test("finds skills", async () => {
-      const { stdout } = await runCli(["search", "email"]);
-      expect(stdout).toContain("Found");
-      expect(stdout).toContain("skill(s)");
-    });
-
-    test("shows message for no results", async () => {
-      const { stdout } = await runCli(["search", "zzzznonexistentzzzzz"]);
-      expect(stdout).toContain("No skills found");
-    });
-
-    test("outputs JSON with --json", async () => {
-      const { stdout } = await runCli(["search", "pdf", "--json"]);
-      const data = JSON.parse(stdout);
-      expect(Array.isArray(data)).toBe(true);
-      expect(data.length).toBeGreaterThan(0);
-      expect(data[0]).toHaveProperty("name");
-    });
-
-    test("JSON output is empty array for no results", async () => {
-      const { stdout } = await runCli(["search", "zzzznonexistentzzzzz", "--json"]);
-      const data = JSON.parse(stdout);
-      expect(data).toEqual([]);
-    });
-  });
-
-  describe("info", () => {
-    test("shows skill info", async () => {
-      const { stdout } = await runCli(["info", "deepresearch"]);
-      expect(stdout).toContain("Deep Research (Agentic)");
-      expect(stdout).toContain("Research & Writing");
-    });
-
-    test("fails for nonexistent skill", async () => {
-      const { stderr, exitCode } = await runCli(["info", "nonexistent-xyz"]);
-      expect(stderr).toContain("not found");
-      expect(exitCode).not.toBe(0);
-    });
-
-    test("outputs JSON with --json", async () => {
-      const { stdout } = await runCli(["info", "deepresearch", "--json"]);
-      const data = JSON.parse(stdout);
-      expect(data.name).toBe("deepresearch");
-      expect(data.displayName).toBe("Deep Research (Agentic)");
-      expect(data.category).toBe("Research & Writing");
-      expect(Array.isArray(data.tags)).toBe(true);
-    });
-  });
-
-  describe("docs", () => {
-    test("shows documentation for a skill with SKILL.md", async () => {
-      const { stdout } = await runCli(["docs", "image"]);
-      expect(stdout).toContain("Image Generation");
-    });
-
-    test("shows CLAUDE.md when no SKILL.md", async () => {
-      const { stdout } = await runCli(["docs", "deepresearch"]);
-      expect(stdout).toContain("deepresearch");
-    });
-
-    test("fails for nonexistent skill", async () => {
-      const { stderr, exitCode } = await runCli(["docs", "nonexistent-xyz"]);
-      expect(stderr).toContain("not found");
-      expect(exitCode).not.toBe(0);
-    });
-
-    test("outputs JSON with --json", async () => {
-      const { stdout } = await runCli(["docs", "image", "--json"]);
-      const data = JSON.parse(stdout);
-      expect(data.skill).toBe("image");
-      expect(data.hasSkillMd).toBe(true);
-      expect(data.content).toBeTruthy();
-    });
-
-    test("shows specific file with --file", async () => {
-      const { stdout } = await runCli(["docs", "image", "--file", "skill"]);
-      expect(stdout).toContain("Image Generation");
-    });
-
-    test("shows claude file with --file claude", async () => {
-      const { stdout } = await runCli(["docs", "deepresearch", "--file", "claude"]);
-      expect(stdout).toContain("deepresearch");
-    });
-  });
-
-  describe("requires", () => {
-    test("shows requirements for a skill", async () => {
-      const { stdout } = await runCli(["requires", "image"]);
-      expect(stdout).toContain("Requirements for image");
-      expect(stdout).toContain("OPENAI_API_KEY");
-    });
-
-    test("shows CLI command", async () => {
-      const { stdout } = await runCli(["requires", "image"]);
-      expect(stdout).toContain("skill-image");
-    });
-
-    test("fails for nonexistent skill", async () => {
-      const { stderr, exitCode } = await runCli(["requires", "nonexistent-xyz"]);
-      expect(stderr).toContain("not found");
-      expect(exitCode).not.toBe(0);
-    });
-
-    test("outputs JSON with --json", async () => {
-      const { stdout } = await runCli(["requires", "image", "--json"]);
-      const data = JSON.parse(stdout);
-      expect(Array.isArray(data.envVars)).toBe(true);
-      expect(data.envVars).toContain("OPENAI_API_KEY");
-      expect(data.cliCommand).toBe("skill-image");
-      expect(data).toHaveProperty("systemDeps");
-      expect(data).toHaveProperty("dependencies");
-    });
-
-    test("shows npm dependencies", async () => {
-      const { stdout } = await runCli(["requires", "deepresearch"]);
-      expect(stdout).toContain("npm dependencies");
-      expect(stdout).toContain("commander");
-    });
-  });
-
-  describe("info (enriched)", () => {
-    test("JSON includes envVars and cliCommand", async () => {
-      const { stdout } = await runCli(["info", "image", "--json"]);
-      const data = JSON.parse(stdout);
-      expect(data.name).toBe("image");
-      expect(data.envVars).toContain("OPENAI_API_KEY");
-      expect(data.cliCommand).toBe("skill-image");
-    });
-
-    test("human-readable shows env vars", async () => {
-      const { stdout } = await runCli(["info", "image"]);
-      expect(stdout).toContain("Env vars:");
-      expect(stdout).toContain("OPENAI_API_KEY");
-    });
-  });
-
-  describe("run", () => {
-    test("fails for nonexistent skill", async () => {
-      const { stderr, exitCode } = await runCli(["run", "nonexistent-xyz"]);
-      expect(stderr).toContain("not found");
-      expect(exitCode).not.toBe(0);
-    });
-  });
-
-  describe("install", () => {
-    test("requires at least one skill argument", async () => {
-      const { stderr, exitCode } = await runCli(["install"]);
-      expect(exitCode).not.toBe(0);
-    });
-
-    test("fails for nonexistent skill", async () => {
-      const { stdout, exitCode } = await runCli(["install", "nonexistent-xyz-123"]);
-      expect(stdout).toContain("not found");
-      expect(exitCode).not.toBe(0);
-    });
-
-    test("JSON output for failed install", async () => {
-      const { stdout } = await runCli(["install", "nonexistent-xyz-123", "--json"]);
-      const data = JSON.parse(stdout);
-      expect(Array.isArray(data)).toBe(true);
-      expect(data[0].success).toBe(false);
-      expect(data[0].error).toContain("not found");
-    });
-  });
-
-  describe("remove", () => {
-    test("fails for non-installed skill", async () => {
-      const { stdout, exitCode } = await runCli(["remove", "nonexistent-xyz-123"]);
-      expect(stdout).toContain("not installed");
-      expect(exitCode).not.toBe(0);
-    });
-
-    test("JSON output for failed remove", async () => {
-      const { stdout } = await runCli(["remove", "nonexistent-xyz-123", "--json"]);
-      const data = JSON.parse(stdout);
-      expect(data.removed).toBe(false);
-    });
-  });
-
-  describe("install --for", () => {
-    test("shows help with --for flag", async () => {
-      const { stdout } = await runCli(["install", "--help"]);
-      expect(stdout).toContain("--for");
-      expect(stdout).toContain("--scope");
-    });
-
-    test("fails for nonexistent skill with --for", async () => {
-      const { stdout, exitCode } = await runCli(["install", "nonexistent-xyz-123", "--for", "claude", "--scope", "project"]);
-      expect(stdout).toContain("not found");
-      expect(exitCode).not.toBe(0);
-    });
-
-    test("JSON output for --for install", async () => {
-      const { stdout, exitCode } = await runCli(["install", "nonexistent-xyz-123", "--for", "claude", "--scope", "project", "--json"]);
-      const data = JSON.parse(stdout);
-      expect(Array.isArray(data)).toBe(true);
-      expect(data[0].success).toBe(false);
-    });
-
-    test("rejects invalid agent name", async () => {
-      const { stderr, exitCode } = await runCli(["install", "image", "--for", "invalid-agent"]);
-      expect(stderr).toContain("Unknown agent");
-      expect(exitCode).not.toBe(0);
-    });
-  });
-
-  describe("remove --for", () => {
-    test("shows help with --for flag", async () => {
-      const { stdout } = await runCli(["remove", "--help"]);
-      expect(stdout).toContain("--for");
-      expect(stdout).toContain("--scope");
-    });
-
-    test("fails for non-installed skill with --for", async () => {
-      const { stdout, exitCode } = await runCli(["remove", "nonexistent-xyz-123", "--for", "claude", "--scope", "project"]);
-      expect(stdout).toContain("not found");
-      expect(exitCode).not.toBe(0);
-    });
-  });
-
-  describe("mcp", () => {
-    test("shows help for mcp command", async () => {
-      const { stdout } = await runCli(["mcp", "--help"]);
-      expect(stdout).toContain("MCP server");
-      expect(stdout).toContain("--register");
-    });
-  });
-});

package/src/cli/components/App.tsx

@@ -1,186 +0,0 @@
-import React, { useState } from "react";
-import { Box, Text, useApp, useInput } from "ink";
-import SelectInput from "ink-select-input";
-import { Header } from "./Header.js";
-import { CategorySelect } from "./CategorySelect.js";
-import { SkillSelect } from "./SkillSelect.js";
-import { SearchView } from "./SearchView.js";
-import { InstallProgress } from "./InstallProgress.js";
-import {
-  getSkillsByCategory,
-  SkillMeta,
-  Category,
-} from "../../lib/registry.js";
-import { InstallResult } from "../../lib/installer.js";
-
-type View = "main" | "browse" | "search" | "skills" | "installing" | "done";
-
-interface AppProps {
-  initialSkills?: string[];
-  overwrite?: boolean;
-}
-
-export function App({ initialSkills, overwrite = false }: AppProps) {
-  const { exit } = useApp();
-  const [view, setView] = useState<View>(
-    initialSkills?.length ? "installing" : "main"
-  );
-  const [category, setCategory] = useState<Category | null>(null);
-  const [selected, setSelected] = useState<Set<string>>(
-    new Set(initialSkills || [])
-  );
-  const [results, setResults] = useState<InstallResult[]>([]);
-
-  useInput((input, key) => {
-    if (key.escape) {
-      if (view === "main") {
-        exit();
-      }
-    }
-    if (input === "q") {
-      exit();
-    }
-  });
-
-  const handleToggle = (name: string) => {
-    const newSelected = new Set(selected);
-    if (newSelected.has(name)) {
-      newSelected.delete(name);
-    } else {
-      newSelected.add(name);
-    }
-    setSelected(newSelected);
-  };
-
-  const handleConfirm = () => {
-    if (selected.size > 0) {
-      setView("installing");
-    }
-  };
-
-  const handleComplete = (installResults: InstallResult[]) => {
-    setResults(installResults);
-    setView("done");
-  };
-
-  const mainMenuItems = [
-    { label: "Browse by category", value: "browse" },
-    { label: "Search skills", value: "search" },
-    { label: "Exit", value: "exit" },
-  ];
-
-  const handleMainSelect = (item: { value: string }) => {
-    if (item.value === "exit") {
-      exit();
-    } else {
-      setView(item.value as View);
-    }
-  };
-
-  return (
-    <Box flexDirection="column" padding={1}>
-      <Header
-        title="Skills"
-        subtitle="Install AI agent skills for your project"
-      />
-
-      {view === "main" && (
-        <Box flexDirection="column">
-          <Text marginBottom={1}>What would you like to do?</Text>
-          <SelectInput items={mainMenuItems} onSelect={handleMainSelect} />
-          <Box marginTop={1}>
-            <Text dimColor>Press q to quit</Text>
-          </Box>
-        </Box>
-      )}
-
-      {view === "browse" && !category && (
-        <CategorySelect
-          onSelect={(cat) => {
-            setCategory(cat as Category);
-            setView("skills");
-          }}
-          onBack={() => setView("main")}
-        />
-      )}
-
-      {view === "skills" && category && (
-        <SkillSelect
-          skills={getSkillsByCategory(category)}
-          selected={selected}
-          onToggle={handleToggle}
-          onConfirm={handleConfirm}
-          onBack={() => {
-            setCategory(null);
-            setView("browse");
-          }}
-        />
-      )}
-
-      {view === "search" && (
-        <SearchView
-          selected={selected}
-          onToggle={handleToggle}
-          onConfirm={handleConfirm}
-          onBack={() => setView("main")}
-        />
-      )}
-
-      {view === "installing" && (
-        <InstallProgress
-          skills={Array.from(selected)}
-          overwrite={overwrite}
-          onComplete={handleComplete}
-        />
-      )}
-
-      {view === "done" && (
-        <Box flexDirection="column">
-          <Text bold color="green" marginBottom={1}>
-            Installation complete!
-          </Text>
-
-          {results.filter((r) => r.success).length > 0 && (
-            <Box flexDirection="column" marginBottom={1}>
-              <Text bold>Installed:</Text>
-              {results
-                .filter((r) => r.success)
-                .map((r) => (
-                  <Text key={r.skill} color="green">
-                    {"\u2713"} {r.skill}
-                  </Text>
-                ))}
-            </Box>
-          )}
-
-          {results.filter((r) => !r.success).length > 0 && (
-            <Box flexDirection="column" marginBottom={1}>
-              <Text bold color="red">
-                Failed:
-              </Text>
-              {results
-                .filter((r) => !r.success)
-                .map((r) => (
-                  <Text key={r.skill} color="red">
-                    {"\u2717"} {r.skill}: {r.error}
-                  </Text>
-                ))}
-            </Box>
-          )}
-
-          <Box marginTop={1} flexDirection="column">
-            <Text bold>Next steps:</Text>
-            <Text>1. Import from .skills/</Text>
-            <Text dimColor>   import {"{"} generate_image {"}"} from './.skills'</Text>
-            <Text>2. Configure your API keys</Text>
-            <Text>3. Start building!</Text>
-          </Box>
-
-          <Box marginTop={1}>
-            <Text dimColor>Press q to exit</Text>
-          </Box>
-        </Box>
-      )}
-    </Box>
-  );
-}

package/src/cli/components/CategorySelect.tsx

@@ -1,38 +0,0 @@
-import React from "react";
-import { Box, Text } from "ink";
-import SelectInput from "ink-select-input";
-import { CATEGORIES, getSkillsByCategory } from "../../lib/registry.js";
-
-interface CategorySelectProps {
-  onSelect: (category: string) => void;
-  onBack?: () => void;
-}
-
-export function CategorySelect({ onSelect, onBack }: CategorySelectProps) {
-  const items = CATEGORIES.map((cat) => ({
-    label: `${cat} (${getSkillsByCategory(cat).length})`,
-    value: cat,
-  }));
-
-  // Add back option if onBack provided
-  if (onBack) {
-    items.unshift({ label: "\u2190 Back", value: "__back__" });
-  }
-
-  const handleSelect = (item: { value: string }) => {
-    if (item.value === "__back__" && onBack) {
-      onBack();
-    } else {
-      onSelect(item.value);
-    }
-  };
-
-  return (
-    <Box flexDirection="column">
-      <Text bold marginBottom={1}>
-        Select a category:
-      </Text>
-      <SelectInput items={items} onSelect={handleSelect} />
-    </Box>
-  );
-}

package/src/cli/components/Header.tsx

@@ -1,18 +0,0 @@
-import React from "react";
-import { Box, Text } from "ink";
-
-interface HeaderProps {
-  title?: string;
-  subtitle?: string;
-}
-
-export function Header({ title = "Skills", subtitle }: HeaderProps) {
-  return (
-    <Box flexDirection="column" marginBottom={1}>
-      <Text bold color="cyan">
-        {title}
-      </Text>
-      {subtitle && <Text dimColor>{subtitle}</Text>}
-    </Box>
-  );
-}

package/src/cli/components/InstallProgress.tsx

@@ -1,97 +0,0 @@
-import React, { useState, useEffect } from "react";
-import { Box, Text } from "ink";
-import Spinner from "ink-spinner";
-import { installSkill, InstallResult } from "../../lib/installer.js";
-
-interface InstallProgressProps {
-  skills: string[];
-  overwrite?: boolean;
-  onComplete: (results: InstallResult[]) => void;
-}
-
-export function InstallProgress({
-  skills,
-  overwrite = false,
-  onComplete,
-}: InstallProgressProps) {
-  const [results, setResults] = useState<InstallResult[]>([]);
-  const [current, setCurrent] = useState(0);
-  const [installing, setInstalling] = useState(true);
-
-  useEffect(() => {
-    const install = async () => {
-      const newResults: InstallResult[] = [];
-
-      for (let i = 0; i < skills.length; i++) {
-        setCurrent(i);
-        // Small delay for visual feedback
-        await new Promise((r) => setTimeout(r, 100));
-
-        const result = installSkill(skills[i], { overwrite });
-        newResults.push(result);
-        setResults([...newResults]);
-      }
-
-      setInstalling(false);
-      onComplete(newResults);
-    };
-
-    install();
-  }, [skills, overwrite]);
-
-  return (
-    <Box flexDirection="column">
-      <Box marginBottom={1}>
-        <Text bold>
-          {installing
-            ? `Installing skills (${current + 1}/${skills.length})...`
-            : "Installation complete!"}
-        </Text>
-      </Box>
-
-      {skills.map((name, i) => {
-        const result = results[i];
-        const isCurrent = i === current && installing;
-
-        return (
-          <Box key={name}>
-            {isCurrent && !result && (
-              <Text color="cyan">
-                <Spinner type="dots" /> {name}
-              </Text>
-            )}
-            {result?.success && (
-              <Text color="green">{"\u2713"} {name}</Text>
-            )}
-            {result && !result.success && (
-              <Text color="red">
-                {"\u2717"} {name} - {result.error}
-              </Text>
-            )}
-            {!isCurrent && !result && (
-              <Text dimColor>{"\u25CB"} {name}</Text>
-            )}
-          </Box>
-        );
-      })}
-
-      {!installing && (
-        <Box marginTop={1} flexDirection="column">
-          <Text>
-            <Text color="green">
-              {results.filter((r) => r.success).length} installed
-            </Text>
-            {results.some((r) => !r.success) && (
-              <Text color="red">
-                , {results.filter((r) => !r.success).length} failed
-              </Text>
-            )}
-          </Text>
-          <Text dimColor>
-            Skills installed to .skills/
-          </Text>
-        </Box>
-      )}
-    </Box>
-  );
-}