@hasna/skills 0.0.3 → 0.1.1

package/dist/index.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/lib/installer.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Skill installer - handles copying skills to user projects
+ */
+export interface InstallResult {
+    skill: string;
+    success: boolean;
+    error?: string;
+    path?: string;
+}
+export interface InstallOptions {
+    targetDir?: string;
+    overwrite?: boolean;
+}
+/**
+ * Get the path to a skill in the package
+ */
+export declare function getSkillPath(name: string): string;
+/**
+ * Check if a skill exists in the package
+ */
+export declare function skillExists(name: string): boolean;
+/**
+ * Install a single skill to the target directory
+ */
+export declare function installSkill(name: string, options?: InstallOptions): InstallResult;
+/**
+ * Install multiple skills
+ */
+export declare function installSkills(names: string[], options?: InstallOptions): InstallResult[];
+/**
+ * Get list of installed skills in a directory
+ */
+export declare function getInstalledSkills(targetDir?: string): string[];
+/**
+ * Remove an installed skill
+ */
+export declare function removeSkill(name: string, targetDir?: string): boolean;
+export type AgentTarget = "claude" | "codex" | "gemini";
+export type AgentScope = "global" | "project";
+export declare const AGENT_TARGETS: AgentTarget[];
+/**
+ * Resolve an agent argument ("all" or a specific agent name) to a list of AgentTarget values.
+ * Throws if the agent name is not recognized.
+ */
+export declare function resolveAgents(agentArg: string): AgentTarget[];
+export interface AgentInstallOptions {
+    agent: AgentTarget;
+    scope?: AgentScope;
+    projectDir?: string;
+}
+/**
+ * Get the skills directory for a given agent and scope
+ */
+export declare function getAgentSkillsDir(agent: AgentTarget, scope?: AgentScope, projectDir?: string): string;
+/**
+ * Get the full path where a skill's SKILL.md would be installed for an agent
+ */
+export declare function getAgentSkillPath(name: string, agent: AgentTarget, scope?: AgentScope, projectDir?: string): string;
+/**
+ * Install a skill's SKILL.md for a specific agent
+ * If the skill has no SKILL.md, one will be generated using the provided generator function
+ */
+export declare function installSkillForAgent(name: string, options: AgentInstallOptions, generateSkillMd?: (name: string) => string | null): InstallResult;
+/**
+ * Remove a skill from an agent's skill directory
+ */
+export declare function removeSkillForAgent(name: string, options: AgentInstallOptions): boolean;

package/dist/lib/installer.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/lib/registry.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Skill registry - metadata about all available skills
+ */
+export interface SkillMeta {
+    name: string;
+    displayName: string;
+    description: string;
+    category: string;
+    tags: string[];
+}
+export declare const CATEGORIES: readonly ["Development Tools", "Business & Marketing", "Productivity & Organization", "Project Management", "Content Generation", "Finance & Compliance", "Data & Analysis", "Media Processing", "Design & Branding", "Web & Browser", "Research & Writing", "Science & Academic", "Education & Learning", "Communication", "Health & Wellness", "Travel & Lifestyle", "Event Management"];
+export type Category = (typeof CATEGORIES)[number];
+export declare const SKILLS: SkillMeta[];
+export declare function getSkillsByCategory(category: Category): SkillMeta[];
+export declare function searchSkills(query: string): SkillMeta[];
+export declare function getSkill(name: string): SkillMeta | undefined;

package/dist/lib/registry.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/lib/skillinfo-run.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/lib/skillinfo.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Skill info - reads docs, requirements, and metadata from skill source
+ */
+export interface SkillDocs {
+    skillMd: string | null;
+    readme: string | null;
+    claudeMd: string | null;
+}
+export interface SkillRequirements {
+    envVars: string[];
+    systemDeps: string[];
+    cliCommand: string | null;
+    dependencies: Record<string, string>;
+}
+/**
+ * Read documentation files from a skill
+ */
+export declare function getSkillDocs(name: string): SkillDocs | null;
+/**
+ * Get the best available documentation for a skill (SKILL.md > README.md > CLAUDE.md)
+ */
+export declare function getSkillBestDoc(name: string): string | null;
+/**
+ * Extract requirements from a skill's source files
+ */
+export declare function getSkillRequirements(name: string): SkillRequirements | null;
+/**
+ * Run a skill by name with given arguments
+ */
+export declare function runSkill(name: string, args: string[], options?: {
+    installed?: boolean;
+}): Promise<{
+    exitCode: number;
+    error?: string;
+}>;
+/**
+ * Generate a .env.example from installed skills
+ */
+export declare function generateEnvExample(targetDir?: string): string;
+/**
+ * Generate a SKILL.md for a skill that doesn't have one.
+ * Builds from registry metadata, README.md/CLAUDE.md content, and package.json info.
+ */
+export declare function generateSkillMd(name: string): string | null;

