@hasna/skills 0.1.62 → 0.1.64

package/skills/_common/skill-install.ts

@@ -1,37 +0,0 @@
-/**
- * Legacy install command boundary for bundled skill packages.
- *
- * Per-skill packages must not write into agent-native skill directories.
- * The root Skills CLI renders skills into agent-native skill directories.
- */
-
-interface SkillMeta {
-  name: string;
-  description: string;
-  version: string;
-  commands: string;
-  requiredEnvVars?: string[];
-}
-
-export async function handleInstallCommand(meta: SkillMeta, args: string[]): Promise<boolean> {
-  const command = args[0];
-  const assistant = args[1];
-
-  if (command !== "install" && command !== "uninstall") {
-    return false;
-  }
-
-  if (!assistant || !["claude", "codex", "windsurf", "cursor"].includes(assistant)) {
-    console.error("Direct per-skill installs are disabled.");
-    console.error("Use: skills render");
-    process.exit(1);
-  }
-
-  if (command === "install") {
-    console.error(`Direct installs for ${meta.name} are disabled.`);
-  } else {
-    console.error(`Direct uninstalls for ${meta.name} are disabled.`);
-  }
-  console.error("Use: skills render");
-  process.exit(1);
-}

package/skills/_common/vision.ts

@@ -1,374 +0,0 @@
-/**
- * Unified vision client for AI providers.
- * Follows @hasna/connectors pattern — auto-detects from env vars.
- * Providers: anthropic, openai, xai, gemini
- *
- * Uses built-in fetch only — no external SDK dependencies.
- */
-
-export type VisionProvider = "anthropic" | "openai" | "xai" | "gemini";
-
-export interface VisionOptions {
-  provider?: VisionProvider;
-  model?: string;
-  maxTokens?: number;
-  systemPrompt?: string;
-  jsonMode?: boolean; // wrap prompt to request JSON response
-}
-
-export interface VisionResult {
-  text: string;
-  provider: VisionProvider;
-  model: string;
-  inputTokens?: number;
-  outputTokens?: number;
-}
-
-// Default models per provider (vision-capable)
-export const DEFAULT_MODELS: Record<VisionProvider, string> = {
-  anthropic: "claude-sonnet-4-6",
-  openai: "gpt-4o",
-  xai: "grok-2-vision-1212",
-  gemini: "gemini-2.0-flash",
-};
-
-// API key env vars per provider
-export const API_KEY_VARS: Record<VisionProvider, string> = {
-  anthropic: "ANTHROPIC_API_KEY",
-  openai: "OPENAI_API_KEY",
-  xai: "XAI_API_KEY",
-  gemini: "GEMINI_API_KEY",
-};
-
-// Base URLs
-const BASE_URLS: Record<VisionProvider, string> = {
-  anthropic: "https://api.anthropic.com/v1/messages",
-  openai: "https://api.openai.com/v1/chat/completions",
-  xai: "https://api.x.ai/v1/chat/completions",
-  gemini: "https://generativelanguage.googleapis.com/v1beta/models",
-};
-
-/**
- * Auto-detect provider from env vars.
- * Priority: ANTHROPIC_API_KEY → OPENAI_API_KEY → XAI_API_KEY → GEMINI_API_KEY
- */
-export function detectProvider(): VisionProvider | null {
-  const order: VisionProvider[] = ["anthropic", "openai", "xai", "gemini"];
-  for (const provider of order) {
-    if (process.env[API_KEY_VARS[provider]]) {
-      return provider;
-    }
-  }
-  return null;
-}
-
-/**
- * Get API key for a provider. Throws if not set.
- */
-export function getApiKey(provider: VisionProvider): string {
-  const key = process.env[API_KEY_VARS[provider]];
-  if (!key) {
-    throw new Error(
-      `${API_KEY_VARS[provider]} is not set. Run: connectors setup ${provider}`
-    );
-  }
-  return key;
-}
-
-/**
- * Strip markdown code fences and JSON.parse.
- * Throws with raw text on failure.
- */
-export function parseJsonResponse(text: string): unknown {
-  let str = text.trim();
-  if (str.startsWith("```")) {
-    str = str
-      .replace(/^```(?:json)?\n?/, "")
-      .replace(/\n?```$/, "")
-      .trim();
-  }
-  try {
-    return JSON.parse(str);
-  } catch {
-    throw new Error(
-      `Failed to parse response as JSON.\nRaw response:\n${text}`
-    );
-  }
-}
-
-/**
- * Returns all providers that have an API key set.
- */
-export function listAvailableProviders(): VisionProvider[] {
-  return (["anthropic", "openai", "xai", "gemini"] as VisionProvider[]).filter(
-    (p) => !!process.env[API_KEY_VARS[p]]
-  );
-}
-
-/**
- * Returns availability status for all providers.
- */
-export function getProviderInfo(): Record<
-  VisionProvider,
-  { available: boolean; model: string; keyVar: string }
-> {
-  return {
-    anthropic: {
-      available: !!process.env[API_KEY_VARS.anthropic],
-      model: DEFAULT_MODELS.anthropic,
-      keyVar: API_KEY_VARS.anthropic,
-    },
-    openai: {
-      available: !!process.env[API_KEY_VARS.openai],
-      model: DEFAULT_MODELS.openai,
-      keyVar: API_KEY_VARS.openai,
-    },
-    xai: {
-      available: !!process.env[API_KEY_VARS.xai],
-      model: DEFAULT_MODELS.xai,
-      keyVar: API_KEY_VARS.xai,
-    },
-    gemini: {
-      available: !!process.env[API_KEY_VARS.gemini],
-      model: DEFAULT_MODELS.gemini,
-      keyVar: API_KEY_VARS.gemini,
-    },
-  };
-}
-
-// ============================================================================
-// Provider implementations
-// ============================================================================
-
-async function analyzeWithAnthropic(
-  imageBase64: string,
-  mediaType: string,
-  prompt: string,
-  model: string,
-  options: VisionOptions
-): Promise<VisionResult> {
-  const apiKey = getApiKey("anthropic");
-  const body: Record<string, unknown> = {
-    model,
-    max_tokens: options.maxTokens ?? 1024,
-    messages: [
-      {
-        role: "user",
-        content: [
-          {
-            type: "image",
-            source: { type: "base64", media_type: mediaType, data: imageBase64 },
-          },
-          { type: "text", text: prompt },
-        ],
-      },
-    ],
-  };
-  if (options.systemPrompt) {
-    body.system = options.systemPrompt;
-  }
-
-  const response = await fetch(BASE_URLS.anthropic, {
-    method: "POST",
-    headers: {
-      "x-api-key": apiKey,
-      "anthropic-version": "2023-06-01",
-      "content-type": "application/json",
-    },
-    body: JSON.stringify(body),
-  });
-
-  if (!response.ok) {
-    const err = await response.text();
-    throw new Error(`Anthropic API error ${response.status}: ${err}`);
-  }
-
-  const data = (await response.json()) as {
-    content: Array<{ type: string; text: string }>;
-    usage: { input_tokens: number; output_tokens: number };
-  };
-
-  return {
-    text: data.content[0].text,
-    provider: "anthropic",
-    model,
-    inputTokens: data.usage?.input_tokens,
-    outputTokens: data.usage?.output_tokens,
-  };
-}
-
-async function analyzeWithOpenAICompat(
-  provider: "openai" | "xai",
-  imageBase64: string,
-  mediaType: string,
-  prompt: string,
-  model: string,
-  options: VisionOptions
-): Promise<VisionResult> {
-  const apiKey = getApiKey(provider);
-  const messages: unknown[] = [];
-
-  if (options.systemPrompt) {
-    messages.push({ role: "system", content: options.systemPrompt });
-  }
-
-  messages.push({
-    role: "user",
-    content: [
-      {
-        type: "image_url",
-        image_url: {
-          url: `data:${mediaType};base64,${imageBase64}`,
-          detail: "high",
-        },
-      },
-      { type: "text", text: prompt },
-    ],
-  });
-
-  const body = {
-    model,
-    max_tokens: options.maxTokens ?? 1024,
-    messages,
-  };
-
-  const response = await fetch(BASE_URLS[provider], {
-    method: "POST",
-    headers: {
-      Authorization: `Bearer ${apiKey}`,
-      "content-type": "application/json",
-    },
-    body: JSON.stringify(body),
-  });
-
-  if (!response.ok) {
-    const err = await response.text();
-    throw new Error(
-      `${provider.toUpperCase()} API error ${response.status}: ${err}`
-    );
-  }
-
-  const data = (await response.json()) as {
-    choices: Array<{ message: { content: string } }>;
-    usage: { prompt_tokens: number; completion_tokens: number };
-  };
-
-  return {
-    text: data.choices[0].message.content,
-    provider,
-    model,
-    inputTokens: data.usage?.prompt_tokens,
-    outputTokens: data.usage?.completion_tokens,
-  };
-}
-
-async function analyzeWithGemini(
-  imageBase64: string,
-  mediaType: string,
-  prompt: string,
-  model: string,
-  options: VisionOptions
-): Promise<VisionResult> {
-  const apiKey = getApiKey("gemini");
-  const url = `${BASE_URLS.gemini}/${model}:generateContent?key=${apiKey}`;
-
-  const body: Record<string, unknown> = {
-    contents: [
-      {
-        parts: [
-          { inlineData: { mimeType: mediaType, data: imageBase64 } },
-          { text: prompt },
-        ],
-      },
-    ],
-    generationConfig: {
-      maxOutputTokens: options.maxTokens ?? 1024,
-      ...(options.jsonMode ? { responseMimeType: "application/json" } : {}),
-    },
-  };
-
-  if (options.systemPrompt) {
-    body.systemInstruction = { parts: [{ text: options.systemPrompt }] };
-  }
-
-  const response = await fetch(url, {
-    method: "POST",
-    headers: { "content-type": "application/json" },
-    body: JSON.stringify(body),
-  });
-
-  if (!response.ok) {
-    const err = await response.text();
-    throw new Error(`Gemini API error ${response.status}: ${err}`);
-  }
-
-  const data = (await response.json()) as {
-    candidates: Array<{
-      content: { parts: Array<{ text: string }> };
-    }>;
-    usageMetadata?: { promptTokenCount: number; candidatesTokenCount: number };
-  };
-
-  return {
-    text: data.candidates[0].content.parts[0].text,
-    provider: "gemini",
-    model,
-    inputTokens: data.usageMetadata?.promptTokenCount,
-    outputTokens: data.usageMetadata?.candidatesTokenCount,
-  };
-}
-
-// ============================================================================
-// Main entry point
-// ============================================================================
-
-/**
- * Analyze an image with a vision-capable model.
- * Auto-detects provider from env vars unless options.provider is specified.
- */
-export async function analyzeImage(
-  imageBase64: string,
-  mediaType: string,
-  prompt: string,
-  options: VisionOptions = {}
-): Promise<VisionResult> {
-  const provider = options.provider ?? detectProvider();
-  if (!provider) {
-    throw new Error(
-      "No AI provider API key found. Set one of: ANTHROPIC_API_KEY, OPENAI_API_KEY, XAI_API_KEY, GEMINI_API_KEY"
-    );
-  }
-
-  const model = options.model ?? DEFAULT_MODELS[provider];
-  const jsonPrompt =
-    options.jsonMode
-      ? `${prompt}\n\nIMPORTANT: Respond ONLY with valid JSON. No markdown, no code fences, no commentary.`
-      : prompt;
-
-  switch (provider) {
-    case "anthropic":
-      return analyzeWithAnthropic(
-        imageBase64,
-        mediaType,
-        jsonPrompt,
-        model,
-        options
-      );
-    case "openai":
-    case "xai":
-      return analyzeWithOpenAICompat(
-        provider,
-        imageBase64,
-        mediaType,
-        jsonPrompt,
-        model,
-        options
-      );
-    case "gemini":
-      return analyzeWithGemini(imageBase64, mediaType, jsonPrompt, model, options);
-    default: {
-      const _exhaustive: never = provider;
-      throw new Error(`Unknown provider: ${_exhaustive}`);
-    }
-  }
-}

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

