@conceptcraft/mindframes 0.1.8 → 0.1.10

package/dist/index.js

@@ -1,17 +1,46 @@
 #!/usr/bin/env node
 import { createRequire } from 'module'; const require = createRequire(import.meta.url);
-var __defProp = Object.defineProperty;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __esm = (fn, res) => function __init() {
-  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
-};
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
+
+// src/index.ts
+import { Command as Command20 } from "commander";
+import chalk13 from "chalk";
 
 // src/lib/brand.ts
 import path from "path";
+var BRANDS = {
+  conceptcraft: {
+    id: "conceptcraft",
+    name: "conceptcraft",
+    displayName: "ConceptCraft",
+    description: "CLI tool for ConceptCraft presentation generation",
+    commands: ["cc", "conceptcraft"],
+    apiUrl: "https://conceptcraft.ai",
+    docsUrl: "https://docs.conceptcraft.ai",
+    packageName: "@conceptcraft/cli",
+    configDir: ".conceptcraft",
+    apiKeyEnvVar: "CONCEPTCRAFT_API_KEY",
+    apiUrlEnvVar: "CONCEPTCRAFT_API_URL"
+  },
+  mindframes: {
+    id: "mindframes",
+    name: "mindframes",
+    displayName: "Mindframes",
+    description: "CLI tool for Mindframes presentation generation",
+    commands: ["mf", "mindframes"],
+    apiUrl: "https://mindframes.app",
+    docsUrl: "https://docs.mindframes.app",
+    packageName: "@conceptcraft/mindframes",
+    configDir: ".mindframes",
+    apiKeyEnvVar: "MINDFRAMES_API_KEY",
+    apiUrlEnvVar: "MINDFRAMES_API_URL"
+  }
+};
+var COMMAND_TO_BRAND = {
+  cc: "conceptcraft",
+  conceptcraft: "conceptcraft",
+  mf: "mindframes",
+  mindframes: "mindframes"
+};
 function detectBrand() {
   const binaryPath = process.argv[1] || "";
   const binaryName = path.basename(binaryPath).replace(/\.(js|ts)$/, "");
@@ -26,50 +55,52 @@ function detectBrand() {
   }
   return BRANDS.mindframes;
 }
-var BRANDS, COMMAND_TO_BRAND, brand;
-var init_brand = __esm({
-  "src/lib/brand.ts"() {
-    "use strict";
-    BRANDS = {
-      conceptcraft: {
-        id: "conceptcraft",
-        name: "conceptcraft",
-        displayName: "ConceptCraft",
-        description: "CLI tool for ConceptCraft presentation generation",
-        commands: ["cc", "conceptcraft"],
-        apiUrl: "https://conceptcraft.ai",
-        docsUrl: "https://docs.conceptcraft.ai",
-        packageName: "@conceptcraft/cli",
-        configDir: ".conceptcraft",
-        apiKeyEnvVar: "CONCEPTCRAFT_API_KEY",
-        apiUrlEnvVar: "CONCEPTCRAFT_API_URL"
-      },
-      mindframes: {
-        id: "mindframes",
-        name: "mindframes",
-        displayName: "Mindframes",
-        description: "CLI tool for Mindframes presentation generation",
-        commands: ["mf", "mindframes"],
-        apiUrl: "https://mindframes.app",
-        docsUrl: "https://docs.mindframes.app",
-        packageName: "@conceptcraft/mindframes",
-        configDir: ".mindframes",
-        apiKeyEnvVar: "MINDFRAMES_API_KEY",
-        apiUrlEnvVar: "MINDFRAMES_API_URL"
-      }
-    };
-    COMMAND_TO_BRAND = {
-      cc: "conceptcraft",
-      conceptcraft: "conceptcraft",
-      mf: "mindframes",
-      mindframes: "mindframes"
-    };
-    brand = detectBrand();
-  }
-});
+var brand = detectBrand();
+
+// src/commands/login.ts
+import { Command } from "commander";
+import chalk3 from "chalk";
+import ora from "ora";
+import http from "http";
+import { randomBytes, createHash } from "crypto";
+import open from "open";
 
 // src/lib/config.ts
 import Conf from "conf";
