@hasna/skills 0.1.27 → 0.1.29

package/skills/analyze-data/src/logger.ts

@@ -0,0 +1,36 @@
+import { appendFileSync, existsSync, mkdirSync } from 'fs';
+import { randomUUID } from 'crypto';
+import { join } from 'path';
+
+export const SKILL_NAME = "analyze-data";
+export const SESSION_ID = randomUUID().slice(0, 8);
+export const SKILLS_OUTPUT_DIR = process.env.SKILLS_OUTPUT_DIR || join(process.cwd(), ".skills");
+export const LOGS_DIR = join(SKILLS_OUTPUT_DIR, "logs", SKILL_NAME);
+export const LOG_FILE = join(LOGS_DIR, `${new Date().toISOString().replace(/[:.]/g, "_").slice(0, 19)}_${SESSION_ID}.log`);
+
+export function ensureDir(dir: string) {
+  if (!existsSync(dir)) {
+    mkdirSync(dir, { recursive: true });
+  }
+}
+
+export function log(message: string, level: "info" | "error" | "success" = "info") {
+  ensureDir(LOGS_DIR);
+  const timestamp = new Date().toISOString();
+  const logMessage = `[${timestamp}] [${level.toUpperCase()}] ${message}\n`;
+  appendFileSync(LOG_FILE, logMessage);
+
+  const prefixes = {
+    info: "ℹ️ ",
+    error: "❌ ",
+    success: "✅ "
+  };
+
+  if (level === "error") {
+    console.error(`${prefixes[level]} ${message}`);
+  } else {
+    console.log(`${prefixes[level]} ${message}`);
+  }
+}
+
+// ============================================================================

package/skills/analyze-data/src/parsers.ts

@@ -0,0 +1,57 @@
+export function parseCSV(content: string): any[] {
+  const lines = content.split('\n').filter(line => line.trim());
+  if (lines.length === 0) return [];
+
+  const headers = lines[0].split(',').map(h => h.trim().replace(/^"|"$/g, ''));
+  const data: any[] = [];
+
+  for (let i = 1; i < lines.length; i++) {
+    const values = parseCSVLine(lines[i]);
+    if (values.length === headers.length) {
+      const row: any = {};
+      headers.forEach((header, idx) => {
+        row[header] = values[idx];
+      });
+      data.push(row);
+    }
+  }
+
+  return data;
+}
+
+function parseCSVLine(line: string): string[] {
+  const values: string[] = [];
+  let current = '';
+  let inQuotes = false;
+
+  for (let i = 0; i < line.length; i++) {
+    const char = line[i];
+
+    if (char === '"') {
+      inQuotes = !inQuotes;
+    } else if (char === ',' && !inQuotes) {
+      values.push(current.trim());
+      current = '';
+    } else {
+      current += char;
+    }
+  }
+
+  values.push(current.trim());
+  return values.map(v => v.replace(/^"|"$/g, ''));
+}
+
+export function parseJSON(content: string): any[] {
+  const parsed = JSON.parse(content);
+
+  if (Array.isArray(parsed)) {
+    return parsed;
+  } else if (parsed.data && Array.isArray(parsed.data)) {
+    return parsed.data;
+  } else if (typeof parsed === 'object') {
+    // Convert object to array of key-value pairs
+    return Object.entries(parsed).map(([key, value]) => ({ key, value }));
+  }
+
+  throw new Error('Unsupported JSON structure');
+}

package/skills/analyze-data/src/stats.ts

