skilldb 0.1.0

package/dist/index.cjs

@@ -0,0 +1,242 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  SkillDBClient: () => SkillDBClient,
+  cacheSkill: () => cacheSkill,
+  createClient: () => createClient,
+  getCachedPath: () => getCachedPath,
+  initCache: () => initCache,
+  isCached: () => isCached,
+  listCached: () => listCached,
+  resolveApiKey: () => resolveApiKey,
+  resolveBaseUrl: () => resolveBaseUrl,
+  saveApiKey: () => saveApiKey
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/config.ts
+var import_node_fs = __toESM(require("fs"), 1);
+var import_node_path = __toESM(require("path"), 1);
+var import_node_os = __toESM(require("os"), 1);
+var RC_FILE = ".skilldbrc";
+var DEFAULT_BASE_URL = "https://skilldb.dev/api/v1";
+function readJson(filePath) {
+  try {
+    const raw = import_node_fs.default.readFileSync(filePath, "utf-8");
+    return JSON.parse(raw);
+  } catch {
+    return null;
+  }
+}
+function resolveApiKey() {
+  if (process.env.SKILLDB_API_KEY) {
+    return process.env.SKILLDB_API_KEY;
+  }
+  const projectRc = import_node_path.default.join(process.cwd(), RC_FILE);
+  const projectConfig = readJson(projectRc);
+  if (projectConfig?.apiKey) return projectConfig.apiKey;
+  const homeRc = import_node_path.default.join(import_node_os.default.homedir(), RC_FILE);
+  const homeConfig = readJson(homeRc);
+  if (homeConfig?.apiKey) return homeConfig.apiKey;
+  return void 0;
+}
+function resolveBaseUrl() {
+  return process.env.SKILLDB_API_URL || DEFAULT_BASE_URL;
+}
+function saveApiKey(apiKey, global = true) {
+  const target = global ? import_node_path.default.join(import_node_os.default.homedir(), RC_FILE) : import_node_path.default.join(process.cwd(), RC_FILE);
+  const existing = readJson(target) || {};
+  import_node_fs.default.writeFileSync(target, JSON.stringify({ ...existing, apiKey }, null, 2) + "\n", "utf-8");
+  return target;
+}
+
+// src/client.ts
+var SkillDBClient = class {
+  apiKey;
+  baseUrl;
+  constructor(config) {
+    this.apiKey = config?.apiKey ?? resolveApiKey();
+    this.baseUrl = config?.baseUrl ?? resolveBaseUrl();
+  }
+  headers() {
+    const h = { "Content-Type": "application/json" };
+    if (this.apiKey) {
+      h["Authorization"] = `Bearer ${this.apiKey}`;
+    }
+    return h;
+  }
+  async request(endpoint, params) {
+    const url = new URL(`${this.baseUrl}${endpoint}`);
+    if (params) {
+      for (const [k, v] of Object.entries(params)) {
+        if (v !== void 0 && v !== "") url.searchParams.set(k, v);
+      }
+    }
+    const res = await fetch(url.toString(), { headers: this.headers() });
+    if (!res.ok) {
+      const body = await res.json().catch(() => ({}));
+      const msg = body.error || `HTTP ${res.status}`;
+      throw new Error(msg);
+    }
+    return res.json();
+  }
+  /** Search skills by keyword. */
+  async search(query, options) {
+    return this.request("/skills", {
+      search: query,
+      category: options?.category ?? "",
+      pack: options?.pack ?? "",
+      limit: String(options?.limit ?? 20),
+      offset: String(options?.offset ?? 0),
+      include_content: options?.includeContent ? "true" : ""
+    });
+  }
+  /** List skills with optional filters. */
+  async list(options) {
+    return this.request("/skills", {
+      category: options?.category ?? "",
+      pack: options?.pack ?? "",
+      search: options?.search ?? "",
+      limit: String(options?.limit ?? 50),
+      offset: String(options?.offset ?? 0),
+      include_content: options?.includeContent ? "true" : ""
+    });
+  }
+  /** Get a single skill by ID (e.g. "software-skills/code-review.md"). */
+  async get(id) {
+    const encoded = encodeURIComponent(id);
+    const res = await this.request(`/skills/${encoded}`, {
+      include_content: "true"
+    });
+    return "skill" in res ? res.skill : res;
+  }
+  /** Validate that the configured API key works. */
+  async validate() {
+    try {
+      await this.list({ limit: 1 });
+      return true;
+    } catch {
+      return false;
+    }
+  }
+};
+
+// src/cache.ts
+var import_node_fs2 = __toESM(require("fs"), 1);
+var import_node_path2 = __toESM(require("path"), 1);
+var SKILLDB_DIR = ".skilldb";
+var SKILLS_DIR = "skills";
+var MANIFEST_FILE = "manifest.json";
+function ensureDir(dir) {
+  if (!import_node_fs2.default.existsSync(dir)) {
+    import_node_fs2.default.mkdirSync(dir, { recursive: true });
+  }
+}
+function skilldbRoot(cwd) {
+  return import_node_path2.default.join(cwd ?? process.cwd(), SKILLDB_DIR);
+}
+function initCache(cwd) {
+  const root = skilldbRoot(cwd);
+  ensureDir(import_node_path2.default.join(root, SKILLS_DIR));
+  const manifestPath = import_node_path2.default.join(root, MANIFEST_FILE);
+  if (!import_node_fs2.default.existsSync(manifestPath)) {
+    import_node_fs2.default.writeFileSync(manifestPath, JSON.stringify({ installed: {} }, null, 2) + "\n");
+  }
+  return root;
+}
+function readManifest(cwd) {
+  const manifestPath = import_node_path2.default.join(skilldbRoot(cwd), MANIFEST_FILE);
+  try {
+    return JSON.parse(import_node_fs2.default.readFileSync(manifestPath, "utf-8"));
+  } catch {
+    return { installed: {} };
+  }
+}
+function writeManifest(manifest, cwd) {
+  const root = skilldbRoot(cwd);
+  ensureDir(root);
+  import_node_fs2.default.writeFileSync(
+    import_node_path2.default.join(root, MANIFEST_FILE),
+    JSON.stringify(manifest, null, 2) + "\n"
+  );
+}
+function cacheSkill(skill, cwd) {
+  const root = skilldbRoot(cwd);
+  const skillDir = import_node_path2.default.join(root, SKILLS_DIR, skill.pack);
+  ensureDir(skillDir);
+  const safeName = skill.name.replace(/[/\\:*?"<>|]/g, "-");
+  const filePath = import_node_path2.default.join(skillDir, `${safeName}.md`);
+  import_node_fs2.default.writeFileSync(filePath, skill.content ?? `# ${skill.title}
+
+${skill.description}
+`);
+  const manifest = readManifest(cwd);
+  manifest.installed[skill.id] = {
+    addedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    lines: skill.lines
+  };
+  writeManifest(manifest, cwd);
+  return filePath;
+}
+function isCached(skillId, cwd) {
+  const manifest = readManifest(cwd);
+  return skillId in manifest.installed;
+}
+function getCachedPath(skillId, cwd) {
+  if (!isCached(skillId, cwd)) return null;
+  const [pack, file] = skillId.split("/");
+  const name = file.replace(".md", "").replace(/[/\\:*?"<>|]/g, "-");
+  const filePath = import_node_path2.default.join(skilldbRoot(cwd), SKILLS_DIR, pack, `${name}.md`);
+  return import_node_fs2.default.existsSync(filePath) ? filePath : null;
+}
+function listCached(cwd) {
+  return readManifest(cwd);
+}
+
+// src/index.ts
+function createClient(config) {
+  return new SkillDBClient(config);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  SkillDBClient,
+  cacheSkill,
+  createClient,
+  getCachedPath,
+  initCache,
+  isCached,
+  listCached,
+  resolveApiKey,
+  resolveBaseUrl,
+  saveApiKey
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/config.ts","../src/client.ts","../src/cache.ts"],"sourcesContent":["export { SkillDBClient } from './client.js';\nexport type {\n  Skill,\n  PackInfo,\n  CategoryInfo,\n  SkillsResponse,\n  SearchOptions,\n  ClientConfig,\n  Manifest,\n} from './types.js';\nexport { resolveApiKey, resolveBaseUrl, saveApiKey } from './config.js';\nexport { initCache, cacheSkill, isCached, getCachedPath, listCached } from './cache.js';\n\nimport type { ClientConfig } from './types.js';\nimport { SkillDBClient } from './client.js';\n\n/** Create a SkillDB client. Auto-loads API key from env/config. */\nexport function createClient(config?: ClientConfig): SkillDBClient {\n  return new SkillDBClient(config);\n}\n","import fs from 'node:fs';\nimport path from 'node:path';\nimport os from 'node:os';\n\nconst RC_FILE = '.skilldbrc';\n\nexport const DEFAULT_BASE_URL = 'https://skilldb.dev/api/v1';\n\ninterface RcConfig {\n  apiKey?: string;\n}\n\nfunction readJson(filePath: string): RcConfig | null {\n  try {\n    const raw = fs.readFileSync(filePath, 'utf-8');\n    return JSON.parse(raw);\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Resolve API key from (in priority order):\n * 1. SKILLDB_API_KEY env var\n * 2. .skilldbrc in project root (cwd)\n * 3. ~/.skilldbrc in home dir\n */\nexport function resolveApiKey(): string | undefined {\n  if (process.env.SKILLDB_API_KEY) {\n    return process.env.SKILLDB_API_KEY;\n  }\n\n  const projectRc = path.join(process.cwd(), RC_FILE);\n  const projectConfig = readJson(projectRc);\n  if (projectConfig?.apiKey) return projectConfig.apiKey;\n\n  const homeRc = path.join(os.homedir(), RC_FILE);\n  const homeConfig = readJson(homeRc);\n  if (homeConfig?.apiKey) return homeConfig.apiKey;\n\n  return undefined;\n}\n\n/**\n * Resolve base URL from env or default.\n */\nexport function resolveBaseUrl(): string {\n  return process.env.SKILLDB_API_URL || DEFAULT_BASE_URL;\n}\n\n/**\n * Save API key to ~/.skilldbrc (user-wide) or project .skilldbrc.\n */\nexport function saveApiKey(apiKey: string, global = true): string {\n  const target = global\n    ? path.join(os.homedir(), RC_FILE)\n    : path.join(process.cwd(), RC_FILE);\n\n  const existing = readJson(target) || {};\n  fs.writeFileSync(target, JSON.stringify({ ...existing, apiKey }, null, 2) + '\\n', 'utf-8');\n  return target;\n}\n","import type { ClientConfig, Skill, SkillsResponse, SearchOptions } from './types.js';\nimport { resolveApiKey, resolveBaseUrl } from './config.js';\n\nexport class SkillDBClient {\n  private apiKey?: string;\n  private baseUrl: string;\n\n  constructor(config?: ClientConfig) {\n    this.apiKey = config?.apiKey ?? resolveApiKey();\n    this.baseUrl = config?.baseUrl ?? resolveBaseUrl();\n  }\n\n  private headers(): Record<string, string> {\n    const h: Record<string, string> = { 'Content-Type': 'application/json' };\n    if (this.apiKey) {\n      h['Authorization'] = `Bearer ${this.apiKey}`;\n    }\n    return h;\n  }\n\n  private async request<T>(endpoint: string, params?: Record<string, string>): Promise<T> {\n    const url = new URL(`${this.baseUrl}${endpoint}`);\n    if (params) {\n      for (const [k, v] of Object.entries(params)) {\n        if (v !== undefined && v !== '') url.searchParams.set(k, v);\n      }\n    }\n\n    const res = await fetch(url.toString(), { headers: this.headers() });\n\n    if (!res.ok) {\n      const body = await res.json().catch(() => ({}));\n      const msg = (body as Record<string, string>).error || `HTTP ${res.status}`;\n      throw new Error(msg);\n    }\n\n    return res.json() as Promise<T>;\n  }\n\n  /** Search skills by keyword. */\n  async search(query: string, options?: Omit<SearchOptions, 'search'>): Promise<SkillsResponse> {\n    return this.request<SkillsResponse>('/skills', {\n      search: query,\n      category: options?.category ?? '',\n      pack: options?.pack ?? '',\n      limit: String(options?.limit ?? 20),\n      offset: String(options?.offset ?? 0),\n      include_content: options?.includeContent ? 'true' : '',\n    });\n  }\n\n  /** List skills with optional filters. */\n  async list(options?: SearchOptions): Promise<SkillsResponse> {\n    return this.request<SkillsResponse>('/skills', {\n      category: options?.category ?? '',\n      pack: options?.pack ?? '',\n      search: options?.search ?? '',\n      limit: String(options?.limit ?? 50),\n      offset: String(options?.offset ?? 0),\n      include_content: options?.includeContent ? 'true' : '',\n    });\n  }\n\n  /** Get a single skill by ID (e.g. \"software-skills/code-review.md\"). */\n  async get(id: string): Promise<Skill> {\n    const encoded = encodeURIComponent(id);\n    const res = await this.request<Skill | { skill: Skill }>(`/skills/${encoded}`, {\n      include_content: 'true',\n    });\n    // Handle both direct and wrapped responses\n    return 'skill' in res ? res.skill : res;\n  }\n\n  /** Validate that the configured API key works. */\n  async validate(): Promise<boolean> {\n    try {\n      await this.list({ limit: 1 });\n      return true;\n    } catch {\n      return false;\n    }\n  }\n}\n","import fs from 'node:fs';\nimport path from 'node:path';\nimport type { Manifest, Skill } from './types.js';\n\nconst SKILLDB_DIR = '.skilldb';\nconst SKILLS_DIR = 'skills';\nconst MANIFEST_FILE = 'manifest.json';\n\nfunction ensureDir(dir: string): void {\n  if (!fs.existsSync(dir)) {\n    fs.mkdirSync(dir, { recursive: true });\n  }\n}\n\nfunction skilldbRoot(cwd?: string): string {\n  return path.join(cwd ?? process.cwd(), SKILLDB_DIR);\n}\n\n/** Ensure .skilldb/ directory structure exists. */\nexport function initCache(cwd?: string): string {\n  const root = skilldbRoot(cwd);\n  ensureDir(path.join(root, SKILLS_DIR));\n\n  const manifestPath = path.join(root, MANIFEST_FILE);\n  if (!fs.existsSync(manifestPath)) {\n    fs.writeFileSync(manifestPath, JSON.stringify({ installed: {} }, null, 2) + '\\n');\n  }\n\n  return root;\n}\n\n/** Read the local manifest. */\nexport function readManifest(cwd?: string): Manifest {\n  const manifestPath = path.join(skilldbRoot(cwd), MANIFEST_FILE);\n  try {\n    return JSON.parse(fs.readFileSync(manifestPath, 'utf-8'));\n  } catch {\n    return { installed: {} };\n  }\n}\n\n/** Write the local manifest. */\nexport function writeManifest(manifest: Manifest, cwd?: string): void {\n  const root = skilldbRoot(cwd);\n  ensureDir(root);\n  fs.writeFileSync(\n    path.join(root, MANIFEST_FILE),\n    JSON.stringify(manifest, null, 2) + '\\n'\n  );\n}\n\n/** Save a skill to the local cache. */\nexport function cacheSkill(skill: Skill, cwd?: string): string {\n  const root = skilldbRoot(cwd);\n  const skillDir = path.join(root, SKILLS_DIR, skill.pack);\n  ensureDir(skillDir);\n\n  const safeName = skill.name.replace(/[/\\\\:*?\"<>|]/g, '-');\n  const filePath = path.join(skillDir, `${safeName}.md`);\n  fs.writeFileSync(filePath, skill.content ?? `# ${skill.title}\\n\\n${skill.description}\\n`);\n\n  // Update manifest\n  const manifest = readManifest(cwd);\n  manifest.installed[skill.id] = {\n    addedAt: new Date().toISOString(),\n    lines: skill.lines,\n  };\n  writeManifest(manifest, cwd);\n\n  return filePath;\n}\n\n/** Check if a skill is already cached. */\nexport function isCached(skillId: string, cwd?: string): boolean {\n  const manifest = readManifest(cwd);\n  return skillId in manifest.installed;\n}\n\n/** Get the local path for a cached skill. */\nexport function getCachedPath(skillId: string, cwd?: string): string | null {\n  if (!isCached(skillId, cwd)) return null;\n  const [pack, file] = skillId.split('/');\n  const name = file.replace('.md', '').replace(/[/\\\\:*?\"<>|]/g, '-');\n  const filePath = path.join(skilldbRoot(cwd), SKILLS_DIR, pack, `${name}.md`);\n  return fs.existsSync(filePath) ? filePath : null;\n}\n\n/** List all cached skills. */\nexport function listCached(cwd?: string): Manifest {\n  return readManifest(cwd);\n}\n\n/** Ensure .skilldb/ and .skilldbrc are in .gitignore. */\nexport function updateGitignore(cwd?: string): void {\n  const root = cwd ?? process.cwd();\n  const gitignorePath = path.join(root, '.gitignore');\n\n  const entries = ['.skilldb/', '.skilldbrc'];\n  let content = '';\n\n  if (fs.existsSync(gitignorePath)) {\n    content = fs.readFileSync(gitignorePath, 'utf-8');\n  }\n\n  const toAdd = entries.filter(e => !content.includes(e));\n  if (toAdd.length === 0) return;\n\n  const suffix = (content && !content.endsWith('\\n') ? '\\n' : '') +\n    '\\n# SkillDB\\n' + toAdd.join('\\n') + '\\n';\n\n  fs.writeFileSync(gitignorePath, content + suffix);\n}\n"],"mappings":"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","names":["fs","path","os","import_node_fs","import_node_path","fs","path"]}

package/dist/index.d.cts

@@ -0,0 +1,109 @@
+/** A single skill from the SkillDB catalog. */
+interface Skill {
+    id: string;
+    name: string;
+    title: string;
+    description: string;
+    file: string;
+    pack: string;
+    packLabel: string;
+    category: string;
+    lines: number;
+    content?: string;
+}
+/** Metadata about a skill pack. */
+interface PackInfo {
+    slug: string;
+    label: string;
+    category: string;
+    count: number;
+}
+/** Category summary. */
+interface CategoryInfo {
+    name: string;
+    packCount: number;
+    skillCount: number;
+}
+/** Paginated API response. */
+interface SkillsResponse {
+    skills: Skill[];
+    pagination: {
+        total: number;
+        limit: number;
+        offset: number;
+        hasMore: boolean;
+    };
+    meta: {
+        categories: string[];
+        totalPacks: number;
+    };
+}
+/** Options for searching/listing skills. */
+interface SearchOptions {
+    category?: string;
+    pack?: string;
+    search?: string;
+    limit?: number;
+    offset?: number;
+    includeContent?: boolean;
+}
+/** SDK client configuration. */
+interface ClientConfig {
+    apiKey?: string;
+    baseUrl?: string;
+}
+/** Local manifest tracking installed skills. */
+interface Manifest {
+    installed: Record<string, {
+        addedAt: string;
+        lines: number;
+    }>;
+}
+
+declare class SkillDBClient {
+    private apiKey?;
+    private baseUrl;
+    constructor(config?: ClientConfig);
+    private headers;
+    private request;
+    /** Search skills by keyword. */
+    search(query: string, options?: Omit<SearchOptions, 'search'>): Promise<SkillsResponse>;
+    /** List skills with optional filters. */
+    list(options?: SearchOptions): Promise<SkillsResponse>;
+    /** Get a single skill by ID (e.g. "software-skills/code-review.md"). */
+    get(id: string): Promise<Skill>;
+    /** Validate that the configured API key works. */
+    validate(): Promise<boolean>;
+}
+
+/**
+ * Resolve API key from (in priority order):
+ * 1. SKILLDB_API_KEY env var
+ * 2. .skilldbrc in project root (cwd)
+ * 3. ~/.skilldbrc in home dir
+ */
+declare function resolveApiKey(): string | undefined;
+/**
+ * Resolve base URL from env or default.
+ */
+declare function resolveBaseUrl(): string;
+/**
+ * Save API key to ~/.skilldbrc (user-wide) or project .skilldbrc.
+ */
+declare function saveApiKey(apiKey: string, global?: boolean): string;
+
+/** Ensure .skilldb/ directory structure exists. */
+declare function initCache(cwd?: string): string;
+/** Save a skill to the local cache. */
+declare function cacheSkill(skill: Skill, cwd?: string): string;
+/** Check if a skill is already cached. */
+declare function isCached(skillId: string, cwd?: string): boolean;
+/** Get the local path for a cached skill. */
+declare function getCachedPath(skillId: string, cwd?: string): string | null;
+/** List all cached skills. */
+declare function listCached(cwd?: string): Manifest;
+
+/** Create a SkillDB client. Auto-loads API key from env/config. */
+declare function createClient(config?: ClientConfig): SkillDBClient;
+
+export { type CategoryInfo, type ClientConfig, type Manifest, type PackInfo, type SearchOptions, type Skill, SkillDBClient, type SkillsResponse, cacheSkill, createClient, getCachedPath, initCache, isCached, listCached, resolveApiKey, resolveBaseUrl, saveApiKey };

package/dist/index.d.ts

@@ -0,0 +1,109 @@
+/** A single skill from the SkillDB catalog. */
+interface Skill {
+    id: string;
+    name: string;
+    title: string;
+    description: string;
+    file: string;
+    pack: string;
+    packLabel: string;
+    category: string;
+    lines: number;
+    content?: string;
+}
+/** Metadata about a skill pack. */
+interface PackInfo {
+    slug: string;
+    label: string;
+    category: string;
+    count: number;
+}
+/** Category summary. */
+interface CategoryInfo {
+    name: string;
+    packCount: number;
+    skillCount: number;
+}
+/** Paginated API response. */
+interface SkillsResponse {
+    skills: Skill[];
+    pagination: {
+        total: number;
+        limit: number;
+        offset: number;
+        hasMore: boolean;
+    };
+    meta: {
+        categories: string[];
+        totalPacks: number;
+    };
+}
+/** Options for searching/listing skills. */
+interface SearchOptions {
+    category?: string;
+    pack?: string;
+    search?: string;
+    limit?: number;
+    offset?: number;
+    includeContent?: boolean;
+}
+/** SDK client configuration. */
+interface ClientConfig {
+    apiKey?: string;
+    baseUrl?: string;
+}
+/** Local manifest tracking installed skills. */
+interface Manifest {
+    installed: Record<string, {
+        addedAt: string;
+        lines: number;
+    }>;
+}
+
+declare class SkillDBClient {
+    private apiKey?;
+    private baseUrl;
+    constructor(config?: ClientConfig);
+    private headers;
+    private request;
+    /** Search skills by keyword. */
+    search(query: string, options?: Omit<SearchOptions, 'search'>): Promise<SkillsResponse>;
+    /** List skills with optional filters. */
+    list(options?: SearchOptions): Promise<SkillsResponse>;
+    /** Get a single skill by ID (e.g. "software-skills/code-review.md"). */
+    get(id: string): Promise<Skill>;
+    /** Validate that the configured API key works. */
+    validate(): Promise<boolean>;
+}
+
+/**
+ * Resolve API key from (in priority order):
+ * 1. SKILLDB_API_KEY env var
+ * 2. .skilldbrc in project root (cwd)
+ * 3. ~/.skilldbrc in home dir
+ */
+declare function resolveApiKey(): string | undefined;
+/**
+ * Resolve base URL from env or default.
+ */
+declare function resolveBaseUrl(): string;
+/**
+ * Save API key to ~/.skilldbrc (user-wide) or project .skilldbrc.
+ */
+declare function saveApiKey(apiKey: string, global?: boolean): string;
+
+/** Ensure .skilldb/ directory structure exists. */
+declare function initCache(cwd?: string): string;
+/** Save a skill to the local cache. */
+declare function cacheSkill(skill: Skill, cwd?: string): string;
+/** Check if a skill is already cached. */
+declare function isCached(skillId: string, cwd?: string): boolean;
+/** Get the local path for a cached skill. */
+declare function getCachedPath(skillId: string, cwd?: string): string | null;
+/** List all cached skills. */
+declare function listCached(cwd?: string): Manifest;
+
+/** Create a SkillDB client. Auto-loads API key from env/config. */
+declare function createClient(config?: ClientConfig): SkillDBClient;
+
+export { type CategoryInfo, type ClientConfig, type Manifest, type PackInfo, type SearchOptions, type Skill, SkillDBClient, type SkillsResponse, cacheSkill, createClient, getCachedPath, initCache, isCached, listCached, resolveApiKey, resolveBaseUrl, saveApiKey };

package/dist/index.js

@@ -0,0 +1,196 @@
+// src/config.ts
+import fs from "fs";
+import path from "path";
+import os from "os";
+var RC_FILE = ".skilldbrc";
+var DEFAULT_BASE_URL = "https://skilldb.dev/api/v1";
+function readJson(filePath) {
+  try {
+    const raw = fs.readFileSync(filePath, "utf-8");
+    return JSON.parse(raw);
+  } catch {
+    return null;
+  }
+}
+function resolveApiKey() {
+  if (process.env.SKILLDB_API_KEY) {
+    return process.env.SKILLDB_API_KEY;
+  }
+  const projectRc = path.join(process.cwd(), RC_FILE);
+  const projectConfig = readJson(projectRc);
+  if (projectConfig?.apiKey) return projectConfig.apiKey;
+  const homeRc = path.join(os.homedir(), RC_FILE);
+  const homeConfig = readJson(homeRc);
+  if (homeConfig?.apiKey) return homeConfig.apiKey;
+  return void 0;
+}
+function resolveBaseUrl() {
+  return process.env.SKILLDB_API_URL || DEFAULT_BASE_URL;
+}
+function saveApiKey(apiKey, global = true) {
+  const target = global ? path.join(os.homedir(), RC_FILE) : path.join(process.cwd(), RC_FILE);
+  const existing = readJson(target) || {};
+  fs.writeFileSync(target, JSON.stringify({ ...existing, apiKey }, null, 2) + "\n", "utf-8");
+  return target;
+}
+
+// src/client.ts
+var SkillDBClient = class {
+  apiKey;
+  baseUrl;
+  constructor(config) {
+    this.apiKey = config?.apiKey ?? resolveApiKey();
+    this.baseUrl = config?.baseUrl ?? resolveBaseUrl();
+  }
+  headers() {
+    const h = { "Content-Type": "application/json" };
+    if (this.apiKey) {
+      h["Authorization"] = `Bearer ${this.apiKey}`;
+    }
+    return h;
+  }
+  async request(endpoint, params) {
+    const url = new URL(`${this.baseUrl}${endpoint}`);
+    if (params) {
+      for (const [k, v] of Object.entries(params)) {
+        if (v !== void 0 && v !== "") url.searchParams.set(k, v);
+      }
+    }
+    const res = await fetch(url.toString(), { headers: this.headers() });
+    if (!res.ok) {
+      const body = await res.json().catch(() => ({}));
+      const msg = body.error || `HTTP ${res.status}`;
+      throw new Error(msg);
+    }
+    return res.json();
+  }
+  /** Search skills by keyword. */
+  async search(query, options) {
+    return this.request("/skills", {
+      search: query,
+      category: options?.category ?? "",
+      pack: options?.pack ?? "",
+      limit: String(options?.limit ?? 20),
+      offset: String(options?.offset ?? 0),
+      include_content: options?.includeContent ? "true" : ""
+    });
+  }
+  /** List skills with optional filters. */
+  async list(options) {
+    return this.request("/skills", {
+      category: options?.category ?? "",
+      pack: options?.pack ?? "",
+      search: options?.search ?? "",
+      limit: String(options?.limit ?? 50),
+      offset: String(options?.offset ?? 0),
+      include_content: options?.includeContent ? "true" : ""
+    });
+  }
+  /** Get a single skill by ID (e.g. "software-skills/code-review.md"). */
+  async get(id) {
+    const encoded = encodeURIComponent(id);
+    const res = await this.request(`/skills/${encoded}`, {
+      include_content: "true"
+    });
+    return "skill" in res ? res.skill : res;
+  }
+  /** Validate that the configured API key works. */
+  async validate() {
+    try {
+      await this.list({ limit: 1 });
+      return true;
+    } catch {
+      return false;
+    }
+  }
+};
+
+// src/cache.ts
+import fs2 from "fs";
+import path2 from "path";
+var SKILLDB_DIR = ".skilldb";
+var SKILLS_DIR = "skills";
+var MANIFEST_FILE = "manifest.json";
+function ensureDir(dir) {
+  if (!fs2.existsSync(dir)) {
+    fs2.mkdirSync(dir, { recursive: true });
+  }
+}
+function skilldbRoot(cwd) {
+  return path2.join(cwd ?? process.cwd(), SKILLDB_DIR);
+}
+function initCache(cwd) {
+  const root = skilldbRoot(cwd);
+  ensureDir(path2.join(root, SKILLS_DIR));
+  const manifestPath = path2.join(root, MANIFEST_FILE);
+  if (!fs2.existsSync(manifestPath)) {
+    fs2.writeFileSync(manifestPath, JSON.stringify({ installed: {} }, null, 2) + "\n");
+  }
+  return root;
+}
+function readManifest(cwd) {
+  const manifestPath = path2.join(skilldbRoot(cwd), MANIFEST_FILE);
+  try {
+    return JSON.parse(fs2.readFileSync(manifestPath, "utf-8"));
+  } catch {
+    return { installed: {} };
+  }
+}
+function writeManifest(manifest, cwd) {
+  const root = skilldbRoot(cwd);
+  ensureDir(root);
+  fs2.writeFileSync(
+    path2.join(root, MANIFEST_FILE),
+    JSON.stringify(manifest, null, 2) + "\n"
+  );
+}
+function cacheSkill(skill, cwd) {
+  const root = skilldbRoot(cwd);
+  const skillDir = path2.join(root, SKILLS_DIR, skill.pack);
+  ensureDir(skillDir);
+  const safeName = skill.name.replace(/[/\\:*?"<>|]/g, "-");
+  const filePath = path2.join(skillDir, `${safeName}.md`);
+  fs2.writeFileSync(filePath, skill.content ?? `# ${skill.title}
+
+${skill.description}
+`);
+  const manifest = readManifest(cwd);
+  manifest.installed[skill.id] = {
+    addedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    lines: skill.lines
+  };
+  writeManifest(manifest, cwd);
+  return filePath;
+}
+function isCached(skillId, cwd) {
+  const manifest = readManifest(cwd);
+  return skillId in manifest.installed;
+}
+function getCachedPath(skillId, cwd) {
+  if (!isCached(skillId, cwd)) return null;
+  const [pack, file] = skillId.split("/");
+  const name = file.replace(".md", "").replace(/[/\\:*?"<>|]/g, "-");
+  const filePath = path2.join(skilldbRoot(cwd), SKILLS_DIR, pack, `${name}.md`);
+  return fs2.existsSync(filePath) ? filePath : null;
+}
+function listCached(cwd) {
+  return readManifest(cwd);
+}
+
+// src/index.ts
+function createClient(config) {
+  return new SkillDBClient(config);
+}
+export {
+  SkillDBClient,
+  cacheSkill,
+  createClient,
+  getCachedPath,
+  initCache,
+  isCached,
+  listCached,
+  resolveApiKey,
+  resolveBaseUrl,
+  saveApiKey
+};
+//# sourceMappingURL=index.js.map