@@ -1,55 +0,0 @@
----
-name: ad-creative-pack
-description: Generate paid-ad copy, creative concepts, image prompts, audience angles, and test matrices.
-kind: instruction
----
-
-# Ad Creative Pack
-
-Generate a paid-ad launch package for Meta, Google, and LinkedIn.
-
-## Requirements
-
-None. This is an instruction skill: it is prose an agent follows, so it needs no
-credentials, no network access, and no local runtime.
-
-## Usage
-
-Ask an agent for the deliverables below and give it the inputs. Reading this file
-IS the invocation; `skills run` refuses instruction skills on purpose.
-
-## Inputs
-
-| Input | Description | Default |
-|--------|-------------|---------|
-| `product` | Product, service, or campaign brief. Positional text also works. | required |
-| `audience` | Target buyer or segment. | software teams |
-| `offer` | Campaign promise or offer. | derived from product |
-| `goal` | Conversion goal. | book demos |
-| `platforms` | Comma-separated platforms. | Meta, Google, LinkedIn |
-| `tone` | `direct`, `premium`, `friendly`, or `technical`. | direct |
-
-## Deliverables
-
-- `platform-copy.md`
-- `ad-copy.json`
-- `creative-concepts.md`
-- `image-prompts.md`
-- `audience-angles.csv`
-- `test-matrix.csv`
-- `launch-checklist.md`
-- `manifest.json`
-
-## Method
-
-1. Restate the offer, audience and platform mix in one line, and name the single
-   conversion action every asset drives toward.
-2. Draft 3-5 distinct creative concepts. Each needs a different *angle* (pain,
-   aspiration, proof, novelty, objection), not a different adjective.
-3. For each platform, write copy to that platform's real limits — headline and
-   primary text lengths differ, so do not reuse one block everywhere.
-4. Write image prompts as briefs a designer or an image model could act on:
-   subject, composition, mood, colour, text placement.
-5. Build the test matrix so exactly one variable changes per row; a matrix that
-   varies two things at once cannot attribute a win.
-6. Close with a launch checklist covering tracking, naming, and budget split.

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

