@hasna/skills 0.1.26 → 0.1.29

package/skills/_common/skill-install.ts

@@ -1,21 +1,15 @@
 /**
- * Skill Installation Handler
+ * Legacy install command boundary for bundled skill packages.
  *
- * Add this code to your skill's index.ts to enable:
- *   skills install [name] --for claude
- *   skills install [name] --for codex
- *   skills remove [name] --for claude
+ * Per-skill packages must not write into agent-native skill directories.
+ * Discovery and execution go through the root Skills CLI/MCP server.
  */
 
-import { writeFileSync, mkdirSync, existsSync } from 'fs';
-import { join } from 'path';
-import { homedir } from 'os';
-
 interface SkillMeta {
   name: string;
   description: string;
   version: string;
-  commands: string; // Help text or command list
+  commands: string;
   requiredEnvVars?: string[];
 }
 
@@ -23,182 +17,21 @@ export async function handleInstallCommand(meta: SkillMeta, args: string[]): Pro
   const command = args[0];
   const assistant = args[1];
 
-  if (command !== 'install' && command !== 'uninstall') {
-    return false; // Not an install command
+  if (command !== "install" && command !== "uninstall") {
+    return false;
   }
 
-  if (!assistant || !['claude', 'codex', 'windsurf', 'cursor'].includes(assistant)) {
-    console.error('❌ Error: Please specify an assistant');
-    console.error('');
-    console.error('Usage:');
-    console.error(`  ${meta.name} install [claude|codex|windsurf|cursor]`);
-    console.error(`  ${meta.name} uninstall [claude|codex|windsurf|cursor]`);
-    console.error('');
-    console.error('Examples:');
-    console.error(`  ${meta.name} install claude`);
-    console.error(`  ${meta.name} install codex`);
+  if (!assistant || !["claude", "codex", "windsurf", "cursor"].includes(assistant)) {
+    console.error("Direct per-skill installs are disabled.");
+    console.error("Use: skills mcp --register <claude|codex|windsurf|cursor|all>");
     process.exit(1);
   }
 
-  if (command === 'install') {
-    await installSkill(meta, assistant);
-  } else {
-    await uninstallSkill(meta, assistant);
-  }
-
-  return true;
-}
-
-async function installSkill(meta: SkillMeta, assistant: string): Promise<void> {
-  console.log(`📦 Installing ${meta.name} for ${assistant}...`);
-  console.log('');
-
-  const assistantPaths: Record<string, string> = {
-    claude: '.claude/skills',
-    codex: '.codex/skills',
-    windsurf: '.windsurf/skills',
-    cursor: '.cursor/skills',
-  };
-
-  const skillDir = join(homedir(), assistantPaths[assistant], meta.name);
-  mkdirSync(skillDir, { recursive: true });
-  console.log(`✓ Created: ${skillDir}`);
-
-  // Generate SKILL.md
-  const skillMd = generateSkillMd(meta);
-  writeFileSync(join(skillDir, 'SKILL.md'), skillMd);
-  console.log(`✓ Created: SKILL.md`);
-
-  // Generate README.md
-  const readme = generateReadme(meta);
-  writeFileSync(join(skillDir, 'README.md'), readme);
-  console.log(`✓ Created: README.md`);
-
-  // Create log file
-  const logFile = join(skillDir, `${meta.name}.log`);
-  if (!existsSync(logFile)) {
-    writeFileSync(logFile, `# ${meta.name} execution log\n# Created: ${new Date().toISOString()}\n\n`);
-    console.log(`✓ Created: ${meta.name}.log`);
-  }
-
-  console.log('');
-  console.log(`✅ ${meta.name} installed successfully!`);
-  console.log('');
-  console.log('Location:', skillDir);
-  console.log('');
-  console.log('Files created:');
-  console.log('  - SKILL.md (documentation)');
-  console.log('  - README.md (quick reference)');
-  console.log(`  - ${meta.name}.log (execution logs)`);
-}
-
-async function uninstallSkill(meta: SkillMeta, assistant: string): Promise<void> {
-  console.log(`🗑️  Uninstalling ${meta.name} from ${assistant}...`);
-  console.log('');
-
-  const assistantPaths: Record<string, string> = {
-    claude: '.claude/skills',
-    codex: '.codex/skills',
-    windsurf: '.windsurf/skills',
-    cursor: '.cursor/skills',
-  };
-
-  const skillDir = join(homedir(), assistantPaths[assistant], meta.name);
-
-  if (existsSync(skillDir)) {
-    console.log(`⚠️  Directory preserved: ${skillDir}`);
-    console.log('   (contains logs and configuration)');
-    console.log('   Delete manually if needed:');
-    console.log(`   rm -rf ${skillDir}`);
+  if (command === "install") {
+    console.error(`Direct installs for ${meta.name} are disabled.`);
   } else {
-    console.log(`✓ ${meta.name} is not installed for ${assistant}`);
+    console.error(`Direct uninstalls for ${meta.name} are disabled.`);
   }
-}
-
-function generateSkillMd(meta: SkillMeta): string {
-  const skillType = meta.name;
-
-  // Create gerund form for description trigger (e.g., "audio" -> "generating audio")
-  const gerundForms: Record<string, string> = {
-    audio: 'generating audio',
-    image: 'generating images',
-    video: 'generating videos',
-    browse: 'browsing websites',
-    codefix: 'fixing code',
-    convert: 'converting files',
-    deploy: 'deploying applications',
-    emoji: 'generating emojis',
-    extract: 'extracting data',
-    transcript: 'transcribing audio',
-    transform: 'transforming data',
-    write: 'writing content',
-  };
-
-  const gerund = gerundForms[skillType] || `using ${skillType}`;
-
-  // Enhanced description with usage triggers
-  const enhancedDesc = `${meta.description}. Use when ${gerund} or when the user mentions ${skillType}.`;
-
-  const envSection = meta.requiredEnvVars?.length ? `
-
-## Environment Variables
-
-${meta.requiredEnvVars.map(v => `- \`${v}\``).join('\n')}
-
-Add to your \`~/.zshrc\` or \`~/.bashrc\`:
-\`\`\`bash
-${meta.requiredEnvVars.map(v => `export ${v}=your_key_here`).join('\n')}
-\`\`\`
-` : '';
-
-  return `---
-name: ${meta.name}
-description: ${enhancedDesc}
----
-
-# ${meta.name.split('-').map(w => w.charAt(0).toUpperCase() + w.slice(1)).join(' ')}
-
-${meta.description}
-
-## Quick Start
-
-\`\`\`bash
-skills run ${skillType}
-\`\`\`
-
-## Version
-
-${meta.version}${envSection}
-
-## Installation
-
-Installed at: \`~/.claude/skills/${meta.name}/\`
-
-## Logs
-
-Execution logs: \`~/.claude/skills/${meta.name}/${meta.name}.log\`
-
-## Support
-
-For issues, visit: https://github.com/hasnaxyz/${meta.name}/issues
-`;
-}
-
-function generateReadme(meta: SkillMeta): string {
-  return `# ${meta.name}
-
-${meta.description}
-
-**Version:** ${meta.version}
-
-## Documentation
-
-See [SKILL.md](./SKILL.md) for complete documentation.
-
-## Quick Reference
-
-\`\`\`bash
-skills run ${meta.name} -- --help
-\`\`\`
-`;
+  console.error(`Use: skills mcp --register ${assistant}`);
+  process.exit(1);
 }