package/dist/lib/skillinfo.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/lib/utils.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Shared utility functions
+ */
+export declare function normalizeSkillName(name: string): string;

package/dist/lib/utils.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/lib/validation.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/mcp/index.d.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env bun
+/**
+ * MCP server for the skills library.
+ * Exposes tools for listing, searching, and installing skills.
+ *
+ * Usage:
+ *   skills mcp          # Start MCP server on stdio
+ *   skills-mcp          # Direct binary
+ */
+export {};

package/dist/mcp/mcp.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/server/serve.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Bun HTTP server for the Skills Dashboard.
+ * Serves the Vite-built React dashboard and provides API routes.
+ */
+export declare function startServer(port: number, options?: {
+    open?: boolean;
+}): Promise<void>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/skills",
-  "version": "0.0.3",
+  "version": "0.1.1",
   "description": "Skills library for AI coding agents",
   "type": "module",
   "bin": {
@@ -13,13 +13,25 @@
       "types": "./dist/index.d.ts"
     }
   },
+  "files": [
+    "dist/",
+    "bin/",
+    "skills/",
+    "LICENSE",
+    "README.md"
+  ],
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "scripts": {
-    "build": "bun build ./src/cli/index.tsx --outdir ./bin --target bun --external ink --external react --external chalk --external conf && bun build ./src/mcp/index.ts --outfile ./bin/mcp.js --target bun && bun build ./src/index.ts --outdir ./dist --target bun",
+    "build": "bun build ./src/cli/index.tsx --outdir ./bin --target bun --external ink --external react --external chalk && bun build ./src/mcp/index.ts --outfile ./bin/mcp.js --target bun && bun build ./src/index.ts --outdir ./dist --target bun && tsc --emitDeclarationOnly --declaration --outDir dist",
+    "test": "bun test",
     "dev": "bun run ./src/cli/index.tsx",
     "typecheck": "tsc --noEmit",
-    "prepublishOnly": "bun run build"
+    "prepublishOnly": "bun run build",
+    "dashboard:dev": "cd dashboard && bun run dev",
+    "dashboard:build": "cd dashboard && bun install && bun run build",
+    "server": "bun run src/server/serve.ts",
+    "server:dev": "bun --watch run src/server/serve.ts"
   },
   "keywords": [
     "skills",
@@ -32,7 +44,7 @@
     "automation"
   ],
   "author": "Hasna",
