@hasna/skills 0.1.12 → 0.1.14

package/skills/skill-domainsearch/SKILL.md

@@ -0,0 +1,41 @@
+---
+name: Domain Search
+description: Search domain availability and suggestions via GoDaddy API
+---
+
+# Domain Search
+
+Search domain availability and get suggestions via the GoDaddy API. Provides both a CLI tool and an HTTP server for domain search workflows.
+
+## Features
+
+- Check domain name availability
+- Get domain suggestions based on keywords
+- HTTP server mode for API-driven searches
+- Configurable API endpoint and credentials
+
+## Usage
+
+```bash
+# Run the CLI
+skill-domainsearch
+
+# Start the HTTP server
+bun run start
+
+# Development mode with watch
+bun run dev
+```
+
+## Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `DOMAIN_API_KEY` | GoDaddy API key |
+| `DOMAIN_API_SECRET` | GoDaddy API secret |
+| `DOMAIN_CUSTOMER_ID` | GoDaddy customer ID |
+| `DOMAIN_API_URL` | API base URL (default: `https://api.godaddy.com`) |
+
+## Configuration
+
+Config is stored at `~/.config/service-domainsearch/config.json`. Environment variables take priority over the config file.

package/skills/skill-domainsearch/bin/cli.ts

@@ -0,0 +1,410 @@
+#!/usr/bin/env bun
+
+import { Command } from "commander";
+import {
+  loadConfig,
+  saveConfig,
+  CONFIG_FILE,
+  getApiKey,
+  getApiSecret,
+  getCustomerId,
+} from "../src/lib/config";
+import { domainApi, formatPrice } from "../src/lib/api-client";
+import { ensureInstalled } from "../src/lib/installer";
+
+// Ensure service directory exists on startup
+ensureInstalled();
+
+const program = new Command();
+
+program
+  .name("service-domainsearch")
+  .description("CLI tool for searching and checking domain availability")
+  .version("1.0.0");
+
+// ============ CONFIG COMMANDS ============
+
+program
+  .command("config")
+  .description("Show or set configuration")
+  .option("--api-key <key>", "Set API key")
+  .option("--api-secret <secret>", "Set API secret")
+  .option("--customer-id <id>", "Set customer ID")
+  .option("--api-url <url>", "Set API URL")
+  .option("--show", "Show current configuration")
+  .action(async (options) => {
+    const config = loadConfig();
+
+    if (options.apiKey) {
+      saveConfig({ apiKey: options.apiKey });
+      console.log("API key saved");
+    }
+
+    if (options.apiSecret) {
+      saveConfig({ apiSecret: options.apiSecret });
+      console.log("API secret saved");
+    }
+
+    if (options.customerId) {
+      saveConfig({ customerId: options.customerId });
+      console.log("Customer ID saved");
+    }
+
+    if (options.apiUrl) {
+      saveConfig({ apiUrl: options.apiUrl });
+      console.log(`API URL set to: ${options.apiUrl}`);
+    }
+
+    if (
+      options.show ||
+      (!options.apiKey &&
+        !options.apiSecret &&
+        !options.customerId &&
+        !options.apiUrl)
+    ) {
+      const currentConfig = loadConfig();
+      console.log("\nConfiguration:");
+      console.log(`  Config file: ${CONFIG_FILE}`);
+      console.log(`  API URL: ${currentConfig.apiUrl}`);
+      console.log(
+        `  API Key: ${currentConfig.apiKey ? "***" + currentConfig.apiKey.slice(-4) : "(not set)"}`
+      );
+      console.log(
+        `  API Secret: ${currentConfig.apiSecret ? "***" + currentConfig.apiSecret.slice(-4) : "(not set)"}`
+      );
+      console.log(`  Customer ID: ${currentConfig.customerId || "(not set)"}`);
+    }
+  });
+
+// ============ CHECK COMMAND (single domain) ============
+
+program
+  .command("check <domain>")
+  .description("Check availability of a single domain")
+  .option("-t, --type <type>", "Check type: REGISTRATION, RENEWAL, TRANSFER", "REGISTRATION")
+  .option("-p, --period <years>", "Registration period in years", "1")
+  .option("--json", "Output as JSON")
+  .action(async (domain, options) => {
+    try {
+      const result = await domainApi.checkAvailability(
+        domain,
+        options.type,
+        parseInt(options.period)
+      );
+
+      if (options.json) {
+        console.log(JSON.stringify(result, null, 2));
+        return;
+      }
+
+      const status = result.available ? "AVAILABLE" : "TAKEN";
+      const price = result.price
+        ? formatPrice(result.price, result.currency)
+        : "N/A";
+      const premium = result.registryPremiumPricing ? " [PREMIUM]" : "";
+
+      console.log(`\nDomain: ${domain}`);
+      console.log(`Status: ${status}`);
+      if (result.available) {
+        console.log(`Price: ${price}${premium}`);
+        console.log(`Period: ${result.period || 1} year(s)`);
+      }
+    } catch (error) {
+      console.error("Error:", error instanceof Error ? error.message : error);
+      process.exit(1);
+    }
+  });
+
+// ============ BULK COMMAND (multiple domains) ============
+
+program
+  .command("bulk <domains...>")
+  .description("Check availability of multiple domains")
+  .option("--json", "Output as JSON")
+  .option("--available-only", "Show only available domains")
+  .action(async (domains, options) => {
+    try {
+      const result = await domainApi.checkBulkAvailability(domains);
+
+      if (options.json) {
+        console.log(JSON.stringify(result, null, 2));
+        return;
+      }
+
+      const available = result.domains?.filter((d) => d.available) || [];
+      const taken = result.domains?.filter((d) => !d.available) || [];
+
+      if (options.availableOnly) {
+        console.log(`\nAvailable domains (${available.length}):\n`);
+        for (const d of available) {
+          const price = d.price ? formatPrice(d.price, d.currency) : "N/A";
+          const premium = d.registryPremiumPricing ? " [PREMIUM]" : "";
+          console.log(`  ${d.domain.padEnd(30)} ${price}${premium}`);
+        }
+      } else {
+        console.log(`\nResults for ${domains.length} domains:\n`);
+
+        if (available.length > 0) {
+          console.log("AVAILABLE:");
+          for (const d of available) {
+            const price = d.price ? formatPrice(d.price, d.currency) : "N/A";
+            const premium = d.registryPremiumPricing ? " [PREMIUM]" : "";
+            console.log(`  ${d.domain.padEnd(30)} ${price}${premium}`);
+          }
+        }
+
+        if (taken.length > 0) {
+          console.log("\nTAKEN:");
+          for (const d of taken) {
+            console.log(`  ${d.domain}`);
+          }
+        }
+
+        if (result.errors?.length) {
+          console.log("\nERRORS:");
+          for (const e of result.errors) {
+            console.log(`  ${e.domain}: ${e.message}`);
+          }
+        }
+      }
+
+      console.log(
+        `\nSummary: ${available.length} available, ${taken.length} taken, ${result.errors?.length || 0} errors`
+      );
+    } catch (error) {
+      console.error("Error:", error instanceof Error ? error.message : error);
+      process.exit(1);
+    }
+  });
+
+// ============ SEARCH COMMAND (with TLD variations) ============
+
+program
+  .command("search <name>")
+  .description("Search for domain availability across multiple TLDs")
+  .option(
+    "-e, --extensions <tlds>",
+    "Comma-separated TLDs to check",
+    "com,net,org,io,co,ai,dev"
+  )
+  .option("--json", "Output as JSON")
+  .option("--available-only", "Show only available domains")
+  .action(async (name, options) => {
+    try {
+      const tlds = options.extensions.split(",").map((t: string) => t.trim());
+      const domains = tlds.map((tld: string) => `${name}.${tld}`);
+
+      console.log(`\nSearching for "${name}" across ${tlds.length} TLDs...\n`);
+
+      const result = await domainApi.checkBulkAvailability(domains);
+
+      if (options.json) {
+        console.log(JSON.stringify(result, null, 2));
+        return;
+      }
+
+      const available = result.domains?.filter((d) => d.available) || [];
+      const taken = result.domains?.filter((d) => !d.available) || [];
+
+      // Sort by price
+      available.sort((a, b) => (a.price || 0) - (b.price || 0));
+
+      if (available.length > 0) {
+        console.log("AVAILABLE:");
+        for (const d of available) {
+          const price = d.price ? formatPrice(d.price, d.currency) : "N/A";
+          const premium = d.registryPremiumPricing ? " [PREMIUM]" : "";
+          console.log(`  ${d.domain.padEnd(30)} ${price}${premium}`);
+        }
+      }
+
+      if (!options.availableOnly && taken.length > 0) {
+        console.log("\nTAKEN:");
+        for (const d of taken) {
+          console.log(`  ${d.domain}`);
+        }
+      }
+
+      if (result.errors?.length) {
+        console.log("\nERRORS (TLD not supported):");
+        for (const e of result.errors) {
+          console.log(`  ${e.domain}`);
+        }
+      }
+
+      console.log(
+        `\nSummary: ${available.length} available, ${taken.length} taken`
+      );
+    } catch (error) {
+      console.error("Error:", error instanceof Error ? error.message : error);
+      process.exit(1);
+    }
+  });
+
+// ============ SUGGEST COMMAND ============
+
+program
+  .command("suggest <query>")
+  .description("Get domain name suggestions based on keywords")
+  .option("-l, --limit <count>", "Number of suggestions", "20")
+  .option("--json", "Output as JSON")
+  .action(async (query, options) => {
+    try {
+      const suggestions = await domainApi.getSuggestions(
+        query,
+        parseInt(options.limit)
+      );
+
+      if (options.json) {
+        console.log(JSON.stringify(suggestions, null, 2));
+        return;
+      }
+
+      console.log(`\nSuggestions for "${query}":\n`);
+
+      for (const s of suggestions) {
+        console.log(`  ${s.domain}`);
+      }
+    } catch (error) {
+      console.error("Error:", error instanceof Error ? error.message : error);
+      process.exit(1);
+    }
+  });
+
+// ============ LIST COMMAND (owned domains) ============
+
+program
+  .command("list")
+  .description("List domains owned by your account")
+  .option("-l, --limit <count>", "Maximum domains to list", "100")
+  .option("--json", "Output as JSON")
+  .action(async (options) => {
+    try {
+      const domains = await domainApi.listOwnedDomains(parseInt(options.limit));
+
+      if (options.json) {
+        console.log(JSON.stringify(domains, null, 2));
+        return;
+      }
+
+      console.log(`\nOwned Domains (${domains.length}):\n`);
+
+      for (const d of domains) {
+        const expires = d.expires
+          ? new Date(d.expires).toLocaleDateString()
+          : "N/A";
+        const autoRenew = d.renewAuto ? "[AUTO]" : "";
+        console.log(`  ${d.domain.padEnd(35)} expires: ${expires} ${autoRenew}`);
+      }
+    } catch (error) {
+      console.error("Error:", error instanceof Error ? error.message : error);
+      process.exit(1);
+    }
+  });
+
+// ============ INFO COMMAND (domain details) ============
+
+program
+  .command("info <domain>")
+  .description("Get detailed information about an owned domain")
+  .option("--json", "Output as JSON")
+  .action(async (domain, options) => {
+    try {
+      const details = await domainApi.getDomainDetails(domain);
+
+      if (options.json) {
+        console.log(JSON.stringify(details, null, 2));
+        return;
+      }
+
+      console.log(`\nDomain: ${details.domain}`);
+      console.log(`Status: ${details.status}`);
+      console.log(`Created: ${details.createdAt}`);
+      console.log(`Expires: ${details.expires}`);
+      console.log(`Auto Renew: ${details.renewAuto ? "Yes" : "No"}`);
+      console.log(`Privacy: ${details.privacy ? "Yes" : "No"}`);
+
+      if (details.nameServers?.length) {
+        console.log(`\nNameservers:`);
+        for (const ns of details.nameServers) {
+          console.log(`  - ${ns}`);
+        }
+      }
+    } catch (error) {
+      console.error("Error:", error instanceof Error ? error.message : error);
+      process.exit(1);
+    }
+  });
+
+// ============ TLDS COMMAND ============
+
+program
+  .command("tlds")
+  .description("List supported TLDs")
+  .option("--json", "Output as JSON")
+  .option("-l, --limit <count>", "Number of TLDs to show", "50")
+  .action(async (options) => {
+    try {
+      const tlds = await domainApi.listTlds();
+
+      if (options.json) {
+        console.log(JSON.stringify(tlds.slice(0, parseInt(options.limit)), null, 2));
+        return;
+      }
+
+      console.log(`\nSupported TLDs (showing ${Math.min(tlds.length, parseInt(options.limit))} of ${tlds.length}):\n`);
+
+      for (const tld of tlds.slice(0, parseInt(options.limit))) {
+        console.log(`  .${tld.name} - ${tld.type}`);
+      }
+    } catch (error) {
+      console.error("Error:", error instanceof Error ? error.message : error);
+      process.exit(1);
+    }
+  });
+
+// ============ SETUP COMMAND ============
+
+program
+  .command("setup")
+  .description("Interactive setup for service-domainsearch")
+  .action(async () => {
+    console.log("\nservice-domainsearch Setup\n");
+    console.log("This will configure your Brandsight/GoDaddy API credentials.\n");
+
+    const config = loadConfig();
+
+    if (!config.apiKey || !config.apiSecret) {
+      console.log("API credentials not configured.\n");
+      console.log("Get your API key and secret from:");
+      console.log("  https://developer.godaddy.com/keys\n");
+      console.log("Then run:");
+      console.log("  service-domainsearch config --api-key <key> --api-secret <secret>");
+      console.log("  service-domainsearch config --customer-id <id>\n");
+    } else {
+      console.log(`API Key: ***${config.apiKey.slice(-4)}`);
+      console.log(`API Secret: ***${config.apiSecret.slice(-4)}`);
+      console.log(`Customer ID: ${config.customerId || "(not set)"}`);
+      console.log(`API URL: ${config.apiUrl}\n`);
+
+      // Test connection
+      console.log("Testing connection...");
+      try {
+        const domains = await domainApi.listOwnedDomains(5);
+        console.log(`  Connected! Found ${domains.length} domains in your account.\n`);
+
+        console.log("Quick commands:");
+        console.log("  service-domainsearch check example.com");
+        console.log("  service-domainsearch search mycompany");
+        console.log("  service-domainsearch bulk domain1.com domain2.net");
+        console.log("  service-domainsearch list");
+      } catch (error) {
+        console.error(
+          "  Connection failed:",
+          error instanceof Error ? error.message : error
+        );
+      }
+    }
+  });
+
+program.parse();

