vtrix-skills 1.0.0

package/README.md

@@ -0,0 +1,114 @@
+# vtrix-skills
+
+CLI tool for discovering and installing agent skills from Vtrix SkillHub.
+
+## Installation
+
+```bash
+npm install -g vtrix-skills
+```
+
+Or use directly with npx:
+
+```bash
+npx vtrix-skills find image
+```
+
+## Quick Start
+
+### Search for skills
+
+```bash
+# Search by keyword
+vtrix-skills find image
+
+# Search within a category
+vtrix-skills find image --category ai-ml
+
+# Interactive mode (browse by category)
+vtrix-skills find -i
+```
+
+### Install a skill
+
+```bash
+# Install to current project (./.agents/skills)
+vtrix-skills add gpt-image-1
+
+# Install globally (~/.claude/skills)
+vtrix-skills add gpt-image-1 -g
+
+# Install specific version
+vtrix-skills add gpt-image-1 --version 1.0.0
+```
+
+### List skills
+
+```bash
+# List all skills (sorted by stars)
+vtrix-skills list
+
+# List by category
+vtrix-skills list --category development
+
+# Sort by downloads
+vtrix-skills list --sort downloads
+```
+
+### Configuration
+
+```bash
+# View current configuration
+vtrix-skills config --show
+
+# Set custom API URL
+vtrix-skills config --set-url https://your-domain.com/api/v1
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `find [query]` | Search for skills by keyword |
+| `find -i` | Browse skills by category (interactive) |
+| `find <query> -c <category>` | Search within a specific category |
+| `add <slug>` | Install a skill |
+| `list` | List all skills |
+| `config --show` | Show current configuration |
+| `config --set-url <url>` | Set API base URL |
+
+## Environment Variables
+
+You can override the default API URL using environment variables:
+
+```bash
+export SKILLHUB_API_URL=https://your-custom-domain.com/api/v1
+vtrix-skills find react
+```
+
+## Examples
+
+```bash
+# Search for image generation skills
+vtrix-skills find image
+
+# Search for React skills in development category
+vtrix-skills find react --category development
+
+# Browse skills by category
+vtrix-skills find -i
+
+# Install a skill globally
+vtrix-skills add gpt-image-1 -g
+
+# List top skills by stars
+vtrix-skills list --sort stars
+```
+
+## License
+
+MIT
+
+## Support
+
+For issues and feature requests, please visit: https://github.com/vtrix/vtrix-skills/issues

package/bin/vtrix-skills.js

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+
+const { spawn } = require('child_process');
+const path = require('path');
+
+const binPath = path.join(__dirname, 'vtrix-skills');
+
+const child = spawn(binPath, process.argv.slice(2), {
+  stdio: 'inherit',
+  windowsHide: true
+});
+
+child.on('exit', (code) => {
+  process.exit(code);
+});

package/install.js

@@ -0,0 +1,88 @@
+#!/usr/bin/env node
+
+const https = require('https');
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+
+const GITHUB_RELEASE_URL = 'https://github.com/vtrix/vtrix-skills/releases/latest/download';
+
+function getPlatform() {
+  const platform = process.platform;
+  const arch = process.arch;
+
+  if (platform === 'darwin') {
+    if (arch === 'x64') return 'macos-x64';
+    if (arch === 'arm64') return 'macos-arm64';
+  } else if (platform === 'linux') {
+    if (arch === 'x64') return 'linux-x64';
+    if (arch === 'arm64') return 'linux-arm64';
+  } else if (platform === 'win32') {
+    if (arch === 'x64') return 'windows-x64';
+  }
+
+  throw new Error(`Unsupported platform: ${platform}-${arch}`);
+}
+
+function downloadBinary() {
+  const platformName = getPlatform();
+  const binaryName = process.platform === 'win32' ? 'vtrix-skills.exe' : 'vtrix-skills';
+  const downloadUrl = `${GITHUB_RELEASE_URL}/vtrix-skills-${platformName}${process.platform === 'win32' ? '.exe' : ''}`;
+  const binDir = path.join(__dirname, 'bin');
+  const binPath = path.join(binDir, binaryName);
+
+  console.log(`Downloading vtrix-skills for ${platformName}...`);
+  console.log(`From: ${downloadUrl}`);
+
+  if (!fs.existsSync(binDir)) {
+    fs.mkdirSync(binDir, { recursive: true });
+  }
+
+  const file = fs.createWriteStream(binPath);
+
+  https.get(downloadUrl, (response) => {
+    if (response.statusCode === 302 || response.statusCode === 301) {
+      // Follow redirect
+      https.get(response.headers.location, (res) => {
+        res.pipe(file);
+        file.on('finish', () => {
+          file.close();
+          fs.chmodSync(binPath, 0o755);
+          console.log('✓ vtrix-skills installed successfully!');
+        });
+      }).on('error', (err) => {
+        fs.unlinkSync(binPath);
+        throw err;
+      });
+    } else if (response.statusCode === 200) {
+      response.pipe(file);
+      file.on('finish', () => {
+        file.close();
+        fs.chmodSync(binPath, 0o755);
+        console.log('✓ vtrix-skills installed successfully!');
+      });
+    } else {
+      throw new Error(`Failed to download: HTTP ${response.statusCode}`);
+    }
+  }).on('error', (err) => {
+    fs.unlinkSync(binPath);
+    console.error('Download failed. Installing local binary...');
+    // Fallback: copy local binary if available
+    const localBinary = path.join(__dirname, '..', 'target', 'release', binaryName);
+    if (fs.existsSync(localBinary)) {
+      fs.copyFileSync(localBinary, binPath);
+      fs.chmodSync(binPath, 0o755);
+      console.log('✓ Local binary installed successfully!');
+    } else {
+      throw new Error('No binary available');
+    }
+  });
+}
+
+try {
+  downloadBinary();
+} catch (error) {
+  console.error('Installation failed:', error.message);
+  console.error('\nPlease install manually from: https://github.com/vtrix/vtrix-skills/releases');
+  process.exit(1);
+}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "vtrix-skills",
+  "version": "1.0.0",
+  "description": "CLI tool for discovering and installing agent skills from Vtrix SkillHub",
+  "keywords": [
+    "vtrix",
+    "skills",
+    "agent",
+    "claude",
+    "ai",
+    "cli"
+  ],
+  "homepage": "https://github.com/vtrix/vtrix-skills",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/vtrix/vtrix-skills.git"
+  },
+  "license": "MIT",
+  "author": "Vtrix Team",
+  "bin": {
+    "vtrix-skills": "./bin/vtrix-skills.js"
+  },
+  "scripts": {
+    "postinstall": "node ./install.js"
+  },
+  "files": [
+    "bin/",
+    "install.js",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ],
+  "cpu": [
+    "x64",
+    "arm64"
+  ]
+}