-  "license": "MIT",
+  "license": "Apache-2.0",
   "devDependencies": {
     "@types/bun": "latest",
     "@types/react": "^18.2.0",
@@ -42,7 +54,6 @@
     "@modelcontextprotocol/sdk": "^1.26.0",
     "chalk": "^5.3.0",
     "commander": "^12.1.0",
-    "conf": "^13.0.1",
     "ink": "^5.0.1",
     "ink-select-input": "^6.0.0",
     "ink-spinner": "^5.0.0",

package/skills/_common/index.ts

@@ -0,0 +1,23 @@
+/**
+ * Shared SDK for skills
+ *
+ * Common utilities used across skill-audio, skill-browse, skill-codefix,
+ * skill-convert, skill-deploy, skill-extract, skill-image, skill-transcript,
+ * skill-video, and skill-write.
+ */
+
+export { checkSkillAuth, isRemoteExecution, requireAuthIfRemote } from './auth';
+export {
+  executeSkill,
+  saveBlob,
+  executeAndSave,
+  type SkillRequest,
+  type SkillResponse,
+} from './http-client';
+export {
+  SkillInstaller,
+  runInstaller,
+  type SkillConfig,
+  type AssistantType,
+} from './installer';
+export { handleInstallCommand } from './skill-install';

package/skills/skill-academic-journal-matcher/package.json

@@ -4,16 +4,14 @@
   "description": "Academic Journal Matcher skill",
   "type": "module",
   "bin": {
-    "skill-academic-journal-matcher": "./bin/cli.ts"
+    "skill-academic-journal-matcher": "./src/index.ts"
   },
   "scripts": {
-    "dev": "bun run bin/cli.ts",
-    "build": "bun build bin/cli.ts --outdir dist --target node",
+    "dev": "bun run src/index.ts",
+    "build": "bun build src/index.ts --outdir dist --target node",
     "typecheck": "tsc --noEmit"
   },
-  "dependencies": {
-    "commander": "^13.0.0"
-  },
+  "dependencies": {},
   "devDependencies": {
     "@types/bun": "latest",
     "typescript": "^5.7.0"
@@ -22,11 +20,14 @@
     "access": "restricted",
     "registry": "https://registry.npmjs.org/"
   },
-  "files": ["bin", "src", "tsconfig.json"],
+  "files": [
+    "src",
+    "tsconfig.json"
+  ],
   "repository": {
     "type": "git",
     "url": "https://github.com/hasnaxyz/skill-academic-journal-matcher.git"
   },
   "author": "Hasna",
-  "license": "MIT"
+  "license": "Apache-2.0"
 }

package/skills/skill-academic-journal-matcher/tsconfig.json

@@ -1,14 +1,10 @@
 {
+  "extends": "../tsconfig.base.json",
   "compilerOptions": {
-    "target": "ES2022",
-    "module": "ES2022",
-    "moduleResolution": "bundler",
-    "esModuleInterop": true,
-    "strict": true,
-    "skipLibCheck": true,
-    "outDir": "dist",
-    "declaration": true,
-    "types": ["bun-types"]
+    "outDir": "dist"
   },
-  "include": ["src/**/*", "bin/**/*"]
+  "include": [
+    "src/**/*",
+    "bin/**/*"
+  ]
 }

package/skills/skill-action-item-router/package.json

@@ -4,16 +4,14 @@
   "description": "Action Item Router skill",
   "type": "module",
   "bin": {
-    "skill-action-item-router": "./bin/cli.ts"
+    "skill-action-item-router": "./src/index.ts"
   },
   "scripts": {
-    "dev": "bun run bin/cli.ts",
-    "build": "bun build bin/cli.ts --outdir dist --target node",
+    "dev": "bun run src/index.ts",
+    "build": "bun build src/index.ts --outdir dist --target node",
     "typecheck": "tsc --noEmit"
   },
-  "dependencies": {
-    "commander": "^13.0.0"
-  },
+  "dependencies": {},
   "devDependencies": {
     "@types/bun": "latest",
     "typescript": "^5.7.0"
@@ -22,11 +20,14 @@
     "access": "restricted",
     "registry": "https://registry.npmjs.org/"
   },
-  "files": ["bin", "src", "tsconfig.json"],
+  "files": [
+    "src",
+    "tsconfig.json"
+  ],
   "repository": {
     "type": "git",
     "url": "https://github.com/hasnaxyz/skill-action-item-router.git"
   },
   "author": "Hasna",
-  "license": "MIT"
+  "license": "Apache-2.0"
 }

package/skills/skill-action-item-router/tsconfig.json

@@ -1,14 +1,10 @@
 {
+  "extends": "../tsconfig.base.json",
   "compilerOptions": {
-    "target": "ES2022",
-    "module": "ES2022",
-    "moduleResolution": "bundler",
-    "esModuleInterop": true,
-    "strict": true,
-    "skipLibCheck": true,
-    "outDir": "dist",
-    "declaration": true,
-    "types": ["bun-types"]
+    "outDir": "dist"
   },
-  "include": ["src/**/*", "bin/**/*"]
+  "include": [
+    "src/**/*",
+    "bin/**/*"
+  ]
 }

package/skills/skill-ad-creative-generator/package.json