package/skills/skill-educational-resource-finder/bin/cli.ts

@@ -0,0 +1,34 @@
+#!/usr/bin/env bun
+
+import { Command } from "commander";
+import { homedir } from "os";
+import { join } from "path";
+
+function getDataDir(): string {
+  return process.env.DATA_DIR || join(homedir(), ".skill", "skill-educational-resource-finder");
+}
+
+const program = new Command();
+
+program
+  .name("skill-educational-resource-finder")
+  .description("Educational Resource Finder skill")
+  .version("0.1.0");
+
+program
+  .command("run")
+  .description("Run the skill")
+  .option("-o, --output <path>", "Output directory", join(getDataDir(), "output"))
+  .allowUnknownOption(true)
+  .action(async (options, command) => {
+    try {
+      const args = command.args;
+      process.env.DATA_DIR = process.env.DATA_DIR || getDataDir();
+      await import("../src/index.js");
+    } catch (err) {
+      console.error(`Error: ${err instanceof Error ? err.message : err}`);
+      process.exit(1);
+    }
+  });
+
+program.parse();

package/skills/skill-email-campaign/bin/cli.ts

@@ -0,0 +1,34 @@
+#!/usr/bin/env bun
+
+import { Command } from "commander";
+import { homedir } from "os";
+import { join } from "path";
+
+function getDataDir(): string {
+  return process.env.DATA_DIR || join(homedir(), ".skill", "skill-email-campaign");
+}
+
+const program = new Command();
+
+program
+  .name("skill-email-campaign")
+  .description("Email Campaign skill")
+  .version("0.1.0");
+
+program
+  .command("run")
+  .description("Run the skill")
+  .option("-o, --output <path>", "Output directory", join(getDataDir(), "output"))
+  .allowUnknownOption(true)
+  .action(async (options, command) => {
+    try {
+      const args = command.args;
+      process.env.DATA_DIR = process.env.DATA_DIR || getDataDir();
+      await import("../src/index.js");
+    } catch (err) {
+      console.error(`Error: ${err instanceof Error ? err.message : err}`);
+      process.exit(1);
+    }
+  });
+
+program.parse();