@@ -0,0 +1,151 @@
+import type { ColumnStats } from './types';
+
+export function detectDataType(values: any[]): ColumnStats['dataType'] {
+  const nonNullValues = values.filter(v => v !== null && v !== undefined && v !== '');
+  if (nonNullValues.length === 0) return 'string';
+
+  let numericCount = 0;
+  let dateCount = 0;
+  let booleanCount = 0;
+
+  for (const value of nonNullValues.slice(0, 100)) {
+    if (typeof value === 'number' || !isNaN(Number(value))) {
+      numericCount++;
+    }
+    if (value === true || value === false || value === 'true' || value === 'false') {
+      booleanCount++;
+    }
+    if (!isNaN(Date.parse(String(value)))) {
+      dateCount++;
+    }
+  }
+
+  const total = Math.min(nonNullValues.length, 100);
+
+  if (numericCount / total > 0.8) return 'numeric';
+  if (booleanCount / total > 0.8) return 'boolean';
+  if (dateCount / total > 0.8) return 'date';
+  if (numericCount > 0 && numericCount < total * 0.8) return 'mixed';
+
+  return 'string';
+}
+
+export function calculateStats(values: number[]): Partial<ColumnStats> {
+  if (values.length === 0) return {};
+
+  const sorted = [...values].sort((a, b) => a - b);
+  const n = sorted.length;
+
+  // Basic stats
+  const sum = sorted.reduce((acc, val) => acc + val, 0);
+  const mean = sum / n;
+
+  const median = n % 2 === 0
+    ? (sorted[n / 2 - 1] + sorted[n / 2]) / 2
+    : sorted[Math.floor(n / 2)];
+
+  // Mode
+  const frequency: Record<number, number> = {};
+  sorted.forEach(val => {
+    frequency[val] = (frequency[val] || 0) + 1;
+  });
+  const maxFreq = Math.max(...Object.values(frequency));
+  const modes = Object.keys(frequency)
+    .filter(key => frequency[Number(key)] === maxFreq)
+    .map(Number);
+  const mode = modes.length === sorted.length ? undefined : (modes.length === 1 ? modes[0] : modes);
+
+  // Variance and standard deviation
+  const squaredDiffs = sorted.map(val => Math.pow(val - mean, 2));
+  const variance = squaredDiffs.reduce((acc, val) => acc + val, 0) / n;
+  const stdDev = Math.sqrt(variance);
+
+  // Quartiles
+  const q1 = sorted[Math.floor(n * 0.25)];
+  const q2 = median;
+  const q3 = sorted[Math.floor(n * 0.75)];
+
+  // Skewness and kurtosis
+  const cubedDiffs = sorted.map(val => Math.pow((val - mean) / stdDev, 3));
+  const skewness = cubedDiffs.reduce((acc, val) => acc + val, 0) / n;
+
+  const fourthDiffs = sorted.map(val => Math.pow((val - mean) / stdDev, 4));
+  const kurtosis = fourthDiffs.reduce((acc, val) => acc + val, 0) / n - 3;
+
+  return {
+    mean: roundTo(mean, 4),
+    median: roundTo(median, 4),
+    mode,
+    stdDev: roundTo(stdDev, 4),
+    variance: roundTo(variance, 4),
+    min: sorted[0],
+    max: sorted[n - 1],
+    range: sorted[n - 1] - sorted[0],
+    q1: roundTo(q1, 4),
+    q2: roundTo(q2, 4),
+    q3: roundTo(q3, 4),
+    skewness: roundTo(skewness, 4),
+    kurtosis: roundTo(kurtosis, 4),
+  };
+}
+
+export function calculatePercentiles(values: number[], percentiles: number[]): Record<number, number> {
+  const sorted = [...values].sort((a, b) => a - b);
+  const result: Record<number, number> = {};
+
+  percentiles.forEach(p => {
+    const index = (p / 100) * (sorted.length - 1);
+    const lower = Math.floor(index);
+    const upper = Math.ceil(index);
+    const fraction = index - lower;
+
+    result[p] = sorted[lower] + fraction * (sorted[upper] - sorted[lower]);
+  });
+
+  return result;
+}
+
+export function detectOutliers(values: number[], q1: number, q3: number): number[] {
+  const iqr = q3 - q1;
+  const lowerBound = q1 - 1.5 * iqr;
+  const upperBound = q3 + 1.5 * iqr;
+
+  return values.filter(val => val < lowerBound || val > upperBound);
+}
+
+export function calculateCorrelation(x: number[], y: number[]): number {
+  const n = Math.min(x.length, y.length);
+  if (n === 0) return 0;
+
+  const meanX = x.reduce((acc, val) => acc + val, 0) / n;
+  const meanY = y.reduce((acc, val) => acc + val, 0) / n;
+
+  let numerator = 0;
+  let sumXSquared = 0;
+  let sumYSquared = 0;
+
+  for (let i = 0; i < n; i++) {
+    const dx = x[i] - meanX;
+    const dy = y[i] - meanY;
+    numerator += dx * dy;
+    sumXSquared += dx * dx;
+    sumYSquared += dy * dy;
+  }
+
+  const denominator = Math.sqrt(sumXSquared * sumYSquared);
+  return denominator === 0 ? 0 : numerator / denominator;
+}
+
+export function roundTo(value: number, decimals: number): number {
+  const factor = Math.pow(10, decimals);
+  return Math.round(value * factor) / factor;
+}
+
+export function formatBytes(bytes: number): string {
+  if (bytes < 1024) return bytes + ' B';
+  if (bytes < 1024 * 1024) return (bytes / 1024).toFixed(2) + ' KB';
+  if (bytes < 1024 * 1024 * 1024) return (bytes / (1024 * 1024)).toFixed(2) + ' MB';
+  return (bytes / (1024 * 1024 * 1024)).toFixed(2) + ' GB';
+}
+
+// ============================================================================