@@ -4,16 +4,14 @@
   "description": "Ad Creative Generator skill",
   "type": "module",
   "bin": {
-    "skill-ad-creative-generator": "./bin/cli.ts"
+    "skill-ad-creative-generator": "./src/index.ts"
   },
   "scripts": {
-    "dev": "bun run bin/cli.ts",
-    "build": "bun build bin/cli.ts --outdir dist --target node",
+    "dev": "bun run src/index.ts",
+    "build": "bun build src/index.ts --outdir dist --target node",
     "typecheck": "tsc --noEmit"
   },
-  "dependencies": {
-    "commander": "^13.0.0"
-  },
+  "dependencies": {},
   "devDependencies": {
     "@types/bun": "latest",
     "typescript": "^5.7.0"
@@ -22,11 +20,14 @@
     "access": "restricted",
     "registry": "https://registry.npmjs.org/"
   },
-  "files": ["bin", "src", "tsconfig.json"],
+  "files": [
+    "src",
+    "tsconfig.json"
+  ],
   "repository": {
     "type": "git",
     "url": "https://github.com/hasnaxyz/skill-ad-creative-generator.git"
   },
   "author": "Hasna",
-  "license": "MIT"
+  "license": "Apache-2.0"
 }

package/skills/skill-ad-creative-generator/tsconfig.json

@@ -1,14 +1,10 @@
 {
+  "extends": "../tsconfig.base.json",
   "compilerOptions": {
-    "target": "ES2022",
-    "module": "ES2022",
-    "moduleResolution": "bundler",
-    "esModuleInterop": true,
-    "strict": true,
-    "skipLibCheck": true,
-    "outDir": "dist",
-    "declaration": true,
-    "types": ["bun-types"]
+    "outDir": "dist"
   },
-  "include": ["src/**/*", "bin/**/*"]
+  "include": [
+    "src/**/*",
+    "bin/**/*"
+  ]
 }

package/skills/skill-advanced-math/package.json

@@ -4,16 +4,14 @@
   "description": "Advanced Math skill",
   "type": "module",
   "bin": {
-    "skill-advanced-math": "./bin/cli.ts"
+    "skill-advanced-math": "./src/index.ts"
   },
   "scripts": {
-    "dev": "bun run bin/cli.ts",
-    "build": "bun build bin/cli.ts --outdir dist --target node",
+    "dev": "bun run src/index.ts",
+    "build": "bun build src/index.ts --outdir dist --target node",
     "typecheck": "tsc --noEmit"
   },
-  "dependencies": {
-    "commander": "^13.0.0"
-  },
+  "dependencies": {},
   "devDependencies": {
     "@types/bun": "latest",
     "typescript": "^5.7.0"
@@ -22,11 +20,14 @@
     "access": "restricted",
     "registry": "https://registry.npmjs.org/"
   },
-  "files": ["bin", "src", "tsconfig.json"],
+  "files": [
+    "src",
+    "tsconfig.json"
+  ],
   "repository": {
     "type": "git",
     "url": "https://github.com/hasnaxyz/skill-advanced-math.git"
   },
   "author": "Hasna",
-  "license": "MIT"
+  "license": "Apache-2.0"
 }

package/skills/skill-advanced-math/tsconfig.json

@@ -1,14 +1,10 @@
 {
+  "extends": "../tsconfig.base.json",
   "compilerOptions": {
-    "target": "ES2022",
-    "module": "ES2022",
-    "moduleResolution": "bundler",
-    "esModuleInterop": true,
-    "strict": true,
-    "skipLibCheck": true,
-    "outDir": "dist",
-    "declaration": true,
-    "types": ["bun-types"]
+    "outDir": "dist"
   },
-  "include": ["src/**/*", "bin/**/*"]
+  "include": [
+    "src/**/*",
+    "bin/**/*"
+  ]
 }

package/skills/skill-analyze-data/package.json

@@ -4,16 +4,14 @@
   "description": "Data science insights for CSV and JSON",
   "type": "module",
   "bin": {
-    "skill-analyze-data": "./bin/cli.ts"
+    "skill-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 bin/cli.ts"
-  },
-  "dependencies": {
-    "commander": "^13.1.0"
+    "start": "bun run src/index.ts"
   },
