@hasna/skills 0.1.37 → 0.1.39

package/skills/deploy/package.json

@@ -3,13 +3,13 @@
   "version": "1.0.0",
   "description": "Deployment CLI for managing EC2 deployments with automated health checks",
   "type": "module",
-  "main": "src/index.ts",
+  "main": "src/index-local.ts",
   "bin": {
     "deploy": "src/index-local.ts"
   },
   "scripts": {
-    "start": "bun run src/index.ts",
-    "dev": "bun run --watch src/index.ts"
+    "start": "bun run src/index-local.ts",
+    "dev": "bun run --watch src/index-local.ts"
   },
   "dependencies": {},
   "devDependencies": {

package/skills/deploy/src/http-client.ts

@@ -5,7 +5,7 @@
  * Usage: import and call executeSkill() from your skill CLI
  */
 
-const SKILL_API_URL = process.env.SKILL_API_URL || "http://localhost:3000";
+const SKILL_API_URL = process.env.SKILLS_API_URL || process.env.SKILL_API_URL || "https://skills.md/api/v1";
 
 export interface SkillRequest {
   skill: string;
@@ -33,12 +33,12 @@ export async function executeSkill(request: SkillRequest): Promise<SkillResponse
   const url = `${SKILL_API_URL}/${skill}/`;
 
   // Get API key from environment
-  const apiKey = process.env.SKILL_API_KEY;
+  const apiKey = process.env.SKILLS_API_KEY || process.env.SKILL_API_KEY;
   if (!apiKey) {
     return {
       success: false,
-      error: "Missing SKILL_API_KEY",
-      details: "Set SKILL_API_KEY environment variable"
+      error: "Missing SKILLS_API_KEY",
+      details: "Set SKILLS_API_KEY environment variable or run `skills auth login`"
     };
   }
 

package/skills/deploy/src/index-local.ts

@@ -13,7 +13,7 @@ const SKILL_META = {
   description: 'Deployment CLI for managing EC2 deployments with automated health checks',
   version: '1.0.0',
   commands: `Use: deploy --help`,
-  requiredEnvVars: ['SKILL_API_KEY'],
+  requiredEnvVars: [],
 };
 
 if (await handleInstallCommand(SKILL_META, process.argv.slice(2))) {
@@ -38,6 +38,7 @@ function parseArgs(): {
   parallel?: boolean;
 } {
   const args = process.argv.slice(2);
+  if (args[0] === '--help' || args[0] === '-h') args[0] = 'help';
   const parsed: Record<string, any> = {
     command: args[0] || 'help',
     hosts: [],

package/skills/deploy/src/index.ts

@@ -1,111 +1,4 @@
 #!/usr/bin/env bun
 
-/**
- * Skill Deploy (HTTP Client)
- * Calls the remote skill API server 
- */
-
-import { executeAndSave, executeSkill } from './http-client';
-import { handleInstallCommand } from '../../_common';
-
-// Skill metadata for install command
-const SKILL_META = {
-  name: 'deploy',
-  description: 'Deploy skill - calls remote API',
-  version: '1.0.0',
-  commands: `deploy <command> [options]`,
-  requiredEnvVars: ['SKILL_API_KEY'],
-};
-
-// Handle install/uninstall commands
-if (await handleInstallCommand(SKILL_META, process.argv.slice(2))) {
-  process.exit(0);
-}
-
-// Parse command line arguments
-function parseArgs(): Record<string, string | boolean> {
-  const args = process.argv.slice(2);
-  const parsed: Record<string, string | boolean> = {};
-
-  for (let i = 0; i < args.length; i++) {
-    if (args[i].startsWith('--')) {
-      const key = args[i].slice(2);
-      const value = args[i + 1];
-      if (value && !value.startsWith('--')) {
-        parsed[key] = value;
-        i++;
-      } else {
-        parsed[key] = true;
-      }
-    } else if (!parsed.command) {
-      parsed.command = args[i];
-    }
-  }
-
-  return parsed;
-}
-
-// Main logic
-async function main() {
-  const args = parseArgs();
-  const command = (args.command as string) || 'help';
-
-  if (command === 'help' || args.help) {
-    console.log(`Skill Deploy CLI
-
-USAGE:
-  deploy <command> [options]
-
-COMMANDS:
-  Call with any command and it will be forwarded to the remote API server
-
-EXAMPLES:
-  deploy generate --provider <provider> [options]`);
-    return;
-  }
-
-  // Extract all parameters
-  const { command: cmd, ...params } = args;
-
-  // Check if output file is expected (for file-generating skills)
-  const fileSkills = ['audio', 'image', 'video', 'emoji'];
-  const isFileSkill = fileSkills.includes('deploy');
-
-  if (isFileSkill && params.output) {
-    // Skill that generates files
-    const success = await executeAndSave({
-      skill: 'deploy',
-      command: cmd,
-      ...params,
-    });
-    process.exit(success ? 0 : 1);
-  } else {
-    // Skill that returns JSON/text
-    const result = await executeSkill({
-      skill: 'deploy',
-      command: cmd,
-      ...params,
-    });
-
-    if (result instanceof Blob) {
-      console.error('❌ Unexpected binary response');
-      process.exit(1);
-    }
-
-    if (result.success && result.output) {
-      console.log(result.output);
-    } else {
-      console.error(`❌ Error: ${result.error}`);
-      if (result.details) {
-        console.error(`   ${result.details}`);
-      }
-      process.exit(1);
-    }
-  }
-}
-
-// Run main
-main().catch((error) => {
-  console.error('❌ Fatal error:', error.message);
-  process.exit(1);
-});
+// Keep the package root on the local implementation; hosted execution goes through the root Skills CLI.
+import "./index-local";

package/skills/extract/package.json

@@ -2,14 +2,14 @@
   "name": "extract",
   "version": "1.0.0",
   "description": "Extract text and structured data from images and PDFs using OpenAI Vision",
-  "main": "src/index.ts",
+  "main": "src/index-local.ts",
   "type": "module",
   "bin": {
-    "extract": "src/index.ts"
+    "extract": "src/index-local.ts"
   },
   "scripts": {
-    "start": "bun run src/index.ts",
-    "extract": "bun run src/index.ts extract"
+    "start": "bun run src/index-local.ts",
+    "extract": "bun run src/index-local.ts extract"
   },
   "keywords": [
     "extraction",

package/skills/extract/src/index-local.ts

@@ -13,7 +13,7 @@ const SKILL_META = {
   description: 'Extract text and structured data from images and PDFs using OpenAI Vision',
   version: '1.0.0',
   commands: `Use: extract --help`,
-  requiredEnvVars: ['SKILL_API_KEY'],
+  requiredEnvVars: [],
 };
 
 if (await handleInstallCommand(SKILL_META, process.argv.slice(2))) {
@@ -36,6 +36,7 @@ function parseArgs(): {
   detail?: 'low' | 'high' | 'auto';
 } {
   const args = process.argv.slice(2);
+  if (args[0] === '--help' || args[0] === '-h') args[0] = 'help';
   const parsed: any = { command: args[0] || 'help' };
 
   for (let i = 1; i < args.length; i++) {

package/skills/extract/src/index.ts

@@ -1,110 +1,4 @@
 #!/usr/bin/env bun
 
-/**
- * Skill Extract (HTTP Client)
- * Calls the remote skill API server 
- */
-
-import { executeAndSave, executeSkill, handleInstallCommand } from '../../_common';
-
-// Skill metadata for install command
-const SKILL_META = {
-  name: 'extract',
-  description: 'Extract skill - calls remote API',
-  version: '1.0.0',
-  commands: `extract <command> [options]`,
-  requiredEnvVars: ['SKILL_API_KEY'],
-};
-
-// Handle install/uninstall commands
-if (await handleInstallCommand(SKILL_META, process.argv.slice(2))) {
-  process.exit(0);
-}
-
-// Parse command line arguments
-function parseArgs(): Record<string, string | boolean> {
-  const args = process.argv.slice(2);
-  const parsed: Record<string, string | boolean> = {};
-
-  for (let i = 0; i < args.length; i++) {
-    if (args[i].startsWith('--')) {
-      const key = args[i].slice(2);
-      const value = args[i + 1];
-      if (value && !value.startsWith('--')) {
-        parsed[key] = value;
-        i++;
-      } else {
-        parsed[key] = true;
-      }
-    } else if (!parsed.command) {
-      parsed.command = args[i];
-    }
-  }
-
-  return parsed;
-}
-
-// Main logic
-async function main() {
-  const args = parseArgs();
-  const command = (args.command as string) || 'help';
-
-  if (command === 'help' || args.help) {
-    console.log(`Skill Extract CLI
-
-USAGE:
-  extract <command> [options]
-
-COMMANDS:
-  Call with any command and it will be forwarded to the remote API server
-
-EXAMPLES:
-  extract generate --provider <provider> [options]`);
-    return;
-  }
-
-  // Extract all parameters
-  const { command: cmd, ...params } = args;
-
-  // Check if output file is expected (for file-generating skills)
-  const fileSkills = ['audio', 'image', 'video', 'emoji'];
-  const isFileSkill = fileSkills.includes('extract');
-
-  if (isFileSkill && params.output) {
-    // Skill that generates files
-    const success = await executeAndSave({
-      skill: 'extract',
-      command: cmd,
-      ...params,
-    });
-    process.exit(success ? 0 : 1);
-  } else {
-    // Skill that returns JSON/text
-    const result = await executeSkill({
-      skill: 'extract',
-      command: cmd,
-      ...params,
-    });
-
-    if (result instanceof Blob) {
-      console.error('❌ Unexpected binary response');
-      process.exit(1);
-    }
-
-    if (result.success && result.output) {
-      console.log(result.output);
-    } else {
-      console.error(`❌ Error: ${result.error}`);
-      if (result.details) {
-        console.error(`   ${result.details}`);
-      }
-      process.exit(1);
-    }
-  }
-}
-
-// Run main
-main().catch((error) => {
-  console.error('❌ Fatal error:', error.message);
-  process.exit(1);
-});
+// Keep the package root on the local implementation; hosted execution goes through the root Skills CLI.
+import "./index-local";

package/skills/image/SKILL.md

@@ -7,7 +7,7 @@ description: Generate images using OpenAI, Minimax, or Gemini through the hosted
 
 Generate high-quality images from text prompts using provider-backed image models.
 
-This CLI is API-backed. Set `SKILL_API_KEY` when routing through the hosted Skills runtime; provider-specific keys are managed by that runtime and billed at the selected provider/model cost.
+This CLI is API-backed. Set `SKILLS_API_KEY` when routing through the hosted Skills runtime; provider-specific keys are managed by that runtime and billed at the selected provider/model cost.
 
 ## Supported Providers
 
@@ -46,4 +46,4 @@ image generate --provider gemini --model imagen-4.0-fast-generate-001 --prompt "
 
 ## Environment Variables
 
-Set `SKILL_API_KEY` for hosted runtime execution.
+Set `SKILLS_API_KEY` for hosted runtime execution.

package/skills/music/SKILL.md

@@ -30,4 +30,4 @@ music generate --provider gemini --model lyria-3-clip-preview --prompt "30 secon
 
 ## Environment
 
-- `SKILL_API_KEY`: required for hosted runtime execution
+- `SKILLS_API_KEY`: required for hosted runtime execution

package/skills/transcript/SKILL.md

@@ -7,7 +7,7 @@ description: Transcribe audio and video files using ElevenLabs Scribe, OpenAI Wh
 
 This skill provides high-quality speech-to-text transcription using multiple AI providers. It automatically handles large files through compression and chunking.
 
-This CLI is API-backed. Set `SKILL_API_KEY` when routing through the hosted skills/connectors runtime; provider-specific keys are managed by that runtime.
+This CLI is API-backed. Set `SKILLS_API_KEY` when routing through the hosted skills/connectors runtime; provider-specific keys are managed by that runtime.
 
 ## Supported Providers
 
@@ -85,7 +85,7 @@ The skill automatically handles files larger than provider limits:
 ## Configuration
 
 ```bash
-export SKILL_API_KEY=your_skill_api_key
+export SKILLS_API_KEY=your_skill_api_key
 ```
 
 ## Dependencies

package/skills/video/SKILL.md

@@ -34,4 +34,4 @@ video generate --provider gemini --model veo-3.1-fast-generate-preview --prompt
 
 ## Environment
 
-- `SKILL_API_KEY`: required for hosted runtime execution
+- `SKILLS_API_KEY`: required for hosted runtime execution

package/skills/write/SKILL.md

@@ -7,7 +7,7 @@ description: Generate high-quality articles using parallel AI agents. Supports r
 
 This skill spawns parallel AI agents to research and write articles on any topic. Each article goes through a multi-phase pipeline:
 
-This CLI is API-backed. Set `SKILL_API_KEY` when routing through the hosted skills/connectors runtime; provider-specific keys are managed by that runtime.
+This CLI is API-backed. Set `SKILLS_API_KEY` when routing through the hosted skills/connectors runtime; provider-specific keys are managed by that runtime.
 
 1. **Research Agent** - Gathers information and key points about the topic
 2. **Writer Agent** - Creates a well-structured article based on the research
@@ -50,7 +50,7 @@ bun run src/index.ts batch \
 Set the hosted runtime API key:
 
 ```bash
-export SKILL_API_KEY=your_skill_api_key
+export SKILLS_API_KEY=your_skill_api_key
 ```
 
 ## Output Format

package/skills/write/package.json

@@ -3,13 +3,13 @@
   "version": "1.0.0",
   "description": "Article writing skill that spawns parallel AI agents to research and write articles with image generation",
   "type": "module",
-  "main": "src/index.ts",
+  "main": "src/index-local.ts",
   "bin": {
-    "write": "src/index.ts"
+    "write": "src/index-local.ts"
   },
   "scripts": {
-    "start": "bun run src/index.ts",
-    "dev": "bun run --watch src/index.ts"
+    "start": "bun run src/index-local.ts",
+    "dev": "bun run --watch src/index-local.ts"
   },
   "keywords": [
     "article",

package/skills/write/src/index-local.ts

@@ -13,7 +13,7 @@ const SKILL_META = {
   description: 'Article writing skill that spawns parallel AI agents to research and write articles with image generation',
   version: '1.0.0',
   commands: `Use: write --help`,
-  requiredEnvVars: ['SKILL_API_KEY'],
+  requiredEnvVars: [],
 };
 
 if (await handleInstallCommand(SKILL_META, process.argv.slice(2))) {
@@ -36,6 +36,7 @@ function parseArgs(): {
   filename?: string;
 } {
   const args = process.argv.slice(2);
+  if (args[0] === '--help' || args[0] === '-h') args[0] = 'help';
   const parsed: any = { command: args[0] || 'help' };
 
   for (let i = 1; i < args.length; i++) {

package/skills/write/src/index.ts

@@ -1,110 +1,4 @@
 #!/usr/bin/env bun
 
-/**
- * Skill Write (HTTP Client)
- * Calls the remote skill API server 
- */
-
-import { executeAndSave, executeSkill, handleInstallCommand } from '../../_common';
-
-// Skill metadata for install command
-const SKILL_META = {
-  name: 'write',
-  description: 'Write skill - calls remote API',
-  version: '1.0.0',
-  commands: `write <command> [options]`,
-  requiredEnvVars: ['SKILL_API_KEY'],
-};
-
-// Handle install/uninstall commands
-if (await handleInstallCommand(SKILL_META, process.argv.slice(2))) {
-  process.exit(0);
-}
-
-// Parse command line arguments
-function parseArgs(): Record<string, string | boolean> {
-  const args = process.argv.slice(2);
-  const parsed: Record<string, string | boolean> = {};
-
-  for (let i = 0; i < args.length; i++) {
-    if (args[i].startsWith('--')) {
-      const key = args[i].slice(2);
-      const value = args[i + 1];
-      if (value && !value.startsWith('--')) {
-        parsed[key] = value;
-        i++;
-      } else {
-        parsed[key] = true;
-      }
-    } else if (!parsed.command) {
-      parsed.command = args[i];
-    }
-  }
-
-  return parsed;
-}
-
-// Main logic
-async function main() {
-  const args = parseArgs();
-  const command = (args.command as string) || 'help';
-
-  if (command === 'help' || args.help) {
-    console.log(`Skill Write CLI
-
-USAGE:
-  write <command> [options]
-
-COMMANDS:
-  Call with any command and it will be forwarded to the remote API server
-
-EXAMPLES:
-  write generate --provider <provider> [options]`);
-    return;
-  }
-
-  // Extract all parameters
-  const { command: cmd, ...params } = args;
-
-  // Check if output file is expected (for file-generating skills)
-  const fileSkills = ['audio', 'image', 'video', 'emoji'];
-  const isFileSkill = fileSkills.includes('write');
-
-  if (isFileSkill && params.output) {
-    // Skill that generates files
-    const success = await executeAndSave({
-      skill: 'write',
-      command: cmd,
-      ...params,
-    });
-    process.exit(success ? 0 : 1);
-  } else {
-    // Skill that returns JSON/text
-    const result = await executeSkill({
-      skill: 'write',
-      command: cmd,
-      ...params,
-    });
-
-    if (result instanceof Blob) {
-      console.error('❌ Unexpected binary response');
-      process.exit(1);
-    }
-
-    if (result.success && result.output) {
-      console.log(result.output);
-    } else {
-      console.error(`❌ Error: ${result.error}`);
-      if (result.details) {
-        console.error(`   ${result.details}`);
-      }
-      process.exit(1);
-    }
-  }
-}
-
-// Run main
-main().catch((error) => {
-  console.error('❌ Fatal error:', error.message);
-  process.exit(1);
-});
+// Keep the package root on the local implementation; hosted execution goes through the root Skills CLI.
+import "./index-local";