package/skills/analyze-data/src/types.ts

@@ -0,0 +1,85 @@
+export interface AnalysisOptions {
+  format: 'markdown' | 'json' | 'html';
+  output?: string;
+  correlations: boolean;
+  outliers: boolean;
+  trends: boolean;
+  sample?: number;
+  percentiles: number[];
+  verbose: boolean;
+}
+
+export interface ColumnStats {
+  name: string;
+  dataType: 'numeric' | 'string' | 'date' | 'boolean' | 'mixed';
+  count: number;
+  nullCount: number;
+  nullPercentage: number;
+  uniqueCount: number;
+  uniquePercentage: number;
+  sampleValues: any[];
+
+  // Numeric stats
+  mean?: number;
+  median?: number;
+  mode?: number | number[];
+  stdDev?: number;
+  variance?: number;
+  min?: number;
+  max?: number;
+  range?: number;
+  q1?: number;
+  q2?: number;
+  q3?: number;
+  percentiles?: Record<number, number>;
+  skewness?: number;
+  kurtosis?: number;
+  outliers?: number[];
+
+  // String stats
+  avgLength?: number;
+  minLength?: number;
+  maxLength?: number;
+
+  // Distribution
+  distribution?: Record<string, number>;
+  topValues?: Array<{ value: any; count: number; percentage: number }>;
+}
+
+export interface AnalysisReport {
+  overview: {
+    fileName: string;
+    fileSize: string;
+    fileType: string;
+    rowCount: number;
+    columnCount: number;
+    memoryUsage: string;
+    processingTime: number;
+    timestamp: string;
+  };
+  columns: ColumnStats[];
+  correlations?: number[][];
+  correlationPairs?: Array<{ col1: string; col2: string; correlation: number }>;
+  quality: {
+    totalCells: number;
+    missingCells: number;
+    missingPercentage: number;
+    duplicateRows: number;
+    duplicatePercentage: number;
+    dataQualityScore: number;
+    issues: string[];
+  };
+  trends?: {
+    detected: boolean;
+    patterns: string[];
+    insights: string[];
+  };
+  visualizationRecommendations: Array<{
+    column: string;
+    chartType: string;
+    reason: string;
+  }>;
+  insights: string[];
+}
+
+// ============================================================================

package/skills/api-docs-portal/SKILL.md