package/skills/ad-creative-pack/SKILL.md

@@ -0,0 +1,45 @@
+---
+name: ad-creative-pack
+description: Generate premium paid-ad copy, creative concepts, image prompts, audience angles, and test matrices.
+---
+
+# Ad Creative Pack
+
+Generate a paid-ad launch package for Meta, Google, and LinkedIn.
+
+## Requirements
+
+- Authenticate with `skills auth login`.
+- This premium skill runs through the hosted Skills runtime; local installs expose only skill metadata and instructions.
+
+## Usage
+
+```bash
+skills run ad-creative-pack "Usage-based billing for AI SaaS" --audience "founders" --goal "book demos"
+skills run ad-creative-pack --product "API monitoring" --offer "Find broken API workflows before customers do"
+```
+
+## Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--product <text>` | Product, service, or campaign brief. Positional text also works. | required |
+| `--audience <text>` | Target buyer or segment. | software teams |
+| `--offer <text>` | Campaign promise or offer. | derived from product |
+| `--goal <text>` | Conversion goal. | book demos |
+| `--platforms <list>` | Comma-separated platforms. | Meta, Google, LinkedIn |
+| `--tone <tone>` | `direct`, `premium`, `friendly`, or `technical`. | direct |
+| `--output <dir>` | Output directory for direct local execution. Hosted runs use the run export directory. | run export dir |
+
+## Outputs
+
+- `platform-copy.md`
+- `ad-copy.json`
+- `creative-concepts.md`
+- `image-prompts.md`
+- `audience-angles.csv`
+- `test-matrix.csv`
+- `launch-checklist.md`
+- `manifest.json`
+
+After submitting a hosted run, poll with `skills runs status <run-id>` and download outputs with `skills exports download <run-id>`.

