@hasna/skills 0.1.30 → 0.1.31

package/dist/lib/auth-store.d.ts

@@ -9,5 +9,5 @@ export declare function getAuthConfig(): AuthConfig | null;
 export declare function saveAuthConfig(config: AuthConfig): void;
 export declare function clearAuthConfig(): void;
 export declare function getApiKey(): string | null;
-export declare function normalizePlatformApiOrigin(apiUrl: string): string;
+export declare function normalizeSkillsApiOrigin(apiUrl: string): string;
 export declare function getApiUrl(): string;

package/dist/lib/config.d.ts

@@ -9,6 +9,7 @@
  * Values from the project config override global config.
  */
 export interface SkillsConfig {
+    mode?: "local" | "skills.md";
     defaultAgent?: "claude" | "codex" | "gemini" | "pi" | "opencode" | "all";
     defaultScope?: "global" | "project";
     format?: "compact" | "json" | "csv";

package/dist/lib/discovery.d.ts

@@ -0,0 +1,23 @@
+import type { SkillMeta } from "./registry-types.js";
+import { type PublicSkillPricing } from "./pricing.js";
+export interface CompactSkillDiscovery {
+    name: string;
+    category: string;
+    pricing: PublicSkillPricing;
+}
+export type PublicSkillDiscovery<T extends SkillMeta = SkillMeta> = Omit<T, "description" | "tags"> & {
+    description: string;
+    tags: string[];
+    pricing: PublicSkillPricing;
+};
+export declare function getCompactSkillDiscovery(skill: SkillMeta): CompactSkillDiscovery;
+export declare function getPublicSkillDiscovery<T extends SkillMeta>(skill: T): PublicSkillDiscovery<T>;
+export declare function publicDiscoveryPriceLabel(skill: {
+    name: string;
+    pricing?: PublicSkillPricing;
+}): string;
+export declare function publicDiscoveryTags(tags: string[]): string[];
+export declare function sanitizePublicDiscoveryText(text: string): string;
+export declare function publicDiscoveryEnvVars(skillName: string, envVars: string[]): string[];
+export declare function publicDiscoveryDependencies(skillName: string, dependencies: Record<string, string>): Record<string, string>;
+export declare function publicDiscoveryDocumentation(skill: SkillMeta, documentation: string | null): string | null;

package/dist/lib/pricing.d.ts

@@ -0,0 +1,89 @@
+export type BillingTier = "free" | "premium";
+export interface SkillPricing {
+    slug: string;
+    displayName: string;
+    tier: BillingTier;
+    costCents: number;
+    providers: string[];
+    description: string;
+    provider?: string;
+    model?: string;
+    costMicros?: number;
+}
+export interface PublicSkillPricing {
+    tier: BillingTier;
+    billingUnit: "run" | "image" | "second" | "character" | "song" | "thousand_tokens" | "article";
+    costCents: number;
+    formattedCost: string;
+    formattedUnitCost?: string;
+    unitCount?: number;
+    estimated: boolean;
+    quoteDependsOnInput: boolean;
+    quoteRequired: boolean;
+    description: string;
+}
+export type SkillCatalogBillingMode = "free" | "credits" | "subscription" | "metered";
+export interface SkillCatalogBillingFields {
+    billingMode: SkillCatalogBillingMode;
+    creditsPerExecution: number;
+}
+export type MediaModality = "image" | "video" | "audio" | "music";
+export type MediaProvider = "openai" | "minimax" | "gemini" | "seedance";
+type PriceUnit = "image" | "second" | "character" | "song" | "thousand_tokens";
+interface MediaPrice {
+    slug: MediaModality;
+    provider: MediaProvider;
+    model: string;
+    unit: PriceUnit;
+    costMicros: number;
+    description: string;
+    default?: boolean;
+    resolution?: string;
+    durationSeconds?: number;
+}
+export declare const MUSIC_ALBUM_SLUG = "music-album";
+export declare const MUSIC_ALBUM_SONG_COUNTS: readonly [7, 14, 21];
+export declare const PREMIUM_SKILLS: SkillPricing[];
+export declare const ARTICLE_GENERATION_SLUG = "blog-article";
+export declare const ARTICLE_MAX_COUNT = 12;
+export declare const ARTICLE_COUNT_ERROR = "Count must be an integer between 1 and 12.";
+declare const ARTICLE_TONES: readonly ["professional", "casual", "technical", "friendly"];
+declare const ARTICLE_LENGTHS: readonly ["short", "medium", "long"];
+export type ArticleTone = typeof ARTICLE_TONES[number];
+export type ArticleLength = typeof ARTICLE_LENGTHS[number];
+export interface BlogArticleRunOptions {
+    topic?: string;
+    audience?: string;
+    tone: ArticleTone;
+    length: ArticleLength;
+    seo: boolean;
+    outline?: string;
+    count: number;
+}
+export type BlogArticleValidationResult = {
+    ok: true;
+    options: BlogArticleRunOptions;
+    input: Record<string, unknown>;
+    errors: [];
+} | {
+    ok: false;
+    input: Record<string, unknown>;
+    errors: string[];
+};
+export declare const MEDIA_GENERATION_PRICES: MediaPrice[];
+export declare function getSkillPricing(slug: string): SkillPricing | null;
+export declare function isPremiumSkill(slug: string): boolean;
+export declare function getSkillCostCents(slug: string): number;
+export declare function getSkillRunPricing(slug: string, input?: unknown, args?: string[]): SkillPricing | null;
+export declare function validateBlogArticleRunOptions(input?: unknown, args?: string[], validation?: {
+    requireTopic?: boolean;
+}): BlogArticleValidationResult;
+export declare function getSkillRunCostCents(slug: string, input?: unknown, args?: string[]): number;
+export declare function getPublicSkillPricing(slug: string, input?: unknown, args?: string[]): PublicSkillPricing;
+export declare function getSkillCatalogBillingFields(slug: string, input?: unknown, args?: string[]): SkillCatalogBillingFields;
+export declare function formatPublicPricing(slug: string, input?: unknown, args?: string[]): string;
+export declare function isMediaGenerationSkill(slug: string): boolean;
+export declare function getMediaProviders(slug: MediaModality): string[];
+export declare function formatCost(cents: number): string;
+export declare function getAllPremiumSlugs(): string[];
+export {};

package/dist/lib/remote-client.d.ts

@@ -0,0 +1,18 @@
+import { type RemoteSkillRunContract } from "./remote-run-contract.js";
+export declare class RemoteSkillsClient {
+    private apiUrl;
+    private apiKey;
+    constructor(apiKey: string, apiUrl?: string);
+    private request;
+    listSkills(): Promise<any[]>;
+    getSkillMd(slug: string): Promise<string | null>;
+    getSkill(slug: string): Promise<any | null>;
+    quoteSkill(slug: string, input?: Record<string, unknown>, args?: string[]): Promise<any>;
+    submitRun(slug: string, input?: Record<string, unknown>, args?: string[]): Promise<RemoteSkillRunContract>;
+    getRun(runId: string): Promise<RemoteSkillRunContract | null>;
+    getRunLogs(runId: string): Promise<any[]>;
+    listRuns(limit?: number): Promise<any[]>;
+    getRunArtifacts(runId: string): Promise<any[]>;
+    downloadRunArtifact(runId: string, artifactId: string): Promise<Response>;
+}
+export declare function createRemoteSkillsClient(): RemoteSkillsClient | null;

package/dist/lib/remote-run-contract.d.ts

@@ -0,0 +1,29 @@
+import type { PublicSkillPricing } from "./pricing";
+export declare const REMOTE_SKILL_RUN_CONTRACT_VERSION: 1;
+export interface RemoteSkillRunContract {
+    contractVersion: typeof REMOTE_SKILL_RUN_CONTRACT_VERSION;
+    id?: string;
+    skill?: string;
+    requestedSlug?: string;
+    status?: string;
+    exitCode?: number;
+    correlationId?: string;
+    costCents?: number;
+    cost?: string;
+    pricing?: PublicSkillPricing;
+    createdAt?: string;
+    startedAt?: string;
+    completedAt?: string;
+    durationMs?: number;
+    outputType?: string;
+    outputPreview?: unknown;
+    errorCode?: string;
+    errorMessage?: string;
+    creditsUsed?: number;
+    error?: string;
+    code?: string;
+    details?: unknown;
+    balance?: string;
+    balanceCents?: number;
+}
+export declare function normalizeRemoteSkillRunContract(payload: unknown, fallbackSkill?: string): RemoteSkillRunContract;

package/dist/mcp/http.d.ts

@@ -1,5 +1,5 @@
 import { createServer, type IncomingMessage, type ServerResponse } from "node:http";
-export declare const MCP_HTTP_DEFAULT_PORT = 8879;
+export declare const MCP_HTTP_DEFAULT_PORT = 8836;
 export declare const MCP_HTTP_SERVICE_NAME = "skills";
 export declare function isMcpHttpMode(argv?: string[]): boolean;
 export declare function isMcpStdioMode(argv?: string[]): boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/skills",
-  "version": "0.1.30",
+  "version": "0.1.31",
   "description": "Skills library for AI coding agents",
   "type": "module",
   "bin": {
@@ -36,17 +36,6 @@
     "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",
     "postinstall": "mkdir -p $HOME/.hasna/skills/custom 2>/dev/null || true"
   },
@@ -70,11 +59,10 @@
   "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",
@@ -82,6 +70,7 @@
     "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": {

package/skills/apidocs/.claude/settings.json

@@ -0,0 +1,5 @@
+{
+  "env": {
+    "CLAUDE_CODE_TASK_LIST_ID": "service-apidocs-dev"
+  }
+}

package/skills/security-audit/src/index.ts

@@ -53,7 +53,7 @@ const PATTERNS = [
   { name: "Eval Usage", regex: /eval\(/, severity: "MEDIUM" },
   {
     name: "Insecure HTTP",
-    regex: /http:\/\/(?!localhost(?:[:/$]|$)|127\.0\.0\.1(?:[:/$]|$)|0\.0\.0\.0(?:[:/$]|$))/,
+    regex: /http:\/\/(?!localhost(?:[:/$]|$)|127\.0\.0\.1(?:[:/$]|$)|0\.0\.0\.0(?:[:/$]|$)|\$\{)/,
     severity: "LOW",
   },
 ];

package/skills/skill-academic-journal-matcher/bin/cli.ts

@@ -1,34 +0,0 @@
-#!/usr/bin/env bun
-
-import { Command } from "commander";
-import { homedir } from "os";
-import { join } from "path";
-
-function getDataDir(): string {
-  return process.env.DATA_DIR || join(homedir(), ".skill", "skill-academic-journal-matcher");
-}
-
-const program = new Command();
-
-program
-  .name("skill-academic-journal-matcher")
-  .description("Academic Journal Matcher skill")
-  .version("0.1.0");
-
-program
-  .command("run")
-  .description("Run the skill")
-  .option("-o, --output <path>", "Output directory", join(getDataDir(), "output"))
-  .allowUnknownOption(true)
-  .action(async (options, command) => {
-    try {
-      const args = command.args;
-      process.env.DATA_DIR = process.env.DATA_DIR || getDataDir();
-      await import("../src/index.js");
-    } catch (err) {
-      console.error(`Error: ${err instanceof Error ? err.message : err}`);
-      process.exit(1);
-    }
-  });
-
-program.parse();

package/skills/skill-action-item-router/bin/cli.ts

@@ -1,34 +0,0 @@
-#!/usr/bin/env bun
-
-import { Command } from "commander";
-import { homedir } from "os";
-import { join } from "path";
-
-function getDataDir(): string {
-  return process.env.DATA_DIR || join(homedir(), ".skill", "skill-action-item-router");
-}
-
-const program = new Command();
-
-program
-  .name("skill-action-item-router")
-  .description("Action Item Router skill")
-  .version("0.1.0");
-
-program
-  .command("run")
-  .description("Run the skill")
-  .option("-o, --output <path>", "Output directory", join(getDataDir(), "output"))
-  .allowUnknownOption(true)
-  .action(async (options, command) => {
-    try {
-      const args = command.args;
-      process.env.DATA_DIR = process.env.DATA_DIR || getDataDir();
-      await import("../src/index.js");
-    } catch (err) {
-      console.error(`Error: ${err instanceof Error ? err.message : err}`);
-      process.exit(1);
-    }
-  });
-
-program.parse();

package/skills/skill-ad-creative-generator/bin/cli.ts

@@ -1,34 +0,0 @@
-#!/usr/bin/env bun
-
-import { Command } from "commander";
-import { homedir } from "os";
-import { join } from "path";
-
-function getDataDir(): string {
-  return process.env.DATA_DIR || join(homedir(), ".skill", "skill-ad-creative-generator");
-}
-
-const program = new Command();
-
-program
-  .name("skill-ad-creative-generator")
-  .description("Ad Creative Generator skill")
-  .version("0.1.0");
-
-program
-  .command("run")
-  .description("Run the skill")
-  .option("-o, --output <path>", "Output directory", join(getDataDir(), "output"))
-  .allowUnknownOption(true)
-  .action(async (options, command) => {
-    try {
-      const args = command.args;
-      process.env.DATA_DIR = process.env.DATA_DIR || getDataDir();
-      await import("../src/index.js");
-    } catch (err) {
-      console.error(`Error: ${err instanceof Error ? err.message : err}`);
-      process.exit(1);
-    }
-  });
-
-program.parse();

package/skills/skill-advanced-math/bin/cli.ts

@@ -1,34 +0,0 @@
-#!/usr/bin/env bun
-
-import { Command } from "commander";
-import { homedir } from "os";
-import { join } from "path";
-
-function getDataDir(): string {
-  return process.env.DATA_DIR || join(homedir(), ".skill", "skill-advanced-math");
-}
-
-const program = new Command();
-
-program
-  .name("skill-advanced-math")
-  .description("Advanced Math skill")
-  .version("0.1.0");
-
-program
-  .command("run")
-  .description("Run the skill")
-  .option("-o, --output <path>", "Output directory", join(getDataDir(), "output"))
-  .allowUnknownOption(true)
-  .action(async (options, command) => {
-    try {
-      const args = command.args;
-      process.env.DATA_DIR = process.env.DATA_DIR || getDataDir();
-      await import("../src/index.js");
-    } catch (err) {
-      console.error(`Error: ${err instanceof Error ? err.message : err}`);
-      process.exit(1);
-    }
-  });
-
-program.parse();

package/skills/skill-analyze-data/bin/cli.ts

@@ -1,19 +0,0 @@
-#!/usr/bin/env bun
-import { Command } from "commander";
-
-const program = new Command();
-
-program
-  .name("skill-analyze-data")
-  .description("Data science insights for CSV and JSON")
-  .version("0.1.0");
-
-program
-  .command("run", { isDefault: true })
-  .description("Run the skill")
-  .allowUnknownOption(true)
-  .action(async () => {
-    await import("../src/index.js");
-  });
-
-program.parse();

package/skills/skill-anomaly-investigator/bin/cli.ts

@@ -1,34 +0,0 @@
-#!/usr/bin/env bun
-
-import { Command } from "commander";
-import { homedir } from "os";
-import { join } from "path";
-
-function getDataDir(): string {
-  return process.env.DATA_DIR || join(homedir(), ".skill", "skill-anomaly-investigator");
-}
-
-const program = new Command();
-
-program
-  .name("skill-anomaly-investigator")
-  .description("Anomaly Investigator skill")
-  .version("0.1.0");
-
-program
-  .command("run")
-  .description("Run the skill")
-  .option("-o, --output <path>", "Output directory", join(getDataDir(), "output"))
-  .allowUnknownOption(true)
-  .action(async (options, command) => {
-    try {
-      const args = command.args;
-      process.env.DATA_DIR = process.env.DATA_DIR || getDataDir();
-      await import("../src/index.js");
-    } catch (err) {
-      console.error(`Error: ${err instanceof Error ? err.message : err}`);
-      process.exit(1);
-    }
-  });
-
-program.parse();

package/skills/skill-api-test-suite/bin/cli.ts

@@ -1,34 +0,0 @@
-#!/usr/bin/env bun
-
-import { Command } from "commander";
-import { homedir } from "os";
-import { join } from "path";
-
-function getDataDir(): string {
-  return process.env.DATA_DIR || join(homedir(), ".skill", "skill-api-test-suite");
-}
-
-const program = new Command();
-
-program
-  .name("skill-api-test-suite")
-  .description("Api Test Suite skill")
-  .version("0.1.0");
-
-program
-  .command("run")
-  .description("Run the skill")
-  .option("-o, --output <path>", "Output directory", join(getDataDir(), "output"))
-  .allowUnknownOption(true)
-  .action(async (options, command) => {
-    try {
-      const args = command.args;
-      process.env.DATA_DIR = process.env.DATA_DIR || getDataDir();
-      await import("../src/index.js");
-    } catch (err) {
-      console.error(`Error: ${err instanceof Error ? err.message : err}`);
-      process.exit(1);
-    }
-  });
-
-program.parse();

package/skills/skill-apidocs/bin/cli.ts

@@ -1,87 +0,0 @@
-#!/usr/bin/env bun
-
-import { Command } from 'commander';
-import { add } from '../src/commands/add.js';
-import { query } from '../src/commands/query.js';
-import { list } from '../src/commands/list.js';
-import { sync } from '../src/commands/sync.js';
-import { remove } from '../src/commands/remove.js';
-import { endpoints } from '../src/commands/endpoints.js';
-
-const program = new Command();
-
-program
-  .name('service-apidocs')
-  .description('Agentic web crawler for API documentation indexing and semantic search')
-  .version('0.3.0');
-
-// Add command
-program
-  .command('add <website-url>')
-  .description('Add documentation from a website URL')
-  .option('-n, --name <name>', 'Custom library name')
-  .option('-m, --max-pages <number>', 'Maximum pages to crawl', (v) => parseInt(v, 10))
-  .action(async (websiteUrl: string, options) => {
-    await add(websiteUrl, options);
-  });
-
-// Query command
-program
-  .command('query <library> <question>')
-  .description('Query documentation semantically')
-  .option('--tokens <number>', 'Maximum tokens in response', (v) => parseInt(v, 10))
-  .option('--top-k <number>', 'Number of results to retrieve', (v) => parseInt(v, 10))
-  .option('--json', 'Output as JSON')
-  .action(async (library: string, question: string, options) => {
-    await query(library, question, {
-      library,
-      question,
-      tokens: options.tokens,
-      topK: options.topK,
-      json: options.json,
-    });
-  });
-
-// List command
-program
-  .command('list')
-  .description('List all indexed libraries')
-  .action(async () => {
-    await list();
-  });
-
-// Sync command
-program
-  .command('sync [library]')
-  .description('Re-crawl and sync a library\'s documentation')
-  .option('--all', 'Sync all indexed libraries')
-  .option('-m, --max-pages <number>', 'Maximum pages to crawl', (v) => parseInt(v, 10))
-  .action(async (library: string | undefined, options) => {
-    await sync(library, options);
-  });
-
-// Remove command
-program
-  .command('remove <library>')
-  .description('Remove a library from the index')
-  .action(async (library: string) => {
-    await remove(library);
-  });
-
-// Endpoints command
-program
-  .command('endpoints <library>')
-  .description('List API endpoints from indexed documentation')
-  .option('--json', 'Output as JSON')
-  .option('--group-by <type>', 'Group by: resource (default) or method', 'resource')
-  .option('--filter <method>', 'Filter by HTTP method (GET, POST, PUT, DELETE, etc.)')
-  .action(async (library: string, options) => {
-    await endpoints(library, {
-      json: options.json,
-      groupBy: options.groupBy as 'resource' | 'method',
-      filter: options.filter,
-    });
-  });
-
-// Parse and run
-program.parse();

package/skills/skill-audio-cleanup-lab/bin/cli.ts

@@ -1,6 +0,0 @@
-#!/usr/bin/env bun
-import { Command } from "commander";
-const program = new Command();
-program.name("skill-audio-cleanup-lab").description("Professional audio cleanup recipes").version("0.1.0");
-program.command("run", { isDefault: true }).description("Run the skill").allowUnknownOption(true).action(async () => { await import("../src/index.js"); });
-program.parse();

package/skills/skill-audiobook-chapter-proofer/bin/cli.ts

@@ -1,34 +0,0 @@
-#!/usr/bin/env bun
-
-import { Command } from "commander";
-import { homedir } from "os";
-import { join } from "path";
-
-function getDataDir(): string {
-  return process.env.DATA_DIR || join(homedir(), ".skill", "skill-audiobook-chapter-proofer");
-}
-
-const program = new Command();
-
-program
-  .name("skill-audiobook-chapter-proofer")
-  .description("Audiobook Chapter Proofer skill")
-  .version("0.1.0");
-
-program
-  .command("run")
-  .description("Run the skill")
-  .option("-o, --output <path>", "Output directory", join(getDataDir(), "output"))
-  .allowUnknownOption(true)
-  .action(async (options, command) => {
-    try {
-      const args = command.args;
-      process.env.DATA_DIR = process.env.DATA_DIR || getDataDir();
-      await import("../src/index.js");
-    } catch (err) {
-      console.error(`Error: ${err instanceof Error ? err.message : err}`);
-      process.exit(1);
-    }
-  });
-
-program.parse();

package/skills/skill-banner-ad-suite/bin/cli.ts

@@ -1,34 +0,0 @@
-#!/usr/bin/env bun
-
-import { Command } from "commander";
-import { homedir } from "os";
-import { join } from "path";
-
-function getDataDir(): string {
-  return process.env.DATA_DIR || join(homedir(), ".skill", "skill-banner-ad-suite");
-}
-
-const program = new Command();
-
-program
-  .name("skill-banner-ad-suite")
-  .description("Banner Ad Suite skill")
-  .version("0.1.0");
-
-program
-  .command("run")
-  .description("Run the skill")
-  .option("-o, --output <path>", "Output directory", join(getDataDir(), "output"))
-  .allowUnknownOption(true)
-  .action(async (options, command) => {
-    try {
-      const args = command.args;
-      process.env.DATA_DIR = process.env.DATA_DIR || getDataDir();
-      await import("../src/index.js");
-    } catch (err) {
-      console.error(`Error: ${err instanceof Error ? err.message : err}`);
-      process.exit(1);
-    }
-  });
-
-program.parse();