@@ -0,0 +1,46 @@
+---
+name: api-docs-portal
+description: Generate premium API documentation portals from OpenAPI specs, route lists, or examples.
+---
+
+# API Docs Portal
+
+Generate a polished API documentation portal from OpenAPI specs, route files, or endpoint examples.
+
+## Requirements
+
+- Authenticate with `skills auth login`.
+- This premium skill runs through the hosted Skills runtime; local installs expose only metadata and instructions.
+
+## Usage
+
+```bash
+skills run api-docs-portal --spec "GET /v1/projects, POST /v1/projects" --title "Acme API"
+skills run api-docs-portal --spec-file ./openapi.json --base-url "https://api.example.com" --auth bearer
+```
+
+## Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--spec <text>` | OpenAPI JSON, route list, or endpoint examples. Positional text also works. | required |
+| `--spec-file <path>` | Read the API spec or route list from a file. | none |
+| `--title <text>` | Portal and API title. | API Documentation |
+| `--base-url <url>` | Base URL used in examples. | https://api.example.com |
+| `--auth <mode>` | Auth mode: `bearer`, `api-key`, `oauth`, `session`, or `none`. | bearer |
+| `--theme <name>` | Portal theme: `light` or `slate`. | light |
+| `--output <dir>` | Output directory for direct local execution. Hosted runs use the run export directory. | run export dir |
+
+## Outputs
+
+- `site/index.html`
+- `site/styles.css`
+- `site/endpoints.json`
+- `openapi.json`
+- `endpoint-reference.md`
+- `auth-guide.md`
+- `examples.md`
+- `README.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/api-docs-portal/package.json

@@ -0,0 +1,9 @@
+{
+  "name": "api-docs-portal",
+  "version": "0.1.0",
+  "type": "module",
+  "private": true,
+  "bin": {
+    "api-docs-portal": "src/index.ts"
+  }
+}

package/skills/api-test-suite/src/index.ts

@@ -292,6 +292,19 @@ function generateTestFile(parsed: ParsedInput, tests: TestCase[], options: Optio
  */
 async function main() {
   try {
+    if (process.argv.includes("--help") || process.argv.includes("-h")) {
+      console.log(`api-test-suite
+
+Usage:
+  skills run api-test-suite -- "POST /api/users with name, email" [options]
+
+Options:
+  --format <framework>          Test framework output, default vitest
+  --include-auth=false          Disable auth test generation
+  --include-rate-limit          Include rate limit tests`);
+      return;
+    }
+
     const input = process.env.SKILLS_INPUT || "";
     const outputDir = process.env.SKILLS_OUTPUT_DIR || process.cwd();
     const exportsDir = process.env.SKILLS_EXPORTS_DIR || join(outputDir, "exports");

package/skills/apidocs/package.json

@@ -4,7 +4,7 @@
   "description": "Agentic web crawler for API documentation indexing and semantic search",
   "type": "module",
   "bin": {
-    "apidocs": "./bin/cli.ts"
+    "apidocs": "src/index.ts"
   },
   "scripts": {
     "dev": "bun run bin/cli.ts",

package/skills/apidocs/src/index.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env bun
+
+console.log("Usage: skills run apidocs -- <command> [options]");

package/skills/audio/package.json

@@ -2,14 +2,14 @@
   "name": "audio",
   "version": "1.0.0",
   "description": "Generate speech and audio using provider-cost AI backends",
-  "type": "module",
   "main": "src/index.ts",
+  "type": "module",
   "bin": {
     "audio": "src/index.ts"
   },
   "scripts": {
     "start": "bun run src/index.ts",
-    "dev": "bun run --watch src/index.ts"
+    "generate": "bun run src/index.ts generate"
   },
   "keywords": [
     "audio-generation",
@@ -20,7 +20,6 @@
     "minimax",
     "gemini"
   ],
-  "author": "",
   "devDependencies": {
     "@types/bun": "latest"
   },

package/skills/audio-cleanup-lab/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: Audio Cleanup Lab
+name: audio-cleanup-lab
 version: 0.1.0
 description: Generate professional audio cleanup recipes and mastering guidelines for noisy recordings
 author: skills.md
@@ -78,4 +78,4 @@ skills run audio-cleanup-lab -- "ADR matching location sound" \
 ## Requirements
 
 - `OPENAI_API_KEY` environment variable.
-- Bun runtime.
+- Bun runtime.

package/skills/audio-extract/CLAUDE.md

@@ -1,4 +1,4 @@
-# extract-audio
+# audio-extract
 
 Skill for extracting audio tracks from video files. Supports multiple output formats and codec configurations.
 

package/skills/audio-transcript-pack/SKILL.md

@@ -0,0 +1,43 @@
+---
+name: audio-transcript-pack
+description: Generate premium transcript packages with timestamps, summaries, show notes, clip suggestions, repurposing copy, captions, and manifest metadata.
+---
+
+# Audio Transcript Pack
+
+Generate a production-ready transcript package from audio, video, or existing transcript text.
+
+## Requirements
+
+- Authenticate with `skills auth login`.
+- This premium skill runs through the hosted Skills runtime; local installs expose only metadata and instructions.
+
+## Usage
+
+```bash
+skills run audio-transcript-pack --source ./episode.mp3 --title "Usage-based billing teardown" --speakers "Host,Guest"
+skills run audio-transcript-pack --source ./transcript.txt --format podcast --duration-minutes 42
+```
+
+## Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--source <path-or-text>` | Audio/video file, transcript text file, or transcript text. | required |
+| `--title <text>` | Episode, meeting, or recording title. | Audio Transcript Pack |
+| `--speakers <list>` | Comma-separated speaker names. | Speaker 1,Speaker 2 |
+| `--format <type>` | `podcast`, `meeting`, `lecture`, `interview`, or `general`. | general |
+| `--duration-minutes <n>` | Approximate runtime for timestamp spacing. | 30 |
+| `--output <dir>` | Output directory for direct local execution. Hosted runs use the run export directory. | run export dir |
+
+## Outputs
+
+- `transcript.md`
+- `captions.srt`
+- `summary.md`
+- `show-notes.md`
+- `clips.csv`
+- `content-repurpose-pack.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/audio-transcript-pack/package.json

@@ -0,0 +1,10 @@
+{
+  "name": "audio-transcript-pack",
+  "version": "0.1.0",
+  "private": true,
+  "description": "Hosted premium audio transcript package generator",
+  "type": "module",
+  "bin": {
+    "audio-transcript-pack": "./src/index.ts"
+  }
+}

package/skills/blog-article/CLAUDE.md

@@ -0,0 +1,12 @@
+# blog-article
+
+Generate one or more SEO-ready blog article packages through the hosted Skills runtime.
+
+Use via:
+
+```bash
+skills quote create-blog-article --count 8 --topic "SaaS onboarding"
+skills run create-blog-article --count 8 --topic "SaaS onboarding" --audience "founders" --length long --seo
+```
+
+Hosted runs write Markdown, HTML, JSON, and manifest artifacts to the run export directory.

package/skills/blog-article/SKILL.md

@@ -0,0 +1,45 @@
+---
+name: blog-article
+description: Generate one or more SEO-ready blog article packages as hosted premium artifacts.
+---
+
+# Blog Article
+
+Generate blog articles as downloadable Markdown, HTML, JSON, and manifest artifacts.
+
+## 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 quote create-blog-article --count 8 --topic "SaaS onboarding"
+skills run create-blog-article --count 8 --topic "SaaS onboarding" --audience "founders" --length long --seo
+skills run create-blog-article -- --topic "Product-led growth" --articles 12
+```
+
+## Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--topic <text>` | Topic or theme. Positional text also works. | required |
+| `--audience <text>` | Intended reader or buyer persona. | |
+| `--count <number>` | Number of articles to generate, 1-12. | 1 |
+| `--articles <number>` | Alias for `--count`. | |
+| `--tone <tone>` | `professional`, `casual`, `technical`, or `friendly`. | professional |
+| `--length <length>` | `short`, `medium`, or `long`. | medium |
+| `--seo` | Include SEO metadata and keyword-oriented structure. | false |
+| `--outline <text>` | Optional outline, angles, or required sections. | |
+| `--output <dir>` | Output directory for direct local execution. Hosted runs use the run export directory. | run export dir |
+
+## Outputs
+
+- `manifest.json` using the `skills.blogArticle.outputs.v1` contract
+- For a single article: `article.md`, `article.html`, `article.json`
+- For batch runs: `article-XX-<slug>/article.md`, `article.html`, `article.json`
+
+`manifest.json` includes the run id, prompt, sanitized input options, requested tone/length/SEO settings, receipt cost, and an `articles` array. Each article entry includes `title`, `slug`, `summary`, `keywords`, optional `featuredImage`, word count, reading time, and relative file paths.
+
+After submitting a hosted run, poll with `skills runs status <run-id>` and download outputs with `skills exports download <run-id>`.