package/skills/ad-creative-pack/package.json

@@ -0,0 +1,14 @@
+{
+  "name": "ad-creative-pack",
+  "version": "0.1.0",
+  "description": "Hosted premium paid ad creative artifact generator",
+  "type": "module",
+  "bin": {
+    "ad-creative-pack": "./src/index.ts"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "@types/bun": "latest",
+    "typescript": "^5.7.0"
+  }
+}

package/skills/advanced-math/package.json

@@ -11,7 +11,9 @@
     "build": "bun build src/index.ts --outdir dist --target node",
     "typecheck": "tsc --noEmit"
   },
-  "dependencies": {},
+  "dependencies": {
+    "mathjs": "^15.1.0"
+  },
   "devDependencies": {
     "@types/bun": "latest",
     "typescript": "^5.7.0"

package/skills/advanced-math/src/calculators.ts

@@ -0,0 +1,118 @@
+import { mathConfig } from "./runtime";
+import type { MatrixOperation } from "./types";
+
+// ============================================================================
+// Calculator Mode
+// ============================================================================
+export function evaluateExpression(expr: string, precision: number): any {
+  try {
+    // Configure precision
+    mathConfig.config({ precision });
+
+    const result = mathConfig.evaluate(expr);
+    return result;
+  } catch (error) {
+    throw new Error(`Failed to evaluate expression: ${error instanceof Error ? error.message : "Unknown error"}`);
+  }
+}
+
+// ============================================================================
+// Statistics Mode
+// ============================================================================
+export function calculateStatistics(data: number[], metrics?: string): any {
+  const requestedMetrics = metrics?.split(",").map(m => m.trim()) || ["all"];
+  const stats: any = {};
+
+  if (requestedMetrics.includes("all") || requestedMetrics.includes("mean")) {
+    stats.mean = mathConfig.mean(data);
+  }
+
+  if (requestedMetrics.includes("all") || requestedMetrics.includes("median")) {
+    stats.median = mathConfig.median(data);
+  }
+
+  if (requestedMetrics.includes("all") || requestedMetrics.includes("mode")) {
+    stats.mode = mathConfig.mode(data);
+  }
+
+  if (requestedMetrics.includes("all") || requestedMetrics.includes("std")) {
+    stats.std = mathConfig.std(data);
+  }
+
+  if (requestedMetrics.includes("all") || requestedMetrics.includes("variance")) {
+    stats.variance = mathConfig.variance(data);
+  }
+
+  if (requestedMetrics.includes("all") || requestedMetrics.includes("min")) {
+    stats.min = mathConfig.min(data);
+  }
+
+  if (requestedMetrics.includes("all") || requestedMetrics.includes("max")) {
+    stats.max = mathConfig.max(data);
+  }
+
+  if (requestedMetrics.includes("all") || requestedMetrics.includes("range")) {
+    stats.range = mathConfig.max(data) - mathConfig.min(data);
+  }
+
+  if (requestedMetrics.includes("all") || requestedMetrics.includes("sum")) {
+    stats.sum = mathConfig.sum(data);
+  }
+
+  if (requestedMetrics.includes("all") || requestedMetrics.includes("count")) {
+    stats.count = data.length;
+  }
+
+  if (requestedMetrics.includes("all") || requestedMetrics.includes("quartiles")) {
+    const sorted = [...data].sort((a, b) => a - b);
+    stats.quartiles = {
+      q1: mathConfig.quantileSeq(sorted, 0.25),
+      q2: mathConfig.quantileSeq(sorted, 0.5),
+      q3: mathConfig.quantileSeq(sorted, 0.75),
+    };
+    stats.iqr = stats.quartiles.q3 - stats.quartiles.q1;
+  }
+
+  return stats;
+}
+
+// ============================================================================
+// Matrix Mode
+// ============================================================================
+export function performMatrixOperation(matrices: any[], operation: MatrixOperation): any {
+  const matrix1 = mathConfig.matrix(matrices[0]);
+
+  switch (operation) {
+    case "add":
+      if (matrices.length < 2) throw new Error("Addition requires two matrices");
+      return mathConfig.add(matrix1, mathConfig.matrix(matrices[1]));
+
+    case "multiply":
+      if (matrices.length < 2) throw new Error("Multiplication requires two matrices");
+      return mathConfig.multiply(matrix1, mathConfig.matrix(matrices[1]));
+
+    case "transpose":
+      return mathConfig.transpose(matrix1);
+
+    case "determinant":
+      return mathConfig.det(matrix1);
+
+    case "inverse":
+      return mathConfig.inv(matrix1);
+
+    case "eigenvalues":
+      return mathConfig.eigs(matrix1).values;
+
+    case "rank":
+      // mathjs doesn't have rank, approximate with determinant check
+      const det = mathConfig.det(matrix1);
+      const size = mathConfig.size(matrix1).valueOf() as number[];
+      return det !== 0 ? size[0] : "< " + size[0];
+
+    case "trace":
+      return mathConfig.trace(matrix1);
+
+    default:
+      throw new Error(`Unknown matrix operation: ${operation}`);
+  }
+}

package/skills/advanced-math/src/cli.ts

@@ -0,0 +1,130 @@
+import { parseArgs } from "util";
+import { log } from "./runtime";
+import type {
+  FinanceType,
+  MathOptions,
+  MatrixOperation,
+  Mode,
+  NumberFormat,
+  OutputFormat,
+  SymbolicOperation,
+} from "./types";
+
+export function parseMathCli(): { input: string; mode: Mode; precision: number; options: MathOptions; positionals: string[] } {
+  const { values, positionals } = parseArgs({
+    args: process.argv.slice(2),
+    options: {
+      mode: { type: "string", default: "calc" },
+      precision: { type: "string", default: "10" },
+      format: { type: "string", default: "number" },
+      output: { type: "string", default: "text" },
+      "show-steps": { type: "boolean", default: false },
+      stats: { type: "string" },
+      matrix: { type: "string" },
+      from: { type: "string" },
+      to: { type: "string" },
+      finance: { type: "string" },
+      principal: { type: "string" },
+      rate: { type: "string" },
+      years: { type: "string" },
+      periods: { type: "string" },
+      payment: { type: "string" },
+      cashflows: { type: "string" },
+      operation: { type: "string" },
+      var: { type: "string", default: "x" },
+      help: { type: "boolean", short: "h" },
+    },
+    allowPositionals: true,
+  });
+
+  if (values.help) {
+    console.log(`
+╔═══════════════════════════════════════════════════════════════════════════════╗
+║                        ADVANCED MATH - Calculation Engine                      ║
+║     Perform complex mathematical operations, statistics, and symbolic math     ║
+╚═══════════════════════════════════════════════════════════════════════════════╝
+
+USAGE:
+  skills run advanced-math -- "<expression or data>" [options]
+
+MODES:
+  calc      Basic expression evaluation and scientific calculations
+  stats     Statistical analysis (mean, median, std dev, etc.)
+  matrix    Matrix operations (determinant, inverse, eigenvalues)
+  convert   Unit conversions (length, weight, temperature, etc.)
+  finance   Financial calculations (compound interest, NPV, IRR)
+  symbolic  AI-powered symbolic math (derivatives, integrals)
+
+OPTIONS:
+  --mode <mode>           Calculation mode [default: calc]
+  --precision <n>         Decimal places [default: 10]
+  --format <format>       Output format: number, scientific, fraction, percentage
+  --output <format>       Result format: text, json, latex [default: text]
+  --show-steps           Show calculation steps
+
+CALC MODE:
+  skills run advanced-math -- "2 + 2 * 3"
+  skills run advanced-math -- "sin(pi/4) + cos(pi/4)"
+  skills run advanced-math -- "sqrt(16) + log10(100)"
+
+STATS MODE:
+  skills run advanced-math -- "1,2,3,4,5" --mode stats
+  skills run advanced-math -- "10,20,30" --mode stats --stats mean,median
+
+MATRIX MODE:
+  skills run advanced-math -- "[[1,2],[3,4]]" --mode matrix --matrix determinant
+  skills run advanced-math -- "[[4,7],[2,6]]" --mode matrix --matrix inverse
+
+CONVERT MODE:
+  skills run advanced-math -- "100" --mode convert --from celsius --to fahrenheit
+  skills run advanced-math -- "1" --mode convert --from kilometer --to mile
+
+FINANCE MODE:
+  skills run advanced-math -- --mode finance --finance compound --principal 1000 --rate 5 --years 10
+  skills run advanced-math -- --mode finance --finance pmt --principal 200000 --rate 4.5 --years 30
+
+SYMBOLIC MODE (requires OPENAI_API_KEY):
+  skills run advanced-math -- "x^2 + 3*x" --mode symbolic --operation derivative --var x
+  skills run advanced-math -- "2*x + 3" --mode symbolic --operation integral --show-steps
+
+For full documentation, see SKILL.md
+`);
+    process.exit(0);
+  }
+
+  const input = positionals.join(" ");
+  const mode = values.mode as Mode;
+  const precision = parseInt(values.precision as string);
+
+  if (isNaN(precision) || precision < 0 || precision > 100) {
+    log("Error: Precision must be a number between 0 and 100", "error");
+    process.exit(1);
+  }
+
+  return {
+    input,
+    mode,
+    precision,
+    positionals,
+    options: {
+      mode,
+      precision,
+      format: values.format as NumberFormat,
+      output: values.output as OutputFormat,
+      showSteps: values["show-steps"] as boolean,
+      stats: values.stats as string,
+      matrix: values.matrix as MatrixOperation,
+      from: values.from as string,
+      to: values.to as string,
+      finance: values.finance as FinanceType,
+      principal: values.principal ? parseFloat(values.principal as string) : undefined,
+      rate: values.rate ? parseFloat(values.rate as string) : undefined,
+      years: values.years ? parseFloat(values.years as string) : undefined,
+      periods: values.periods ? parseFloat(values.periods as string) : undefined,
+      payment: values.payment ? parseFloat(values.payment as string) : undefined,
+      cashflows: values.cashflows as string,
+      operation: values.operation as SymbolicOperation,
+      var: values.var as string,
+    },
+  };
+}

package/skills/advanced-math/src/conversion.ts

@@ -0,0 +1,90 @@
+import { mathConfig } from "./runtime";
+
+// ============================================================================
+// Unit Conversion Mode
+// ============================================================================
+const unitMappings: Record<string, string> = {
+  // Length
+  "meter": "m", "meters": "m", "m": "m",
+  "kilometer": "km", "kilometers": "km", "km": "km",
+  "centimeter": "cm", "centimeters": "cm", "cm": "cm",
+  "millimeter": "mm", "millimeters": "mm", "mm": "mm",
+  "mile": "mile", "miles": "mile",
+  "yard": "yard", "yards": "yard",
+  "foot": "ft", "feet": "ft", "ft": "ft",
+  "inch": "inch", "inches": "inch", "in": "inch",
+
+  // Mass
+  "kilogram": "kg", "kilograms": "kg", "kg": "kg",
+  "gram": "g", "grams": "g", "g": "g",
+  "milligram": "mg", "milligrams": "mg", "mg": "mg",
+  "pound": "lb", "pounds": "lb", "lb": "lb", "lbs": "lb",
+  "ounce": "oz", "ounces": "oz", "oz": "oz",
+  "ton": "ton", "tons": "ton",
+
+  // Time
+  "second": "s", "seconds": "s", "s": "s", "sec": "s",
+  "minute": "min", "minutes": "min", "min": "min",
+  "hour": "hour", "hours": "hour", "hr": "hour", "h": "hour",
+  "day": "day", "days": "day",
+  "week": "week", "weeks": "week",
+  "month": "month", "months": "month",
+  "year": "year", "years": "year", "yr": "year",
+};
+
+export function convertUnit(value: number, from: string, to: string): number {
+  const fromUnit = unitMappings[from.toLowerCase()] || from;
+  const toUnit = unitMappings[to.toLowerCase()] || to;
+
+  // Handle temperature separately (not supported by mathjs unit system)
+  if (["celsius", "fahrenheit", "kelvin"].includes(from.toLowerCase())) {
+    return convertTemperature(value, from.toLowerCase(), to.toLowerCase());
+  }
+
+  // Handle data sizes separately
+  if (["bit", "byte", "kilobyte", "megabyte", "gigabyte", "terabyte", "petabyte"].includes(from.toLowerCase())) {
+    return convertDataSize(value, from.toLowerCase(), to.toLowerCase());
+  }
+
+  try {
+    const result = mathConfig.evaluate(`${value} ${fromUnit} to ${toUnit}`);
+    return Number(result.toNumeric(toUnit));
+  } catch (error) {
+    throw new Error(`Failed to convert ${from} to ${to}: ${error instanceof Error ? error.message : "Unknown error"}`);
+  }
+}
+
+function convertTemperature(value: number, from: string, to: string): number {
+  let celsius: number;
+
+  // Convert to Celsius first
+  switch (from) {
+    case "celsius": celsius = value; break;
+    case "fahrenheit": celsius = (value - 32) * 5 / 9; break;
+    case "kelvin": celsius = value - 273.15; break;
+    default: throw new Error(`Unknown temperature unit: ${from}`);
+  }
+
+  // Convert from Celsius to target
+  switch (to) {
+    case "celsius": return celsius;
+    case "fahrenheit": return celsius * 9 / 5 + 32;
+    case "kelvin": return celsius + 273.15;
+    default: throw new Error(`Unknown temperature unit: ${to}`);
+  }
+}
+
+function convertDataSize(value: number, from: string, to: string): number {
+  const bytes: Record<string, number> = {
+    "bit": 0.125,
+    "byte": 1,
+    "kilobyte": 1024,
+    "megabyte": 1024 ** 2,
+    "gigabyte": 1024 ** 3,
+    "terabyte": 1024 ** 4,
+    "petabyte": 1024 ** 5,
+  };
+
+  const valueInBytes = value * bytes[from];
+  return valueInBytes / bytes[to];
+}