+  "dependencies": {},
   "devDependencies": {
     "@types/bun": "latest",
     "typescript": "^5.7.0"

package/skills/skill-analyze-data/tsconfig.json

@@ -1,16 +1,19 @@
 {
+  "extends": "../tsconfig.base.json",
   "compilerOptions": {
-    "target": "ES2022",
-    "module": "ES2022",
-    "moduleResolution": "bundler",
-    "esModuleInterop": true,
     "forceConsistentCasingInFileNames": true,
-    "strict": true,
-    "skipLibCheck": true,
     "outDir": "dist",
     "rootDir": ".",
-    "types": ["bun"]
+    "types": [
+      "bun"
+    ]
   },
-  "include": ["src/**/*", "bin/**/*"],
-  "exclude": ["node_modules", "dist"]
+  "include": [
+    "src/**/*",
+    "bin/**/*"
+  ],
+  "exclude": [
+    "node_modules",
+    "dist"
+  ]
 }

package/skills/skill-anomaly-investigator/package.json

@@ -4,16 +4,14 @@
   "description": "Anomaly Investigator skill",
   "type": "module",
   "bin": {
-    "skill-anomaly-investigator": "./bin/cli.ts"
+    "skill-anomaly-investigator": "./src/index.ts"
   },
   "scripts": {
-    "dev": "bun run bin/cli.ts",
-    "build": "bun build bin/cli.ts --outdir dist --target node",
+    "dev": "bun run src/index.ts",
+    "build": "bun build src/index.ts --outdir dist --target node",
     "typecheck": "tsc --noEmit"
   },
-  "dependencies": {
-    "commander": "^13.0.0"
-  },
+  "dependencies": {},
   "devDependencies": {
     "@types/bun": "latest",
     "typescript": "^5.7.0"
@@ -22,11 +20,14 @@
     "access": "restricted",
     "registry": "https://registry.npmjs.org/"
   },
-  "files": ["bin", "src", "tsconfig.json"],
+  "files": [
+    "src",
+    "tsconfig.json"
+  ],
   "repository": {
     "type": "git",
     "url": "https://github.com/hasnaxyz/skill-anomaly-investigator.git"
   },
   "author": "Hasna",
-  "license": "MIT"
+  "license": "Apache-2.0"
 }

package/skills/skill-anomaly-investigator/tsconfig.json

@@ -1,14 +1,10 @@
 {
+  "extends": "../tsconfig.base.json",
   "compilerOptions": {
-    "target": "ES2022",
-    "module": "ES2022",
-    "moduleResolution": "bundler",
-    "esModuleInterop": true,
-    "strict": true,
-    "skipLibCheck": true,
-    "outDir": "dist",
-    "declaration": true,
-    "types": ["bun-types"]
+    "outDir": "dist"
   },
-  "include": ["src/**/*", "bin/**/*"]
+  "include": [
+    "src/**/*",
+    "bin/**/*"
+  ]
 }

package/skills/skill-api-test-suite/package.json

@@ -4,16 +4,14 @@
   "description": "Api Test Suite skill",
   "type": "module",
   "bin": {
-    "skill-api-test-suite": "./bin/cli.ts"
+    "skill-api-test-suite": "./src/index.ts"
   },
   "scripts": {
-    "dev": "bun run bin/cli.ts",
-    "build": "bun build bin/cli.ts --outdir dist --target node",
+    "dev": "bun run src/index.ts",
+    "build": "bun build src/index.ts --outdir dist --target node",
     "typecheck": "tsc --noEmit"
   },
-  "dependencies": {
-    "commander": "^13.0.0"
-  },
+  "dependencies": {},
   "devDependencies": {
     "@types/bun": "latest",
     "typescript": "^5.7.0"
@@ -22,11 +20,14 @@
     "access": "restricted",
     "registry": "https://registry.npmjs.org/"
   },
-  "files": ["bin", "src", "tsconfig.json"],
+  "files": [
+    "src",
+    "tsconfig.json"
+  ],
   "repository": {
     "type": "git",
     "url": "https://github.com/hasnaxyz/skill-api-test-suite.git"
   },
   "author": "Hasna",
-  "license": "MIT"
+  "license": "Apache-2.0"
 }