@hasna/skills 0.1.26 → 0.1.29

package/dist/types/api.d.ts

@@ -8,7 +8,7 @@ export interface SkillResponse {
     description: string;
     category: string;
     tags: string[];
-    installed: boolean;
+    pinned: boolean;
     envVars: string[];
     envVarsSet: string[];
     systemDeps: string[];
@@ -26,7 +26,7 @@ export interface TagResponse {
     name: string;
     count: number;
 }
-export interface InstallResponse {
+export interface PinResponse {
     skill: string;
     success: boolean;
     error?: string;
@@ -36,7 +36,7 @@ export interface InstallResponse {
         error?: string;
     }>;
 }
-export interface RemoveResponse {
+export interface UnpinResponse {
     skill: string;
     success: boolean;
 }
@@ -60,7 +60,7 @@ export interface ImportResponse {
 }
 export interface SearchResponse extends SkillResponse {
 }
-export interface CategoryInstallResponse {
+export interface CategoryPinResponse {
     category: string;
     count: number;
     success: boolean;
@@ -70,6 +70,9 @@ export interface CategoryInstallResponse {
         error?: string;
     }>;
 }
+export type InstallResponse = PinResponse;
+export type RemoveResponse = UnpinResponse;
+export type CategoryInstallResponse = CategoryPinResponse;
 export interface ErrorResponse {
     error: string;
 }

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@hasna/skills",
-  "version": "0.1.26",
+  "version": "0.1.29",
   "description": "Skills library for AI coding agents",
   "type": "module",
   "bin": {
-    "skills": "bin/index.js",
-    "skills-mcp": "bin/mcp.js"
+    "skills": "./bin/index.js",
+    "skills-mcp": "./bin/mcp.js"
   },
   "exports": {
     ".": {
@@ -16,10 +16,13 @@
   "files": [
     "dist/",
     "!dist/**/*.test.d.ts",
+    "!dist/platform",
+    "!dist/server",
     "bin/",
     "skills/",
     "!skills/**/node_modules",
-    "!skills/**/.skills",
+    "!skills/scaffold-project/my-app",
+    "!skills/{ad-creative-pack,api-docs-portal,audio,audio-transcript-pack,blog-article,brand-kit,brand-photo-shoot,browse,contract-review-report,customer-feedback-report,deepresearch,email-sequence,generate-book-cover,icon-pack,image,invoice-reconciliation,landing-page-pack,logo-design,market-research-report,meeting-pack,migration-plan-pack,music,music-album,one-page-website,pdf-read,pdf-to-dataset,pdf-to-markdown,performance-audit-report,photo-album,pitch-deck,playlist-maker,product-mockup,proposal-pack,read-pdf,remove-background,repo-onboarding-report,sdk-generator,security-audit-report,seo-content-pack,short-video-pack,slide-deck-generator,social-content-calendar,test-suite-generator,transcript,video,video-highlight-pack,voiceover-jingle-pack,webcrawling}/src",
     "LICENSE",
     "README.md"
   ],
@@ -33,11 +36,18 @@
     "dev:watch": "bun --watch run ./src/cli/index.tsx",
     "dev:mcp": "bun --watch run ./src/mcp/index.ts",
     "typecheck": "tsc --noEmit",
+    "db:migrate:preview": "bun run scripts/apply_database_migrations.ts",
+    "aws:bootstrap:ecs": "bash scripts/bootstrap_ecs_foundation.sh",
+    "aws:bootstrap:s3": "bash scripts/bootstrap_s3_buckets.sh",
+    "aws:bootstrap:secrets": "bash scripts/bootstrap_secrets.sh",
+    "aws:bootstrap:preview-edge": "bash scripts/bootstrap_preview_edge.sh",
+    "aws:bootstrap:preview-stripe": "bash scripts/preview_bootstrap_stripe.sh",
+    "aws:verify:preview-stripe": "bash scripts/preview_verify_stripe.sh",
+    "aws:bootstrap:production-edge": "bash scripts/bootstrap_production_edge.sh",
+    "aws:bootstrap:production-stripe": "bash scripts/production_bootstrap_stripe.sh",
+    "aws:production:readiness": "bash scripts/production_readiness.sh",
+    "upstream:check": "bash scripts/check_upstream_sync.sh",
     "prepublishOnly": "bun run build",
-    "dashboard:dev": "cd dashboard && bun run dev",
-    "dashboard:build": "cd dashboard && bun install && bun run build",
-    "server": "bun run src/server/serve.ts",
-    "server:dev": "bun --watch run src/server/serve.ts",
     "postinstall": "mkdir -p $HOME/.hasna/skills/custom 2>/dev/null || true"
   },
   "keywords": [
@@ -60,11 +70,11 @@
   "license": "Apache-2.0",
   "devDependencies": {
     "@types/bun": "latest",
-    "@types/react": "^18.2.0",
     "typescript": "^5"
   },
   "dependencies": {
     "@hasna/cloud": "^0.1.24",
+    "@hasna/skills": "0.1.27",
     "@modelcontextprotocol/sdk": "^1.26.0",
     "chalk": "^5.3.0",
     "commander": "^12.1.0",
@@ -72,7 +82,6 @@
     "ink-select-input": "^6.0.0",
     "ink-spinner": "^5.0.0",
     "ink-text-input": "^6.0.0",
-    "react": "^18.2.0",
     "zod": "^4.3.6"
   },
   "engines": {
@@ -85,5 +94,9 @@
   "repository": {
     "type": "git",
     "url": "git+https://github.com/hasna/skills.git"
+  },
+  "homepage": "https://github.com/hasna/skills",
+  "bugs": {
+    "url": "https://github.com/hasna/skills/issues"
   }
 }

package/skills/_common/http-client.ts

@@ -47,7 +47,7 @@ export async function executeSkill(request: SkillRequest): Promise<SkillResponse
       method: "POST",
       headers: {
         "Content-Type": "application/json",
-        "User-Agent": `${skill}-cli/1.0`,
+        "User-Agent": `skill-${skill}-cli/1.0`,
         "X-API-Key": apiKey
       },
       body: JSON.stringify(params)

package/skills/_common/index.ts

@@ -1,9 +1,8 @@
 /**
  * Shared SDK for skills
  *
- * Common utilities used across audio, browse, codefix,
- * convert, deploy, extract, image, transcript,
- * video, and write.
+ * Common utilities used across audio, browse, codefix, convert, deploy,
+ * extract, image, transcript, video, and write.
  */
 
 export { checkSkillAuth, isRemoteExecution, requireAuthIfRemote } from './auth';

package/skills/_common/install.sh

@@ -1,112 +1,7 @@
 #!/usr/bin/env bash
+set -euo pipefail
 
-# Install script for skills
-# Installs the skill either globally for Claude Code or locally in a project
-
-set -e
-
-SKILL_NAME="$(basename "$(pwd)")"
-SKILL_PATH="$(pwd)"
-
-echo "📦 Installing $SKILL_NAME..."
-echo ""
-
-# Check if Claude Code is installed
-if ! command -v claude &> /dev/null; then
-    echo "⚠️  Claude Code not found in PATH"
-    echo "   Please install Claude Code first: https://claude.com/claude-code"
-    exit 1
-fi
-
-# Check if we're in a git repository
-if git rev-parse --git-dir > /dev/null 2>&1; then
-    IN_REPO=true
-    REPO_ROOT="$(git rev-parse --show-toplevel)"
-    echo "📁 Detected git repository: $REPO_ROOT"
-else
-    IN_REPO=false
-    echo "📁 Not in a git repository"
-fi
-
-# Ask installation type
-echo ""
-echo "Where would you like to install this skill?"
-if [ "$IN_REPO" = true ]; then
-    echo "  1) Locally (this repository only)"
-    echo "  2) Globally (all Claude Code sessions)"
-    read -p "Choose [1/2]: " choice
-else
-    echo "  Installing globally (not in a git repository)"
-    choice=2
-fi
-
-# Install function
-install_skill() {
-    local config_dir=$1
-    local config_file="$config_dir/claude_mcp_config.json"
-
-    # Create config directory if it doesn't exist
-    mkdir -p "$config_dir"
-
-    # Create or update config file
-    if [ ! -f "$config_file" ]; then
-        echo "{" > "$config_file"
-        echo '  "mcpServers": {}' >> "$config_file"
-        echo "}" >> "$config_file"
-    fi
-
-    # Add skill to config using bun
-    bun -e "
-    const fs = require('fs');
-    const config = JSON.parse(fs.readFileSync('$config_file', 'utf8'));
-
-    if (!config.mcpServers) config.mcpServers = {};
-
-    config.mcpServers['$SKILL_NAME'] = {
-      command: 'bun',
-      args: ['run', '$SKILL_PATH/src/index.ts'],
-      env: {
-        SKILL_API_KEY: process.env.SKILL_API_KEY || '',
-        ANTHROPIC_API_KEY: process.env.ANTHROPIC_API_KEY || '',
-        OPENAI_API_KEY: process.env.OPENAI_API_KEY || '',
-        ELEVENLABS_API_KEY: process.env.ELEVENLABS_API_KEY || '',
-        GEMINI_API_KEY: process.env.GEMINI_API_KEY || '',
-        XAI_API_KEY: process.env.XAI_API_KEY || '',
-        GOOGLE_API_KEY: process.env.GOOGLE_API_KEY || '',
-        GOOGLE_PROJECT_ID: process.env.GOOGLE_PROJECT_ID || '',
-        BROWSER_USE_API_KEY: process.env.BROWSER_USE_API_KEY || '',
-        RUNWAY_API_KEY: process.env.RUNWAY_API_KEY || ''
-      }
-    };
-
-    fs.writeFileSync('$config_file', JSON.stringify(config, null, 2));
-    "
-
-    echo "✅ Installed $SKILL_NAME to $config_file"
-}
-
-# Install based on choice
-if [ "$choice" = "1" ]; then
-    # Local installation
-    install_skill "$REPO_ROOT/.claude"
-    echo ""
-    echo "🎉 $SKILL_NAME installed locally!"
-    echo "   Config: $REPO_ROOT/.claude/claude_mcp_config.json"
-elif [ "$choice" = "2" ]; then
-    # Global installation
-    install_skill "$HOME/.config/claude-code"
-    echo ""
-    echo "🎉 $SKILL_NAME installed globally!"
-    echo "   Config: $HOME/.config/claude-code/claude_mcp_config.json"
-else
-    echo "❌ Invalid choice"
-    exit 1
-fi
-
-echo ""
-echo "📝 Next steps:"
-echo "   1. Restart Claude Code"
-echo "   2. The skill will be available as: $SKILL_NAME"
-echo ""
-echo "   Usage: Claude Code will automatically detect and use this skill"
-echo "          based on your prompts and task context."
+echo "Direct per-skill installers are disabled."
+echo "Register the shared Skills MCP server instead:"
+echo "  skills mcp --register all"
+exit 1

package/skills/_common/installer.ts

@@ -1,16 +1,13 @@
 #!/usr/bin/env bun
 
 /**
- * Skill Installer Module
+ * Legacy per-skill installer boundary.
  *
- * Universal installer for skills to integrate with AI code assistants
- * Usage: skills run [name] -- install [claude|codex|windsurf|cursor]
+ * Agent-native skill folders are intentionally unmanaged. Skills are exposed
+ * through the root Skills CLI/MCP server so local agents discover the catalog
+ * without receiving copied source, package files, or SKILL.md files.
  */
 
-import { writeFileSync, mkdirSync, existsSync, readFileSync } from 'fs';
-import { resolve, join } from 'path';
-import { homedir } from 'os';
-
 export interface SkillConfig {
   name: string;
   description: string;
@@ -25,300 +22,52 @@ export interface SkillConfig {
   optionalEnvVars?: string[];
 }
 
-export type AssistantType = 'claude' | 'codex' | 'windsurf' | 'cursor';
-
-const ASSISTANT_PATHS: Record<AssistantType, string> = {
-  claude: '.claude/skills',
-  codex: '.codex/skills',
-  windsurf: '.windsurf/skills',
-  cursor: '.cursor/skills',
-};
+export type AssistantType = "claude" | "codex" | "windsurf" | "cursor";
 
 export class SkillInstaller {
   private config: SkillConfig;
-  private skillPath: string;
 
-  constructor(config: SkillConfig, currentFilePath: string) {
+  constructor(config: SkillConfig, _currentFilePath: string) {
     this.config = config;
-    // Get the root directory of the skill (where package.json is)
-    this.skillPath = resolve(currentFilePath, '..');
   }
 
-  /**
-   * Install the skill to specified AI assistant
-   */
   async install(assistant: AssistantType): Promise<void> {
-    console.log(`📦 Installing ${this.config.name} for ${assistant}...`);
-    console.log('');
-
-    const assistantPath = ASSISTANT_PATHS[assistant];
-    if (!assistantPath) {
-      throw new Error(`Unknown assistant: ${assistant}`);
-    }
-
-    // Create skill directory
-    const skillDir = join(homedir(), assistantPath, this.config.name);
-    mkdirSync(skillDir, { recursive: true });
-    console.log(`✓ Created: ${skillDir}`);
-
-    // Generate and write SKILL.md
-    const skillMd = this.generateSkillMd();
-    writeFileSync(join(skillDir, 'SKILL.md'), skillMd);
-    console.log(`✓ Created: SKILL.md`);
-
-    // Generate and write README.md
-    const readme = this.generateReadme();
-    writeFileSync(join(skillDir, 'README.md'), readme);
-    console.log(`✓ Created: README.md`);
-
-    // Create log file
-    const logFile = join(skillDir, `${this.config.name}.log`);
-    if (!existsSync(logFile)) {
-      writeFileSync(logFile, `# ${this.config.name} execution log\n# Created: ${new Date().toISOString()}\n\n`);
-      console.log(`✓ Created: ${this.config.name}.log`);
-    }
-
-    // Update MCP config
-    this.updateMcpConfig(assistant, skillDir);
-
-    console.log('');
-    console.log(`✅ ${this.config.name} installed successfully!`);
-    console.log('');
-    console.log('Location:', skillDir);
-    console.log('');
-    console.log('Usage:');
-    this.config.commands.slice(0, 3).forEach(cmd => {
-      console.log(`  ${this.config.name} ${cmd.usage}`);
-    });
-  }
-
-  /**
-   * Generate SKILL.md documentation
-   */
-  private generateSkillMd(): string {
-    const envVarsSection = this.config.requiredEnvVars?.length || this.config.optionalEnvVars?.length ? `
-
-## Environment Variables
-
-${this.config.requiredEnvVars?.length ? `### Required
-${this.config.requiredEnvVars.map(v => `- \`${v}\``).join('\n')}
-` : ''}
-${this.config.optionalEnvVars?.length ? `### Optional
-${this.config.optionalEnvVars.map(v => `- \`${v}\``).join('\n')}
-` : ''}` : '';
-
-    return `# ${this.config.name}
-
-${this.config.description}
-
-## Version
-${this.config.version}
-
-## Commands
-
-${this.config.commands.map(cmd => `### ${cmd.name}
-
-${cmd.description}
-
-**Usage:**
-\`\`\`bash
-${this.config.name} ${cmd.usage}
-\`\`\`
-
-**Examples:**
-${cmd.examples.map(ex => `\`\`\`bash
-${ex}
-\`\`\``).join('\n')}
-`).join('\n')}
-${envVarsSection}
-
-## Installation
-
-This skill is installed at:
-\`~/.claude/skills/${this.config.name}/\`
-
-## Logs
-
-Execution logs are written to:
-\`~/.claude/skills/${this.config.name}/${this.config.name}.log\`
-
-## Support
-
-For issues, visit: https://github.com/hasnaxyz/${this.config.name}/issues
-`;
-  }
-
-  /**
-   * Generate README.md
-   */
-  private generateReadme(): string {
-    return `# ${this.config.name}
-
-${this.config.description}
-
-## Quick Start
-
-\`\`\`bash
-${this.config.commands[0] ? `${this.config.name} ${this.config.commands[0].usage}` : `${this.config.name} --help`}
-\`\`\`
-
-## Documentation
-
-See [SKILL.md](./SKILL.md) for complete documentation.
-
-## Version
-
-${this.config.version}
-`;
+    throw new Error(registrationMessage(this.config.name, assistant));
   }
 
-  /**
-   * Update MCP config to register the skill
-   */
-  private updateMcpConfig(assistant: AssistantType, skillDir: string): void {
-    const configPaths: Record<AssistantType, string> = {
-      claude: join(homedir(), '.config/claude-code/claude_mcp_config.json'),
-      codex: join(homedir(), '.config/codex/mcp_config.json'),
-      windsurf: join(homedir(), '.config/windsurf/mcp_config.json'),
-      cursor: join(homedir(), '.config/cursor/mcp_config.json'),
-    };
-
-    const configPath = configPaths[assistant];
-
-    // Read existing config or create new
-    let config: any = { mcpServers: {} };
-    if (existsSync(configPath)) {
-      const content = readFileSync(configPath, 'utf8');
-      config = JSON.parse(content);
-    }
-
-    if (!config.mcpServers) {
-      config.mcpServers = {};
-    }
-
-    // Add or update this skill
-    config.mcpServers[this.config.name] = {
-      command: 'bun',
-      args: ['run', join(this.skillPath, 'src/index.ts')],
-      env: this.getEnvConfig(),
-    };
-
-    // Write config
-    mkdirSync(resolve(configPath, '..'), { recursive: true });
-    writeFileSync(configPath, JSON.stringify(config, null, 2));
-    console.log(`✓ Updated: ${assistant} MCP config`);
-  }
-
-  /**
-   * Get environment variables config
-   */
-  private getEnvConfig(): Record<string, string> {
-    const env: Record<string, string> = {
-      SKILL_API_KEY: process.env.SKILL_API_KEY || '',
-    };
-
-    // Add required env vars
-    this.config.requiredEnvVars?.forEach(key => {
-      env[key] = process.env[key] || '';
-    });
-
-    // Add optional env vars
-    this.config.optionalEnvVars?.forEach(key => {
-      env[key] = process.env[key] || '';
-    });
-
-    return env;
-  }
-
-  /**
-   * Uninstall the skill from specified AI assistant
-   */
   async uninstall(assistant: AssistantType): Promise<void> {
-    console.log(`🗑️  Uninstalling ${this.config.name} from ${assistant}...`);
-    console.log('');
-
-    const assistantPath = ASSISTANT_PATHS[assistant];
-    const skillDir = join(homedir(), assistantPath, this.config.name);
-
-    if (existsSync(skillDir)) {
-      // Remove from MCP config first
-      this.removeFromMcpConfig(assistant);
-
-      // Note: We don't delete the directory to preserve logs and user data
-      console.log(`✓ Removed from ${assistant} MCP config`);
-      console.log('');
-      console.log(`⚠️  Directory preserved: ${skillDir}`);
-      console.log('   (contains logs and configuration)');
-      console.log('   Delete manually if needed.');
-    } else {
-      console.log(`⚠️  ${this.config.name} is not installed for ${assistant}`);
-    }
-  }
-
-  /**
-   * Remove skill from MCP config
-   */
-  private removeFromMcpConfig(assistant: AssistantType): void {
-    const configPaths: Record<AssistantType, string> = {
-      claude: join(homedir(), '.config/claude-code/claude_mcp_config.json'),
-      codex: join(homedir(), '.config/codex/mcp_config.json'),
-      windsurf: join(homedir(), '.config/windsurf/mcp_config.json'),
-      cursor: join(homedir(), '.config/cursor/mcp_config.json'),
-    };
-
-    const configPath = configPaths[assistant];
-
-    if (existsSync(configPath)) {
-      const content = readFileSync(configPath, 'utf8');
-      const config = JSON.parse(content);
-
-      if (config.mcpServers && config.mcpServers[this.config.name]) {
-        delete config.mcpServers[this.config.name];
-        writeFileSync(configPath, JSON.stringify(config, null, 2));
-      }
-    }
+    throw new Error(
+      `Direct agent skill-folder uninstalls are disabled for ${this.config.name}. ` +
+        `Skills MCP owns discovery; update MCP registration with: skills mcp --register ${assistant}`,
+    );
   }
 }
 
-/**
- * Helper to run installer from skill CLI
- */
 export async function runInstaller(
   config: SkillConfig,
   currentFilePath: string,
-  args: string[]
-): Promise<void> {
-  const installer = new SkillInstaller(config, currentFilePath);
-
+  args: string[] = process.argv.slice(2),
+): Promise<boolean> {
   const command = args[0];
-  const assistant = args[1] as AssistantType;
-
-  if (command === 'install') {
-    if (!assistant || !['claude', 'codex', 'windsurf', 'cursor'].includes(assistant)) {
-      console.error('❌ Error: Please specify an assistant');
-      console.error('');
-      console.error('Usage:');
-      console.error(`  ${config.name} install [claude|codex|windsurf|cursor]`);
-      console.error('');
-      console.error('Examples:');
-      console.error(`  ${config.name} install claude`);
-      console.error(`  ${config.name} install codex`);
-      process.exit(1);
-    }
-
-    await installer.install(assistant);
-  } else if (command === 'uninstall') {
-    if (!assistant || !['claude', 'codex', 'windsurf', 'cursor'].includes(assistant)) {
-      console.error('❌ Error: Please specify an assistant');
-      console.error('');
-      console.error('Usage:');
-      console.error(`  ${config.name} uninstall [claude|codex|windsurf|cursor]`);
-      process.exit(1);
-    }
+  if (command !== "install" && command !== "uninstall") {
+    return false;
+  }
 
-    await installer.uninstall(assistant);
+  const assistant = args.find((arg): arg is AssistantType =>
+    ["claude", "codex", "windsurf", "cursor"].includes(arg),
+  );
+  const installer = new SkillInstaller(config, currentFilePath);
+  if (command === "install") {
+    await installer.install(assistant ?? "claude");
   } else {
-    console.error(`❌ Unknown installer command: ${command}`);
-    process.exit(1);
+    await installer.uninstall(assistant ?? "claude");
   }
+  return true;
+}
+
+function registrationMessage(skillName: string, assistant: AssistantType): string {
+  return (
+    `Direct agent skill-folder installs are disabled for ${skillName}. ` +
+    `Register the Skills MCP server instead: skills mcp --register ${assistant}`
+  );
 }