@@ -1,10 +0,0 @@
-{
-  "name": "ad-creative-pack",
-  "version": "0.1.0",
-  "private": true,
-  "description": "Hosted premium paid ad creative artifact generator",
-  "type": "module",
-  "skills": {
-    "kind": "instruction"
-  }
-}

package/skills/analyze-data/CLAUDE.md

@@ -1,16 +0,0 @@
-# analyze-data
-
-Data science insights for CSV and JSON.
-
-## Development
-
-- Runtime: Bun
-- Use `bun install` to install dependencies
-- Use `bun run dev` to run in development
-- Use `bun run build` to build for production
-
-## Structure
-
-- `src/` - Source code
-- `bin/cli.ts` - CLI entry point using Commander.js
-- `SKILL.md` - Skill definition and prompts

package/skills/analyze-data/SKILL.md

@@ -1,112 +0,0 @@
----
-name: analyze-data
-version: 0.1.0
-description: Instant data science insights for CSV and JSON files with statistical summaries, quality audits, and trend detection
-author: Hasna
-category: Data & Analytics
-tags:
-  - data
-  - analytics
-  - statistics
-  - csv
-  - json
-  - insights
-  - quality-assurance
-credits: 5
----
-
-# Analyze Data
-
-Instant data science insights for your CSV and JSON files. Automatically generates comprehensive reports including statistical summaries, data quality audits, correlation matrices, and trend detection without sending your data to external APIs.
-
-> **This is a CLI skill.** It requires the `skills` CLI to execute. Install it with `npm install -g @hasna/skills`, then run the commands below.
-
-## Features
-
-- **Statistical Profiling**: Calculates mean, median, mode, standard deviation, quartiles, and custom percentiles for all numeric columns.
-- **Data Quality Audit**: Detects missing values, duplicates, mixed data types, and outliers to assess dataset health.
-- **Correlation Discovery**: Identifies relationships between variables using Pearson correlation coefficients.
-- **Trend Detection**: Automatically spots time-series patterns, seasonality, and growth trends.
-- **Visualization Ready**: Recommends the best chart types (histograms, line charts, scatter plots) based on data distribution.
-- **Multi-Format Reports**: Exports findings as interactive HTML, structured JSON, or readable Markdown.
-- **Scalable**: Efficiently processes large files using stream processing and sampling options.
-
-## Usage
-
-```bash
-skills run analyze-data -- <file-path> [options]
-```
-
-## Options
-
-| Option          | Description                                                  | Default              |
-| --------------- | ------------------------------------------------------------ | -------------------- |
-| `--format`      | Output format: `markdown`, `json`, or `html`                 | `markdown`           |
-| `--output`      | Save report to file path                                     | (prints to console)  |
-| `--correlations`| Calculate correlation matrix for numeric columns             | `false`              |
-| `--outliers`    | Detect and report outliers using IQR method                  | `false`              |
-| `--trends`      | Analyze trends if time-series data is detected               | `false`              |
-| `--sample`      | Analyze only the first N rows (for large files)              | (all rows)           |
-| `--percentiles` | Custom percentiles to calculate (comma-separated)            | `25,50,75,90,95`     |
-| `--verbose`     | Show detailed processing logs                                | `false`              |
-
-## Examples
-
-### Quick Health Check
-```bash
-# Analyze a CSV file and print report to console
-skills run analyze-data -- sales-data.csv
-```
-
-### Deep Dive Analysis
-```bash
-# Full analysis with correlations, outliers, and HTML report
-skills run analyze-data -- dataset.csv \
-  --correlations \
-  --outliers \
-  --format html \
-  --output report.html
-```
-
-### Large File Sampling
-```bash
-# Quickly analyze the first 10,000 rows of a large dataset
-skills run analyze-data -- huge-log-file.json \
-  --sample 10000 \
-  --verbose
-```
-
-### JSON Export for Pipelines
-```bash
-# Generate JSON stats for downstream processing
-skills run analyze-data -- metrics.json \
-  --format json \
-  --output analysis.json
-```
-
-## Report Sections
-
-1.  **Dataset Overview**: File size, row/column counts, memory usage.
-2.  **Column Analysis**: Data types, unique values, null counts, and sample data.
-3.  **Statistical Summary**: Detailed metrics for numeric columns (mean, std dev, etc.).
-4.  **Data Quality**: Quality score (0-100), missing data summary, and duplicate detection.
-5.  **Correlations**: (Optional) Matrix of relationships between variables.
-6.  **Trends**: (Optional) Time-series patterns and anomalies.
-7.  **Visualization Recommendations**: Suggested charts for exploring the data.
-8.  **Key Insights**: Auto-generated observations about the dataset.
-
-## Supported Formats
-
-- **CSV**: Standard comma-separated, TSV, and custom delimiters.
-- **JSON**: Arrays of objects or objects containing data arrays.
-
-## Performance
-
-- **Small (<10MB)**: Instant analysis.
-- **Medium (10-100MB)**: 2-10 seconds.
-- **Large (>100MB)**: Use `--sample` for best performance.
-
-## Requirements
-
-- Bun runtime.
-- No external API keys required (runs locally).

package/skills/analyze-data/package.json

@@ -1,23 +0,0 @@
-{
-  "name": "analyze-data",
-  "version": "0.1.0",
-  "description": "Data science insights for CSV and JSON",
-  "type": "module",
-  "bin": {
-    "analyze-data": "./src/index.ts"
-  },
-  "scripts": {
-    "dev": "bun run src/index.ts",
-    "build": "bun build src/index.ts --outdir dist --target node",
-    "start": "bun run src/index.ts"
-  },
-  "dependencies": {},
-  "devDependencies": {
-    "@types/bun": "latest",
-    "typescript": "^5.7.0"
-  },
-  "publishConfig": {
-    "registry": "https://registry.npmjs.org",
-    "access": "restricted"
-  }
-}