package/skills/{create-blog-article → blog-article}/package.json

@@ -1,10 +1,10 @@
 {
-  "name": "create-blog-article",
+  "name": "blog-article",
   "version": "0.1.0",
-  "description": "Create Blog Article skill",
+  "description": "Hosted premium blog article artifact generator",
   "type": "module",
   "bin": {
-    "create-blog-article": "./src/index.ts"
+    "blog-article": "./src/index.ts"
   },
   "scripts": {
     "dev": "bun run src/index.ts",

package/skills/brand-kit/SKILL.md

@@ -0,0 +1,45 @@
+---
+name: brand-kit
+description: Generate premium brand kits with logo usage, palette, typography, brand voice, sample applications, Markdown guide, and PDF guide.
+---
+
+# Brand Kit
+
+Generate a production-ready brand guide package for a startup, product, internal tool, or campaign.
+
+## 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 brand-kit "Usage-based billing for AI SaaS" --audience "founders" --personality "precise, calm, pragmatic"
+skills run brand-kit --brand "Acme Ledger" --category "developer tools" --tone premium
+```
+
+## Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--brand <text>` | Brand, product, or company name. Positional text also works. | required |
+| `--category <text>` | Market category or product type. | software product |
+| `--audience <text>` | Primary audience. | software teams |
+| `--personality <text>` | Brand personality words. | clear, capable, direct |
+| `--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
+
+- `brand-guide.md`
+- `brand-guide.pdf`
+- `palette.json`
+- `typography.md`
+- `voice-guide.md`
+- `logo-usage.md`
+- `sample-applications.md`
+- `brand-assets.svg`
+- `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/brand-kit/package.json

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