package/skills/skill-exam-readiness-check/bin/cli.ts

@@ -0,0 +1,34 @@
+#!/usr/bin/env bun
+
+import { Command } from "commander";
+import { homedir } from "os";
+import { join } from "path";
+
+function getDataDir(): string {
+  return process.env.DATA_DIR || join(homedir(), ".skill", "skill-exam-readiness-check");
+}
+
+const program = new Command();
+
+program
+  .name("skill-exam-readiness-check")
+  .description("Exam Readiness Check skill")
+  .version("0.1.0");
+
+program
+  .command("run")
+  .description("Run the skill")
+  .option("-o, --output <path>", "Output directory", join(getDataDir(), "output"))
+  .allowUnknownOption(true)
+  .action(async (options, command) => {
+    try {
+      const args = command.args;
+      process.env.DATA_DIR = process.env.DATA_DIR || getDataDir();
+      await import("../src/index.js");
+    } catch (err) {
+      console.error(`Error: ${err instanceof Error ? err.message : err}`);
+      process.exit(1);
+    }
+  });
+
+program.parse();

package/skills/skill-experiment-power-calculator/bin/cli.ts

@@ -0,0 +1,34 @@
+#!/usr/bin/env bun
+
+import { Command } from "commander";
+import { homedir } from "os";
+import { join } from "path";
+
+function getDataDir(): string {
+  return process.env.DATA_DIR || join(homedir(), ".skill", "skill-experiment-power-calculator");
+}
+
+const program = new Command();
+
+program
+  .name("skill-experiment-power-calculator")
+  .description("Experiment Power Calculator skill")
+  .version("0.1.0");
+
+program
+  .command("run")
+  .description("Run the skill")
+  .option("-o, --output <path>", "Output directory", join(getDataDir(), "output"))
+  .allowUnknownOption(true)
+  .action(async (options, command) => {
+    try {
+      const args = command.args;
+      process.env.DATA_DIR = process.env.DATA_DIR || getDataDir();
+      await import("../src/index.js");
+    } catch (err) {
+      console.error(`Error: ${err instanceof Error ? err.message : err}`);
+      process.exit(1);
+    }
+  });
+
+program.parse();