+var DEFAULT_API_URL = "https://www.mindframes.app";
+var schema = {
+  apiKey: {
+    type: "string"
+  },
+  apiUrl: {
+    type: "string",
+    default: DEFAULT_API_URL
+  },
+  defaultTeamId: {
+    type: "string"
+  },
+  // OAuth tokens (preferred over API key)
+  accessToken: {
+    type: "string"
+  },
+  refreshToken: {
+    type: "string"
+  },
+  tokenExpiresAt: {
+    type: "number"
+  },
+  // OAuth client registration (cached per-server)
+  clientId: {
+    type: "string"
+  },
+  clientSecret: {
+    type: "string"
+  }
+};
+var config = new Conf({
+  projectName: brand.name,
+  schema
+});
 function getConfig() {
   return {
     apiKey: getApiKey(),
@@ -151,47 +182,6 @@ function setOAuthClient(clientId, clientSecret) {
   config.set("clientId", clientId);
   config.set("clientSecret", clientSecret);
 }
-var DEFAULT_API_URL, schema, config;
-var init_config = __esm({
-  "src/lib/config.ts"() {
-    "use strict";
-    init_brand();
-    DEFAULT_API_URL = "https://www.mindframes.app";
-    schema = {
-      apiKey: {
-        type: "string"
-      },
-      apiUrl: {
-        type: "string",
-        default: DEFAULT_API_URL
-      },
-      defaultTeamId: {
-        type: "string"
-      },
-      // OAuth tokens (preferred over API key)
-      accessToken: {
-        type: "string"
-      },
-      refreshToken: {
-        type: "string"
-      },
-      tokenExpiresAt: {
-        type: "number"
-      },
-      // OAuth client registration (cached per-server)
-      clientId: {
-        type: "string"
-      },
-      clientSecret: {
-        type: "string"
-      }
-    };
-    config = new Conf({
-      projectName: brand.name,
-      schema
-    });
-  }
-});
 
 // src/lib/output.ts
 import chalk from "chalk";
@@ -358,40 +348,25 @@ function formatJson(data) {
 function printJson(data) {
   console.log(formatJson(data));
 }
-var init_output = __esm({
-  "src/lib/output.ts"() {
-    "use strict";
-    init_config();
-  }
-});
 
-// src/types/media.ts
-var init_media = __esm({
-  "src/types/media.ts"() {
-    "use strict";
-  }
-});
+// src/lib/feature-cache.ts
+import Conf2 from "conf";
+
+// src/lib/auth.ts
+import chalk2 from "chalk";
 
 // src/types/index.ts
-var EXIT_CODES;
-var init_types = __esm({
-  "src/types/index.ts"() {
-    "use strict";
-    init_media();
-    EXIT_CODES = {
-      SUCCESS: 0,
-      GENERAL_ERROR: 1,
-      AUTH_ERROR: 2,
-      NOT_FOUND: 3,
-      RATE_LIMIT: 4,
-      NETWORK_ERROR: 5,
-      INVALID_INPUT: 6
-    };
-  }
-});
+var EXIT_CODES = {
+  SUCCESS: 0,
+  GENERAL_ERROR: 1,
+  AUTH_ERROR: 2,
+  NOT_FOUND: 3,
+  RATE_LIMIT: 4,
+  NETWORK_ERROR: 5,
+  INVALID_INPUT: 6
+};
 
 // src/lib/auth.ts
-import chalk2 from "chalk";
 async function refreshAccessToken() {
   const refreshToken = getRefreshToken();
   const clientId = getClientId();
@@ -440,21 +415,15 @@ function hasAuth() {
 }
 async function requireAuth() {
   if (!hasAuth()) {
-    const { confirm: confirm4 } = await import("@inquirer/prompts");
-    try {
-      const shouldLogin = await confirm4({
-        message: chalk2.red("Not authenticated.") + " Log in now?",
-        default: true
-      });
-      if (!shouldLogin) {
-        console.log(chalk2.gray("\nTip: You can also set CC_MINDFRAMES_API_KEY environment variable."));
-        process.exit(EXIT_CODES.AUTH_ERROR);
-      }
-      const { runLoginFlow: runLoginFlow2 } = await Promise.resolve().then(() => (init_login(), login_exports));
-      await runLoginFlow2({ browser: true });
-    } catch {
-      process.exit(EXIT_CODES.AUTH_ERROR);
-    }
+    const cmd2 = brand.commands[0];
+    const envVar = brand.apiKeyEnvVar;
+    console.error(chalk2.red("\u2717 Not authenticated."));
+    console.error();
+    console.error(chalk2.bold("To authenticate, run:"));
+    console.error(chalk2.cyan(`  ${cmd2} login`));
+    console.error();
+    console.error(chalk2.gray(`Or set ${envVar} environment variable.`));
+    process.exit(EXIT_CODES.AUTH_ERROR);
   }
 }
 function maskApiKey(key) {
@@ -472,13 +441,6 @@ function isValidApiKeyFormat(key) {
   const validPrefixes = ["cc_slides_", "mcp_", "cc_sk_", "sk_"];
   return validPrefixes.some((prefix) => key.startsWith(prefix));
 }
-var init_auth = __esm({
-  "src/lib/auth.ts"() {
-    "use strict";
-    init_config();
-    init_types();
-  }
-});
 
 // src/lib/api.ts
 import { readFileSync, statSync } from "fs";
@@ -495,6 +457,14 @@ async function getAuthHeaders() {
   }
   return {};
 }
+var ApiError = class extends Error {
+  constructor(message, statusCode, exitCode = 1) {
+    super(message);
+    this.statusCode = statusCode;
+    this.exitCode = exitCode;
+    this.name = "ApiError";
+  }
+};
 async function request(endpoint, options = {}) {
   const apiUrl = getApiUrl();
   if (!hasAuth()) {
@@ -1088,26 +1058,14 @@ async function pollForCompletion(checkFn, maxAttempts = 60, intervalMs = 2e3) {
   }
   throw new ApiError("Operation timed out", 408, 1);
 }
-var ApiError;
-var init_api = __esm({
-  "src/lib/api.ts"() {
-    "use strict";
-    init_config();
-    init_auth();
-    init_brand();
-    ApiError = class extends Error {
-      constructor(message, statusCode, exitCode = 1) {
-        super(message);
-        this.statusCode = statusCode;
-        this.exitCode = exitCode;
-        this.name = "ApiError";
-      }
-    };
-  }
-});
 
 // src/lib/feature-cache.ts
-import Conf2 from "conf";
+var cache = new Conf2({
+  projectName: "conceptcraft",
+  configName: "feature-cache"
+});
+var FRESH_TTL = 60 * 60 * 1e3;
+var STALE_TTL = 24 * 60 * 60 * 1e3;
 function hashApiKey(key) {
   let hash = 0;
   for (let i = 0; i < key.length; i++) {
@@ -1153,33 +1111,11 @@ function invalidateCache() {
 function getCachePath() {
   return cache.path;
 }
-var cache, FRESH_TTL, STALE_TTL;
-var init_feature_cache = __esm({
-  "src/lib/feature-cache.ts"() {
-    "use strict";
-    init_api();
-    init_config();
-    cache = new Conf2({
-      projectName: "conceptcraft",
-      configName: "feature-cache"
-    });
-    FRESH_TTL = 60 * 60 * 1e3;
-    STALE_TTL = 24 * 60 * 60 * 1e3;
-  }
-});
 
 // src/commands/login.ts
-var login_exports = {};
-__export(login_exports, {
-  loginCommand: () => loginCommand,
-  runLoginFlow: () => runLoginFlow
-});
-import { Command } from "commander";
-import chalk3 from "chalk";
-import ora from "ora";
-import http from "http";
-import { randomBytes, createHash } from "crypto";
-import open from "open";
+var CLI_CLIENT_NAME = "ConceptCraft CLI";
+var CALLBACK_PORT_START = 8765;
+var CALLBACK_PORT_END = 8775;
 function generateCodeVerifier() {
   return randomBytes(32).toString("base64url");
 }
@@ -1427,43 +1363,22 @@ async function runLoginFlow(options) {
     throw err;
   }
 }
-var CLI_CLIENT_NAME, CALLBACK_PORT_START, CALLBACK_PORT_END, loginCommand;
-var init_login = __esm({
-  "src/commands/login.ts"() {
-    "use strict";
-    init_config();
-    init_output();
-    init_feature_cache();
-    CLI_CLIENT_NAME = "ConceptCraft CLI";
-    CALLBACK_PORT_START = 8765;
-    CALLBACK_PORT_END = 8775;
-    loginCommand = new Command("login").description("Authenticate with ConceptCraft (opens browser)").option("--no-browser", "Print URL instead of opening browser").action(async (options) => {
-      console.log();
-      if (hasOAuthTokens()) {
-        warn("You are already logged in.");
-        info("Run 'conceptcraft logout' to log out first, or continue to re-authenticate.");
-        console.log();
-      }
-      try {
-        await runLoginFlow(options);
-        process.exit(0);
-      } catch {
-        process.exit(1);
-      }
-    });
+var loginCommand = new Command("login").description("Authenticate with ConceptCraft (opens browser)").option("--no-browser", "Print URL instead of opening browser").action(async (options) => {
+  console.log();
+  if (hasOAuthTokens()) {
+    warn("You are already logged in.");
+    info("Run 'conceptcraft logout' to log out first, or continue to re-authenticate.");
+    console.log();
+  }
+  try {
+    await runLoginFlow(options);
+    process.exit(0);
+  } catch {
+    process.exit(1);
   }
 });
 
-// src/index.ts
-init_brand();
-init_login();
-import { Command as Command20 } from "commander";
-import chalk13 from "chalk";
-
 // src/commands/logout.ts
-init_config();
-init_feature_cache();
-init_output();
 import { Command as Command2 } from "commander";
 import { confirm } from "@inquirer/prompts";
 var logoutCommand = new Command2("logout").description("Log out and clear authentication").option("--all", "Clear all config including API key").action(async (options) => {
@@ -1503,11 +1418,6 @@ var logoutCommand = new Command2("logout").description("Log out and clear authen
 });
 
 // src/commands/config.ts
-init_config();
-init_auth();
-init_api();
-init_feature_cache();
-init_output();
 import { Command as Command3 } from "commander";
 import chalk4 from "chalk";
 import { input, password, confirm as confirm2, select } from "@inquirer/prompts";
@@ -1711,13 +1621,10 @@ var configCommand = new Command3("config").description("Manage CLI configuration
 );
 
 // src/commands/create.ts
-init_api();
-init_auth();
 import { Command as Command4 } from "commander";
 import chalk6 from "chalk";
 
 // src/lib/streaming.ts
-init_output();
 import { createParser } from "eventsource-parser";
 import chalk5 from "chalk";
 import ora3 from "ora";
@@ -1979,7 +1886,6 @@ async function streamTextContent(response, options = {}) {
 }
 
 // src/commands/create.ts
-init_output();
 import { readFileSync as readFileSync2, existsSync } from "fs";
 import { resolve } from "path";
 var VALID_GOALS = [
@@ -2461,10 +2367,6 @@ function isUrl(str) {
 }
 
 // src/commands/list.ts
-init_api();
-init_auth();
-init_config();
-init_output();
 import { Command as Command5 } from "commander";
 var listCommand = new Command5("list").description("List presentations").option("-n, --limit <count>", "Number of results to return", "20").option(
   "-f, --format <format>",
@@ -2528,9 +2430,6 @@ var listCommand = new Command5("list").description("List presentations").option(
 });
 
 // src/commands/get.ts
-init_api();
-init_auth();
-init_output();
 import { Command as Command6 } from "commander";
 import chalk7 from "chalk";
 var getCommand = new Command6("get").description("Get presentation details").argument("<slug>", "Presentation slug (e.g., my-presentation-v1-abc123)").option(
@@ -2573,9 +2472,6 @@ var getCommand = new Command6("get").description("Get presentation details").arg
 });
 
 // src/commands/delete.ts
-init_api();
-init_auth();
-init_output();
 import { Command as Command7 } from "commander";
 import { confirm as confirm3 } from "@inquirer/prompts";
 var deleteCommand = new Command7("delete").description("Delete a presentation").argument("<slug>", "Presentation slug (e.g., my-presentation-v1-abc123)").option("-f, --force", "Skip confirmation prompt").option("-q, --quiet", "Suppress output").action(async (slug, options) => {
@@ -2611,9 +2507,6 @@ var deleteCommand = new Command7("delete").description("Delete a presentation").
 });
 
 // src/commands/export.ts
-init_api();
-init_auth();
-init_output();
 import { Command as Command8 } from "commander";
 import { writeFile } from "fs/promises";
 import { resolve as resolve2 } from "path";
@@ -2655,10 +2548,6 @@ function formatBytes(bytes) {
 }
 
 // src/commands/import.ts
-init_api();
-init_auth();
-init_output();
-init_config();
 import { Command as Command9 } from "commander";
 import { readFile } from "fs/promises";
 import { resolve as resolve3, basename as basename2 } from "path";
@@ -2748,10 +2637,6 @@ var importCommand = cmd.option("--dry-run", "Validate without importing").option
 });
 
 // src/commands/branding.ts
-init_api();
-init_auth();
-init_config();
-init_output();
 import { Command as Command10 } from "commander";
 import chalk8 from "chalk";
 import ora6 from "ora";
@@ -2925,13 +2810,9 @@ var brandingCommand = new Command10("branding").description("Manage brand profil
 );
 
 // src/commands/derive.ts
-init_api();
-init_auth();
-init_feature_cache();
 import { Command as Command11 } from "commander";
 import chalk9 from "chalk";
 import ora7 from "ora";
-init_output();
 function createBlogCommand() {
   return new Command11("blog").description("Generate a blog post from a presentation").argument("<slug>", "Presentation slug").option("--words <count>", "Target word count (50-2000)", "300").option(
     "--tone <tone>",
@@ -3055,8 +2936,6 @@ function buildDeriveCommand() {
 }
 
 // src/commands/ideas.ts
-init_auth();
-init_output();
 import { Command as Command12 } from "commander";
 import chalk10 from "chalk";
 var ideasCommand = new Command12("ideas").description("Generate presentation topic ideas").option("--context <text>", "Custom context for idea generation").option("--count <n>", "Number of ideas to generate", "5").option("-f, --format <format>", "Output format (human, json)", "human").action(async (options) => {
@@ -3080,10 +2959,6 @@ var ideasCommand = new Command12("ideas").description("Generate presentation top
 });
 
 // src/commands/whoami.ts
-init_api();
-init_auth();
-init_feature_cache();
-init_output();
 import { Command as Command13 } from "commander";
 import chalk11 from "chalk";
 var whoamiCommand = new Command13("whoami").description("Show current user and team information").option("-f, --format <format>", "Output format (human, json)", "human").action(async (options) => {
@@ -3139,11 +3014,430 @@ var whoamiCommand = new Command13("whoami").description("Show current user and t
 });
 
 // src/commands/skill/index.ts
-init_output();
-init_brand();
 import { Command as Command14 } from "commander";
 import chalk12 from "chalk";
 
+// src/commands/skill/generate-main-skill.ts
+function generateMainSkillContent(context) {
+  const { name, cmd: cmd2, displayName } = context;
+  const envPrefix = name.toUpperCase().replace(/-/g, "_");
+  return `---
+name: ${name}
+description: ${displayName} CLI for AI-powered content creation. Use when user needs to create presentations, generate video assets (voiceover, music, images, stock videos), use text-to-speech, mix audio, search stock media, or manage branding. This is the main entry point - load specialized skills (${name}-video, ${name}-presentation) for detailed workflows.
+---
+
+# ${displayName} CLI
+
+A comprehensive CLI for AI-powered content creation. Generate presentations, video assets, voiceovers, music, and search stock media - all from your terminal.
+
+**Install:** \`npm install -g @${name}/cli\` or \`pnpm add -g @${name}/cli\`
+
+---
+
+## Quick Reference
+
+| Task | Command |
+|------|---------|
+| Create presentation | \`${cmd2} create "Topic"\` |
+| Generate video assets | \`${cmd2} video create < scenes.json\` |
+| Text-to-speech | \`${cmd2} tts generate -t "Text" -o voice.mp3\` |
+| Generate music | \`${cmd2} music generate -p "upbeat corporate"\` |
+| Search images | \`${cmd2} image search -q "mountain landscape"\` |
+| Search videos | \`${cmd2} video search "ocean waves"\` |
+| Mix audio tracks | \`${cmd2} mix create --video v.mp4 --music m.mp3\` |
+
+---
+
+## Authentication
+
+**IMPORTANT:** Most commands require authentication. If a command fails with "Not authenticated", run:
+
+\`\`\`bash
+${cmd2} login
+\`\`\`
+
+This opens a browser for OAuth login. Alternatively, set an API key:
+
+\`\`\`bash
+export ${envPrefix}_API_KEY="your-key-here"
+\`\`\`
+
+**Verify authentication:**
+\`\`\`bash
+${cmd2} whoami
+\`\`\`
+
+---
+
+## 1. Presentations
+
+Create AI-powered presentations from text, files, URLs, or piped content.
+
+\`\`\`bash
+# From topic
+${cmd2} create "AI-powered analytics platform"
+
+# From file (PDF, PPTX, DOCX, Markdown)
+${cmd2} create "Quarterly Report" --file report.pdf
+
+# From URL
+${cmd2} create "Product Overview" --sources https://company.com/product
+
+# From piped content
+cat notes.md | ${cmd2} create "Meeting Summary"
+
+# With options
+${cmd2} create "Pitch Deck" \\
+  --slides 10 \\
+  --mode balanced \\
+  --tone professional \\
+  --audience "Investors" \\
+  --brand my-company \\
+  --open
+\`\`\`
+
+**Key Options:**
+- \`--slides <1-20>\` - Number of slides (default: 10)
+- \`--mode <instant|ultrafast|fast|balanced|best>\` - Quality/speed tradeoff
+- \`--tone <creative|professional|educational|formal|casual>\`
+- \`--file <paths...>\` - Extract content from files
+- \`--sources <urls...>\` - Scrape URLs for context
+- \`--brand <id|url>\` - Apply branding
+- \`--open\` - Open in browser when done
+
+**Manage presentations:**
+\`\`\`bash
+${cmd2} list                    # List all presentations
+${cmd2} get <slug>              # Get details
+${cmd2} export <slug> -o p.zip  # Export to ZIP
+${cmd2} delete <slug>           # Delete
+\`\`\`
+
+---
+
+## 2. Video Asset Generation
+
+Generate voiceovers, music, and find stock media for video production. Works with Remotion or any video framework.
+
+### Generate All Assets at Once
+
+\`\`\`bash
+cat <<'EOF' | ${cmd2} video create --output ./public
+{
+  "scenes": [
+    {
+      "name": "Hook",
+      "script": "Watch how we transformed complex workflows into a single click.",
+      "imageQuery": "modern dashboard dark theme",
+      "videoQuery": "abstract tech particles"
+    },
+    {
+      "name": "Demo",
+      "script": "Our AI analyzes data in real-time, surfacing insights that matter.",
+      "imageQuery": "data visualization charts"
+    },
+    {
+      "name": "CTA",
+      "script": "Start your free trial today.",
+      "imageQuery": "call to action button"
+    }
+  ],
+  "voice": "Kore",
+  "voiceSettings": {
+    "speed": 0.95,
+    "stability": 0.4,
+    "style": 0.6
+  },
+  "musicPrompt": "upbeat corporate, positive energy, modern synth"
+}
+EOF
+\`\`\`
+
+**Output:** Per-scene voiceovers, background music, stock images/videos, and \`video-manifest.json\` with timing data.
+
+### Initialize Remotion Project
+
+\`\`\`bash
+${cmd2} video init my-video              # 16:9 landscape
+${cmd2} video init my-video --type tiktok # 9:16 vertical
+\`\`\`
+
+### Embed Thumbnail
+
+\`\`\`bash
+${cmd2} video thumbnail video.mp4 --frame 60
+\`\`\`
+
+---
+
+## 3. Text-to-Speech (TTS)
+
+Convert text to natural speech with multiple providers and voices.
+
+\`\`\`bash
+# Basic usage
+${cmd2} tts generate -t "Hello world" -o output.mp3
+
+# With voice selection
+${cmd2} tts generate -t "Welcome to the demo" -v Rachel -o welcome.mp3
+
+# With provider and settings
+${cmd2} tts generate \\
+  -t "Professional narration" \\
+  -v Kore \\
+  -p gemini \\
+  -s 0.9 \\
+  -o narration.mp3
+
+# List available voices
+${cmd2} tts voices
+${cmd2} tts voices --provider elevenlabs
+\`\`\`
+
+**Providers:** \`gemini\`, \`elevenlabs\`, \`openai\`
+**Popular voices:** \`Kore\`, \`Puck\`, \`Rachel\`, \`alloy\`
+**Speed range:** 0.25 - 4.0 (default: 1.0)
+
+---
+
+## 4. Music Generation
+
+Generate AI music from text descriptions.
+
+\`\`\`bash
+# Generate music
+${cmd2} music generate -p "upbeat corporate, modern synth" --duration 30
+
+# Save to file
+${cmd2} music generate -p "calm ambient background" -o music.mp3
+
+# Check generation status (for async operations)
+${cmd2} music status <request-id>
+\`\`\`
+
+**Duration:** 3-30 seconds
+**Providers:** \`elevenlabs\`, \`suno\`
+
+---
+
+## 5. Image Search
+
+Search for stock images from multiple sources.
+
+\`\`\`bash
+# Basic search
+${cmd2} image search -q "mountain landscape"
+
+# With options
+${cmd2} image search -q "business team meeting" \\
+  --max-results 20 \\
+  --size large \\
+  --format json
+
+# Download for video project
+${cmd2} image search -q "tech abstract" -n 5 --format json > images.json
+\`\`\`
+
+**Options:**
+- \`--max-results <n>\` - Number of results (default: 10)
+- \`--size <small|medium|large|any>\` - Image size
+- \`--safe-search / --no-safe-search\` - Filter adult content
+
+---
+
+## 6. Video Search
+
+Search for stock video clips.
+
+\`\`\`bash
+# Basic search
+${cmd2} video search "ocean waves"
+
+# With filters
+${cmd2} video search "city timelapse" \\
+  --max-results 5 \\
+  --orientation landscape \\
+  --license free
+\`\`\`
+
+**Options:**
+- \`--orientation <landscape|portrait|square|any>\`
+- \`--license <free|premium|any>\`
+
+---
+
+## 7. Audio Mixing
+
+Mix video with voiceover and background music.
+
+\`\`\`bash
+# Mix audio tracks
+${cmd2} mix create \\
+  --video input.mp4 \\
+  --voice voiceover.mp3 \\
+  --music background.mp3 \\
+  --music-volume 30 \\
+  --voice-volume 100 \\
+  -o final.mp4
+
+# Check mixing status
+${cmd2} mix status <request-id>
+\`\`\`
+
+Music automatically loops to match video duration.
+
+---
+
+## 8. Branding
+
+Manage brand profiles for consistent styling.
+
+\`\`\`bash
+# List saved brands
+${cmd2} branding list
+
+# Extract branding from website
+${cmd2} branding extract https://company.com
+
+# Get brand details
+${cmd2} branding get <brand-id>
+
+# Set default brand
+${cmd2} branding set-default <brand-id>
+
+# Use in presentations
+${cmd2} create "Topic" --brand my-company
+\`\`\`
+
+---
+
+## 9. Configuration
+
+\`\`\`bash
+# Interactive setup
+${cmd2} config init
+
+# Show current config
+${cmd2} config show
+${cmd2} config show --verify  # Verify API key
+
+# Set values
+${cmd2} config set api-key <key>
+${cmd2} config set team-id <id>
+
+# Clear config
+${cmd2} config clear
+
+# Show config file location
+${cmd2} config path
+\`\`\`
+
+---
+
+## Output Formats
+
+All commands support multiple output formats:
+
+\`\`\`bash
+${cmd2} <command> --format human  # Default, colored terminal output
+${cmd2} <command> --format json   # Machine-readable JSON
+${cmd2} <command> --format quiet  # Minimal output, errors only
+\`\`\`
+
+---
+
+## Environment Variables
+
+\`\`\`bash
+${envPrefix}_API_KEY    # API key for authentication
+${envPrefix}_API_URL    # Custom API URL (optional)
+\`\`\`
+
+---
+
+## Specialized Skills
+
+For detailed workflows, load these skills:
+
+- **\`${name}-video\`** - Detailed video creation workflow, Remotion integration, composition rules, R3F/Three.js patterns
+- **\`${name}-presentation\`** - Detailed presentation creation, styling options, export formats
+
+---
+
+## Common Workflows
+
+### Video Production Pipeline
+
+\`\`\`bash
+# 1. Initialize project
+${cmd2} video init product-demo
+
+# 2. Generate assets
+cat scenes.json | ${cmd2} video create -o product-demo/public
+
+# 3. Implement in Remotion (see ${name}-video skill)
+
+# 4. Render and add thumbnail
+cd product-demo
+pnpm exec remotion render FullVideo
+${cmd2} video thumbnail out/FullVideo.mp4 --frame 60
+\`\`\`
+
+### Presentation from Research
+
+\`\`\`bash
+# Gather content from multiple sources
+${cmd2} create "Market Analysis" \\
+  --file research.pdf \\
+  --sources https://industry-report.com \\
+  --context "Focus on Q4 trends" \\
+  --slides 15 \\
+  --tone professional \\
+  --brand company \\
+  --open
+\`\`\`
+
+### Batch Image Collection
+
+\`\`\`bash
+# Get images for video scenes
+for query in "hero shot" "team photo" "product showcase"; do
+  ${cmd2} image search -q "$query" -n 3 --format json
+done
+\`\`\`
+
+---
+
+## Troubleshooting
+
+**Authentication issues:**
+\`\`\`bash
+${cmd2} whoami              # Check current user
+${cmd2} logout && ${cmd2} login  # Re-authenticate
+\`\`\`
+
+**Check API status:**
+\`\`\`bash
+${cmd2} config show --verify
+\`\`\`
+
+**Debug mode:**
+\`\`\`bash
+${cmd2} <command> --debug
+\`\`\`
+
+---
+
+## Help
+
+\`\`\`bash
+${cmd2} --help              # General help
+${cmd2} <command> --help    # Command-specific help
+${cmd2} --version           # Version info
+\`\`\`
+`;
+}
+
 // src/commands/skill/rules/video/content.ts
 var VIDEO_RULE_CONTENTS = [
   {
@@ -4405,6 +4699,7 @@ function getSupportedEditorNames() {
 }
 
 // src/commands/skill/index.ts
+var SKILL_TYPES = ["main", "video", "presentation"];
 var skillContext = {
   name: brand.name,
   cmd: brand.commands[0],
@@ -4413,25 +4708,39 @@ var skillContext = {
 var skillCommand = new Command14("skill").description(`Manage ${brand.displayName} skills for AI coding assistants`).addHelpText(
   "after",
   `
+${chalk12.bold("Skill Types:")}
+  ${chalk12.cyan("main")}          Main CLI skill with all capabilities (TTS, music, images, videos, presentations)
+  ${chalk12.cyan("video")}         Detailed video creation workflow with Remotion/R3F patterns
+  ${chalk12.cyan("presentation")}  Detailed presentation creation workflow
+
 ${chalk12.bold("Examples:")}
+  ${chalk12.gray("# Install main CLI skill (comprehensive overview)")}
+  $ ${brand.commands[0]} skill install main
+
   ${chalk12.gray("# Install video skill")}
   $ ${brand.commands[0]} skill install video
 
   ${chalk12.gray("# Install presentation skill")}
   $ ${brand.commands[0]} skill install presentation
 
-  ${chalk12.gray("# Install both skills")}
+  ${chalk12.gray("# Install all skills")}
   $ ${brand.commands[0]} skill install
 
   ${chalk12.gray("# Install to specific directory")}
-  $ ${brand.commands[0]} skill install video --dir ~/.claude
+  $ ${brand.commands[0]} skill install main --dir ~/.claude
 
   ${chalk12.gray("# Show skill content")}
-  $ ${brand.commands[0]} skill show video
+  $ ${brand.commands[0]} skill show main
 `
 );
-skillCommand.command("install").description(`Install ${brand.displayName} skills for AI coding assistants`).argument("[type]", "Skill type: video, presentation, or omit for both").option("-d, --dir <path>", "Install to specific directory").option("-g, --global", "Install globally (to home directory)", true).option("-l, --local", "Install locally (to current directory)").option("-f, --force", "Overwrite existing skill files").action(async (type, options) => {
+skillCommand.command("install").description(`Install ${brand.displayName} skills for AI coding assistants`).argument("[type]", "Skill type: main, video, presentation, or omit for all").option("-d, --dir <path>", "Install to specific directory").option("-g, --global", "Install globally (to home directory)", true).option("-l, --local", "Install locally (to current directory)").option("-f, --force", "Overwrite existing skill files").action(async (type, options) => {
   const skillsToInstall = [];
+  if (!type || type === "main") {
+    skillsToInstall.push({
+      name: brand.name,
+      content: generateMainSkillContent(skillContext)
+    });
+  }
   if (!type || type === "video") {
     skillsToInstall.push({
       name: `${brand.name}-video`,
@@ -4444,8 +4753,8 @@ skillCommand.command("install").description(`Install ${brand.displayName} skills
       content: generatePresentationSkillContent(skillContext)
     });
   }
-  if (type && type !== "video" && type !== "presentation") {
-    error(`Invalid skill type: ${type}. Must be "video" or "presentation"`);
+  if (type && !SKILL_TYPES.includes(type)) {
+    error(`Invalid skill type: ${type}. Must be one of: ${SKILL_TYPES.join(", ")}`);
     process.exit(1);
   }
   console.log();
@@ -4477,26 +4786,31 @@ skillCommand.command("install").description(`Install ${brand.displayName} skills
     console.log();
   }
 });
-skillCommand.command("show").description("Display skill content").argument("[type]", "Skill type: video or presentation (default: video)").action((type = "video") => {
-  if (type === "video") {
+skillCommand.command("show").description("Display skill content").argument("[type]", "Skill type: main, video, or presentation (default: main)").action((type = "main") => {
+  if (type === "main") {
+    console.log(generateMainSkillContent(skillContext));
+  } else if (type === "video") {
     console.log(generateVideoSkillContent(skillContext));
   } else if (type === "presentation") {
     console.log(generatePresentationSkillContent(skillContext));
   } else {
-    error(`Invalid skill type: ${type}. Must be "video" or "presentation"`);
+    error(`Invalid skill type: ${type}. Must be one of: ${SKILL_TYPES.join(", ")}`);
     process.exit(1);
   }
 });
-skillCommand.command("uninstall").description(`Remove ${brand.displayName} skills from AI coding assistants`).argument("[type]", "Skill type: video, presentation, or omit for both").option("-g, --global", "Uninstall globally (from home directory)", true).option("-l, --local", "Uninstall locally (from current directory)").action(async (type, options) => {
+skillCommand.command("uninstall").description(`Remove ${brand.displayName} skills from AI coding assistants`).argument("[type]", "Skill type: main, video, presentation, or omit for all").option("-g, --global", "Uninstall globally (from home directory)", true).option("-l, --local", "Uninstall locally (from current directory)").action(async (type, options) => {
   const skillsToRemove = [];
+  if (!type || type === "main") {
+    skillsToRemove.push(brand.name);
+  }
   if (!type || type === "video") {
     skillsToRemove.push(`${brand.name}-video`);
   }
   if (!type || type === "presentation") {
     skillsToRemove.push(`${brand.name}-presentation`);
   }
-  if (type && type !== "video" && type !== "presentation") {
-    error(`Invalid skill type: ${type}. Must be "video" or "presentation"`);
+  if (type && !SKILL_TYPES.includes(type)) {
+    error(`Invalid skill type: ${type}. Must be one of: ${SKILL_TYPES.join(", ")}`);
     process.exit(1);
   }
   console.log();
@@ -4518,9 +4832,6 @@ skillCommand.command("uninstall").description(`Remove ${brand.displayName} skill
 });
 
 // src/commands/tts.ts
-init_api();
-init_output();
-init_types();
 import { Command as Command15 } from "commander";
 import ora8 from "ora";
 import { writeFile as writeFile2 } from "fs/promises";
@@ -4609,9 +4920,6 @@ var voicesCommand = new Command15("voices").description("List available voices")
 var ttsCommand = new Command15("tts").description("Text-to-speech commands").addCommand(generateCommand).addCommand(voicesCommand);
 
 // src/commands/music.ts
-init_api();
-init_output();
-init_types();
 import { Command as Command16 } from "commander";
 import ora9 from "ora";
 import { writeFile as writeFile3 } from "fs/promises";
@@ -4731,9 +5039,6 @@ var statusCommand = new Command16("status").description("Check status of a music
 var musicCommand = new Command16("music").description("Music generation commands").addCommand(generateCommand2).addCommand(statusCommand);
 
 // src/commands/mix.ts
-init_api();
-init_output();
-init_types();
 import { Command as Command17 } from "commander";
 import ora10 from "ora";
 import { writeFile as writeFile4 } from "fs/promises";
@@ -4857,9 +5162,6 @@ var statusCommand2 = new Command17("status").description("Check status of an aud
 var mixAudioCommand = new Command17("mix").description("Audio mixing commands").addCommand(mixCommand).addCommand(statusCommand2);
 
 // src/commands/image.ts
-init_api();
-init_output();
-init_types();
 import { Command as Command18 } from "commander";
 import ora11 from "ora";
 var searchCommand = new Command18("search").description("Search for images").requiredOption("-q, --query <query>", "Search query").option("-n, --max-results <number>", "Maximum number of results (default: 10)").option("-s, --size <size>", "Image size: small, medium, large, any", "large").option("--safe-search", "Enable safe search (default: true)", true).option("--no-safe-search", "Disable safe search").option("-f, --format <format>", "Output format: human, json, quiet", "human").action(async (options) => {
@@ -4937,9 +5239,6 @@ var searchCommand = new Command18("search").description("Search for images").req
 var imageCommand = new Command18("image").description("Image search commands").addCommand(searchCommand);
 
 // src/commands/video.ts
-init_api();
-init_output();
-init_types();
 import { Command as Command19 } from "commander";
 import ora12 from "ora";
 import { mkdir, writeFile as writeFile5, readFile as readFile2, access, rm, cp } from "fs/promises";
@@ -5686,7 +5985,7 @@ var thumbnailCommand = new Command19("thumbnail").description("Embed a thumbnail
 var videoCommand = new Command19("video").description("Video asset generation commands").addCommand(initCommand).addCommand(createCommand2).addCommand(searchCommand2).addCommand(thumbnailCommand);
 
 // src/index.ts
-var VERSION = "0.1.8";
+var VERSION = "0.1.10";
 var program = new Command20();
 var cmdName = brand.commands[0];
 program.name(cmdName).description(brand.description).version(VERSION, "-v, --version", "Show version number").option("--debug", "Enable debug logging").option("--no-color", "Disable colored output").configureOutput({