package/skills/skill-extract-audio/bin/cli.ts

@@ -0,0 +1,19 @@
+#!/usr/bin/env bun
+import { Command } from "commander";
+
+const program = new Command();
+
+program
+  .name("skill-extract-audio")
+  .description("Extract audio tracks from video files")
+  .version("0.1.0");
+
+program
+  .command("run", { isDefault: true })
+  .description("Run the skill")
+  .allowUnknownOption(true)
+  .action(async () => {
+    await import("../src/index.js");
+  });
+
+program.parse();

package/skills/skill-extract-frames/bin/cli.ts

@@ -0,0 +1,34 @@
+#!/usr/bin/env bun
+
+import { Command } from "commander";
+import { homedir } from "os";
+import { join } from "path";
+
+function getDataDir(): string {
+  return process.env.DATA_DIR || join(homedir(), ".skill", "skill-extract-frames");
+}
+
+const program = new Command();
+
+program
+  .name("skill-extract-frames")
+  .description("Extract Frames skill")
+  .version("0.1.0");
+
+program
+  .command("run")
+  .description("Run the skill")
+  .option("-o, --output <path>", "Output directory", join(getDataDir(), "output"))
+  .allowUnknownOption(true)
+  .action(async (options, command) => {
+    try {
+      const args = command.args;
+      process.env.DATA_DIR = process.env.DATA_DIR || getDataDir();
+      await import("../src/index.js");
+    } catch (err) {
+      console.error(`Error: ${err instanceof Error ? err.message : err}`);
+      process.exit(1);
+    }
+  });
+
+program.parse();

package/skills/skill-extract-invoice/bin/cli.ts

@@ -0,0 +1,34 @@
+#!/usr/bin/env bun
+
+import { Command } from "commander";
+import { homedir } from "os";
+import { join } from "path";
+
+function getDataDir(): string {
+  return process.env.DATA_DIR || join(homedir(), ".skill", "skill-extract-invoice");
+}
+
+const program = new Command();
+
+program
+  .name("skill-extract-invoice")
+  .description("Extract Invoice skill")
+  .version("0.1.0");
+
+program
+  .command("run")
+  .description("Run the skill")
+  .option("-o, --output <path>", "Output directory", join(getDataDir(), "output"))
+  .allowUnknownOption(true)
+  .action(async (options, command) => {
+    try {
+      const args = command.args;
+      process.env.DATA_DIR = process.env.DATA_DIR || getDataDir();
+      await import("../src/index.js");
+    } catch (err) {
+      console.error(`Error: ${err instanceof Error ? err.message : err}`);
+      process.exit(1);
+    }
+  });
+
+program.parse();