skilldb 0.5.2 → 0.7.0

package/dist/index.cjs

@@ -94,7 +94,13 @@ var SkillDBClient = class {
     }
     return h;
   }
-  async request(endpoint, params) {
+  /** Make an authenticated request to any endpoint (used by MCP tools for private skills). */
+  async rawRequest(endpoint, init) {
+    const url = `${this.baseUrl}${endpoint}`;
+    const headers = { ...this.headers(), ...init?.headers || {} };
+    return fetch(url, { ...init, headers });
+  }
+  async typedRequest(endpoint, params) {
     const url = new URL(`${this.baseUrl}${endpoint}`);
     if (params) {
       for (const [k, v] of Object.entries(params)) {
@@ -103,15 +109,33 @@ var SkillDBClient = class {
     }
     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}`;
+      const body = await res.json().catch(() => null);
+      const apiError = body && typeof body === "object" ? body.error : null;
+      const status = res.status;
+      const statusText = res.statusText || "Unknown";
+      let msg;
+      if (apiError) {
+        msg = apiError;
+      } else if (status === 500) {
+        msg = `SkillDB API internal error (HTTP 500). The service may be experiencing issues. Check status at https://skilldb.dev/api/v1/status`;
+      } else if (status === 503) {
+        msg = `SkillDB API unavailable (HTTP 503). The skills index may not be loaded. Check status at https://skilldb.dev/api/v1/status`;
+      } else if (status === 401) {
+        msg = `Invalid or expired API key (HTTP 401). Get a free key at https://skilldb.dev/api-access`;
+      } else if (status === 429) {
+        msg = `Rate limit exceeded (HTTP 429). Authenticate with an API key for higher limits: https://skilldb.dev/api-access`;
+      } else if (status === 404) {
+        msg = `Resource not found (HTTP 404). The requested skill or endpoint does not exist.`;
+      } else {
+        msg = `SkillDB API error: HTTP ${status} ${statusText}. Check https://skilldb.dev/api/v1/status for service health.`;
+      }
       throw new Error(msg);
     }
     return res.json();
   }
   /** Search skills by keyword. */
   async search(query, options) {
-    return this.request("/skills", {
+    return this.typedRequest("/skills", {
       search: query,
       category: options?.category ?? "",
       pack: options?.pack ?? "",
@@ -123,7 +147,7 @@ var SkillDBClient = class {
   }
   /** List skills with optional filters and sorting. */
   async list(options) {
-    return this.request("/skills", {
+    return this.typedRequest("/skills", {
       category: options?.category ?? "",
       pack: options?.pack ?? "",
       search: options?.search ?? "",
@@ -136,21 +160,21 @@ var SkillDBClient = class {
   /** 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}`, {
+    const res = await this.typedRequest(`/skills/${encoded}`, {
       include_content: "true"
     });
     return "skill" in res ? res.skill : res;
   }
   /** Batch retrieve multiple skills by IDs (max 50). */
   async batch(ids) {
-    return this.request("/skills", {
+    return this.typedRequest("/skills", {
       ids: ids.slice(0, 50).join(","),
       include_content: "true"
     });
   }
   /** Get search autocomplete suggestions. */
   async suggest(query) {
-    return this.request("/skills/suggest", { q: query });
+    return this.typedRequest("/skills/suggest", { q: query });
   }
   /** Validate that the configured API key works. */
   async validate() {

package/dist/index.cjs.map

@@ -1 +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  ApiKeyScope,\n  ApiKeyInfo,\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      sort: options?.sort ?? '',\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 and sorting. */\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      sort: options?.sort ?? '',\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  /** Batch retrieve multiple skills by IDs (max 50). */\n  async batch(ids: string[]): Promise<SkillsResponse> {\n    return this.request<SkillsResponse>('/skills', {\n      ids: ids.slice(0, 50).join(','),\n      include_content: 'true',\n    });\n  }\n\n  /** Get search autocomplete suggestions. */\n  async suggest(query: string): Promise<{ suggestions: Array<{ title: string; pack: string; category: string; id: string }> }> {\n    return this.request('/skills/suggest', { q: query });\n  }\n\n  /** Validate that the configured API key works. */\n  async validate(): Promise<boolean> {\n    try {\n      const url = `${this.baseUrl}/keys/usage`;\n      const res = await fetch(url, { headers: this.headers() });\n      return res.ok;\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"]}
+{"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  ApiKeyScope,\n  ApiKeyInfo,\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  /** Make an authenticated request to any endpoint (used by MCP tools for private skills). */\n  public async rawRequest(endpoint: string, init?: RequestInit): Promise<Response> {\n    const url = `${this.baseUrl}${endpoint}`;\n    const headers = { ...this.headers(), ...(init?.headers || {}) };\n    return fetch(url, { ...init, headers });\n  }\n\n\n  private async typedRequest<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(() => null);\n      const apiError = body && typeof body === 'object' ? (body as Record<string, string>).error : null;\n      const status = res.status;\n      const statusText = res.statusText || 'Unknown';\n\n      // Build a descriptive error with actionable guidance\n      let msg: string;\n      if (apiError) {\n        msg = apiError;\n      } else if (status === 500) {\n        msg = `SkillDB API internal error (HTTP 500). The service may be experiencing issues. Check status at https://skilldb.dev/api/v1/status`;\n      } else if (status === 503) {\n        msg = `SkillDB API unavailable (HTTP 503). The skills index may not be loaded. Check status at https://skilldb.dev/api/v1/status`;\n      } else if (status === 401) {\n        msg = `Invalid or expired API key (HTTP 401). Get a free key at https://skilldb.dev/api-access`;\n      } else if (status === 429) {\n        msg = `Rate limit exceeded (HTTP 429). Authenticate with an API key for higher limits: https://skilldb.dev/api-access`;\n      } else if (status === 404) {\n        msg = `Resource not found (HTTP 404). The requested skill or endpoint does not exist.`;\n      } else {\n        msg = `SkillDB API error: HTTP ${status} ${statusText}. Check https://skilldb.dev/api/v1/status for service health.`;\n      }\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.typedRequest<SkillsResponse>('/skills', {\n      search: query,\n      category: options?.category ?? '',\n      pack: options?.pack ?? '',\n      sort: options?.sort ?? '',\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 and sorting. */\n  async list(options?: SearchOptions): Promise<SkillsResponse> {\n    return this.typedRequest<SkillsResponse>('/skills', {\n      category: options?.category ?? '',\n      pack: options?.pack ?? '',\n      search: options?.search ?? '',\n      sort: options?.sort ?? '',\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.typedRequest<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  /** Batch retrieve multiple skills by IDs (max 50). */\n  async batch(ids: string[]): Promise<SkillsResponse> {\n    return this.typedRequest<SkillsResponse>('/skills', {\n      ids: ids.slice(0, 50).join(','),\n      include_content: 'true',\n    });\n  }\n\n  /** Get search autocomplete suggestions. */\n  async suggest(query: string): Promise<{ suggestions: Array<{ title: string; pack: string; category: string; id: string }> }> {\n    return this.typedRequest('/skills/suggest', { q: query });\n  }\n\n  /** Validate that the configured API key works. */\n  async validate(): Promise<boolean> {\n    try {\n      const url = `${this.baseUrl}/keys/usage`;\n      const res = await fetch(url, { headers: this.headers() });\n      return res.ok;\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

@@ -78,7 +78,9 @@ declare class SkillDBClient {
     private baseUrl;
     constructor(config?: ClientConfig);
     private headers;
-    private request;
+    /** Make an authenticated request to any endpoint (used by MCP tools for private skills). */
+    rawRequest(endpoint: string, init?: RequestInit): Promise<Response>;
+    private typedRequest;
     /** Search skills by keyword. */
     search(query: string, options?: Omit<SearchOptions, 'search'>): Promise<SkillsResponse>;
     /** List skills with optional filters and sorting. */

package/dist/index.d.ts

@@ -78,7 +78,9 @@ declare class SkillDBClient {
     private baseUrl;
     constructor(config?: ClientConfig);
     private headers;
-    private request;
+    /** Make an authenticated request to any endpoint (used by MCP tools for private skills). */
+    rawRequest(endpoint: string, init?: RequestInit): Promise<Response>;
+    private typedRequest;
     /** Search skills by keyword. */
     search(query: string, options?: Omit<SearchOptions, 'search'>): Promise<SkillsResponse>;
     /** List skills with optional filters and sorting. */

package/dist/index.js

@@ -49,7 +49,13 @@ var SkillDBClient = class {
     }
     return h;
   }
-  async request(endpoint, params) {
+  /** Make an authenticated request to any endpoint (used by MCP tools for private skills). */
+  async rawRequest(endpoint, init) {
+    const url = `${this.baseUrl}${endpoint}`;
+    const headers = { ...this.headers(), ...init?.headers || {} };
+    return fetch(url, { ...init, headers });
+  }
+  async typedRequest(endpoint, params) {
     const url = new URL(`${this.baseUrl}${endpoint}`);
     if (params) {
       for (const [k, v] of Object.entries(params)) {
@@ -58,15 +64,33 @@ var SkillDBClient = class {
     }
     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}`;
+      const body = await res.json().catch(() => null);
+      const apiError = body && typeof body === "object" ? body.error : null;
+      const status = res.status;
+      const statusText = res.statusText || "Unknown";
+      let msg;
+      if (apiError) {
+        msg = apiError;
+      } else if (status === 500) {
+        msg = `SkillDB API internal error (HTTP 500). The service may be experiencing issues. Check status at https://skilldb.dev/api/v1/status`;
+      } else if (status === 503) {
+        msg = `SkillDB API unavailable (HTTP 503). The skills index may not be loaded. Check status at https://skilldb.dev/api/v1/status`;
+      } else if (status === 401) {
+        msg = `Invalid or expired API key (HTTP 401). Get a free key at https://skilldb.dev/api-access`;
+      } else if (status === 429) {
+        msg = `Rate limit exceeded (HTTP 429). Authenticate with an API key for higher limits: https://skilldb.dev/api-access`;
+      } else if (status === 404) {
+        msg = `Resource not found (HTTP 404). The requested skill or endpoint does not exist.`;
+      } else {
+        msg = `SkillDB API error: HTTP ${status} ${statusText}. Check https://skilldb.dev/api/v1/status for service health.`;
+      }
       throw new Error(msg);
     }
     return res.json();
   }
   /** Search skills by keyword. */
   async search(query, options) {
-    return this.request("/skills", {
+    return this.typedRequest("/skills", {
       search: query,
       category: options?.category ?? "",
       pack: options?.pack ?? "",
@@ -78,7 +102,7 @@ var SkillDBClient = class {
   }
   /** List skills with optional filters and sorting. */
   async list(options) {
-    return this.request("/skills", {
+    return this.typedRequest("/skills", {
       category: options?.category ?? "",
       pack: options?.pack ?? "",
       search: options?.search ?? "",
@@ -91,21 +115,21 @@ var SkillDBClient = class {
   /** 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}`, {
+    const res = await this.typedRequest(`/skills/${encoded}`, {
       include_content: "true"
     });
     return "skill" in res ? res.skill : res;
   }
   /** Batch retrieve multiple skills by IDs (max 50). */
   async batch(ids) {
-    return this.request("/skills", {
+    return this.typedRequest("/skills", {
       ids: ids.slice(0, 50).join(","),
       include_content: "true"
     });
   }
   /** Get search autocomplete suggestions. */
   async suggest(query) {
-    return this.request("/skills/suggest", { q: query });
+    return this.typedRequest("/skills/suggest", { q: query });
   }
   /** Validate that the configured API key works. */
   async validate() {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/config.ts","../src/client.ts","../src/cache.ts","../src/index.ts"],"sourcesContent":["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      sort: options?.sort ?? '',\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 and sorting. */\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      sort: options?.sort ?? '',\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  /** Batch retrieve multiple skills by IDs (max 50). */\n  async batch(ids: string[]): Promise<SkillsResponse> {\n    return this.request<SkillsResponse>('/skills', {\n      ids: ids.slice(0, 50).join(','),\n      include_content: 'true',\n    });\n  }\n\n  /** Get search autocomplete suggestions. */\n  async suggest(query: string): Promise<{ suggestions: Array<{ title: string; pack: string; category: string; id: string }> }> {\n    return this.request('/skills/suggest', { q: query });\n  }\n\n  /** Validate that the configured API key works. */\n  async validate(): Promise<boolean> {\n    try {\n      const url = `${this.baseUrl}/keys/usage`;\n      const res = await fetch(url, { headers: this.headers() });\n      return res.ok;\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","export { SkillDBClient } from './client.js';\nexport type {\n  Skill,\n  PackInfo,\n  CategoryInfo,\n  SkillsResponse,\n  SearchOptions,\n  ClientConfig,\n  Manifest,\n  ApiKeyScope,\n  ApiKeyInfo,\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"],"mappings":"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","names":["fs","path"]}
+{"version":3,"sources":["../src/config.ts","../src/client.ts","../src/cache.ts","../src/index.ts"],"sourcesContent":["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  /** Make an authenticated request to any endpoint (used by MCP tools for private skills). */\n  public async rawRequest(endpoint: string, init?: RequestInit): Promise<Response> {\n    const url = `${this.baseUrl}${endpoint}`;\n    const headers = { ...this.headers(), ...(init?.headers || {}) };\n    return fetch(url, { ...init, headers });\n  }\n\n\n  private async typedRequest<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(() => null);\n      const apiError = body && typeof body === 'object' ? (body as Record<string, string>).error : null;\n      const status = res.status;\n      const statusText = res.statusText || 'Unknown';\n\n      // Build a descriptive error with actionable guidance\n      let msg: string;\n      if (apiError) {\n        msg = apiError;\n      } else if (status === 500) {\n        msg = `SkillDB API internal error (HTTP 500). The service may be experiencing issues. Check status at https://skilldb.dev/api/v1/status`;\n      } else if (status === 503) {\n        msg = `SkillDB API unavailable (HTTP 503). The skills index may not be loaded. Check status at https://skilldb.dev/api/v1/status`;\n      } else if (status === 401) {\n        msg = `Invalid or expired API key (HTTP 401). Get a free key at https://skilldb.dev/api-access`;\n      } else if (status === 429) {\n        msg = `Rate limit exceeded (HTTP 429). Authenticate with an API key for higher limits: https://skilldb.dev/api-access`;\n      } else if (status === 404) {\n        msg = `Resource not found (HTTP 404). The requested skill or endpoint does not exist.`;\n      } else {\n        msg = `SkillDB API error: HTTP ${status} ${statusText}. Check https://skilldb.dev/api/v1/status for service health.`;\n      }\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.typedRequest<SkillsResponse>('/skills', {\n      search: query,\n      category: options?.category ?? '',\n      pack: options?.pack ?? '',\n      sort: options?.sort ?? '',\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 and sorting. */\n  async list(options?: SearchOptions): Promise<SkillsResponse> {\n    return this.typedRequest<SkillsResponse>('/skills', {\n      category: options?.category ?? '',\n      pack: options?.pack ?? '',\n      search: options?.search ?? '',\n      sort: options?.sort ?? '',\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.typedRequest<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  /** Batch retrieve multiple skills by IDs (max 50). */\n  async batch(ids: string[]): Promise<SkillsResponse> {\n    return this.typedRequest<SkillsResponse>('/skills', {\n      ids: ids.slice(0, 50).join(','),\n      include_content: 'true',\n    });\n  }\n\n  /** Get search autocomplete suggestions. */\n  async suggest(query: string): Promise<{ suggestions: Array<{ title: string; pack: string; category: string; id: string }> }> {\n    return this.typedRequest('/skills/suggest', { q: query });\n  }\n\n  /** Validate that the configured API key works. */\n  async validate(): Promise<boolean> {\n    try {\n      const url = `${this.baseUrl}/keys/usage`;\n      const res = await fetch(url, { headers: this.headers() });\n      return res.ok;\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","export { SkillDBClient } from './client.js';\nexport type {\n  Skill,\n  PackInfo,\n  CategoryInfo,\n  SkillsResponse,\n  SearchOptions,\n  ClientConfig,\n  Manifest,\n  ApiKeyScope,\n  ApiKeyInfo,\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"],"mappings":"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","names":["fs","path"]}

package/dist/mcp.js

@@ -50,7 +50,13 @@ var SkillDBClient = class {
     }
     return h;
   }
-  async request(endpoint, params) {
+  /** Make an authenticated request to any endpoint (used by MCP tools for private skills). */
+  async rawRequest(endpoint, init) {
+    const url = `${this.baseUrl}${endpoint}`;
+    const headers = { ...this.headers(), ...init?.headers || {} };
+    return fetch(url, { ...init, headers });
+  }
+  async typedRequest(endpoint, params) {
     const url = new URL(`${this.baseUrl}${endpoint}`);
     if (params) {
       for (const [k, v] of Object.entries(params)) {
@@ -59,15 +65,33 @@ var SkillDBClient = class {
     }
     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}`;
+      const body = await res.json().catch(() => null);
+      const apiError = body && typeof body === "object" ? body.error : null;
+      const status = res.status;
+      const statusText = res.statusText || "Unknown";
+      let msg;
+      if (apiError) {
+        msg = apiError;
+      } else if (status === 500) {
+        msg = `SkillDB API internal error (HTTP 500). The service may be experiencing issues. Check status at https://skilldb.dev/api/v1/status`;
+      } else if (status === 503) {
+        msg = `SkillDB API unavailable (HTTP 503). The skills index may not be loaded. Check status at https://skilldb.dev/api/v1/status`;
+      } else if (status === 401) {
+        msg = `Invalid or expired API key (HTTP 401). Get a free key at https://skilldb.dev/api-access`;
+      } else if (status === 429) {
+        msg = `Rate limit exceeded (HTTP 429). Authenticate with an API key for higher limits: https://skilldb.dev/api-access`;
+      } else if (status === 404) {
+        msg = `Resource not found (HTTP 404). The requested skill or endpoint does not exist.`;
+      } else {
+        msg = `SkillDB API error: HTTP ${status} ${statusText}. Check https://skilldb.dev/api/v1/status for service health.`;
+      }
       throw new Error(msg);
     }
     return res.json();
   }
   /** Search skills by keyword. */
   async search(query, options) {
-    return this.request("/skills", {
+    return this.typedRequest("/skills", {
       search: query,
       category: options?.category ?? "",
       pack: options?.pack ?? "",
@@ -79,7 +103,7 @@ var SkillDBClient = class {
   }
   /** List skills with optional filters and sorting. */
   async list(options) {
-    return this.request("/skills", {
+    return this.typedRequest("/skills", {
       category: options?.category ?? "",
       pack: options?.pack ?? "",
       search: options?.search ?? "",
@@ -92,21 +116,21 @@ var SkillDBClient = class {
   /** 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}`, {
+    const res = await this.typedRequest(`/skills/${encoded}`, {
       include_content: "true"
     });
     return "skill" in res ? res.skill : res;
   }
   /** Batch retrieve multiple skills by IDs (max 50). */
   async batch(ids) {
-    return this.request("/skills", {
+    return this.typedRequest("/skills", {
       ids: ids.slice(0, 50).join(","),
       include_content: "true"
     });
   }
   /** Get search autocomplete suggestions. */
   async suggest(query) {
-    return this.request("/skills/suggest", { q: query });
+    return this.typedRequest("/skills/suggest", { q: query });
   }
   /** Validate that the configured API key works. */
   async validate() {
@@ -129,13 +153,47 @@ var hasApiKey = !!apiKey;
 var client = new SkillDBClient({ apiKey, baseUrl });
 if (!hasApiKey) {
   process.stderr.write(
-    "\n\u26A0\uFE0F  SkillDB MCP: No API key configured.\n   You can search and browse skills, but full content requires a Pro key.\n   Get a free key at: https://skilldb.dev/api-access\n   Then run: claude mcp remove skilldb && claude mcp add skilldb -- skilldb-mcp --api-key YOUR_KEY\n\n"
+    "\n\u26A0\uFE0F  SkillDB MCP: No API key configured.\n   You can search and browse skills, but full content requires an API key.\n   Get a free key at: https://skilldb.dev/api-access\n   Then use: skilldb_set_key to configure it (no restart needed)\n   Or restart with: claude mcp remove skilldb && claude mcp add skilldb -- skilldb-mcp --api-key YOUR_KEY\n\n"
   );
 }
 var server = new McpServer({
   name: "skilldb",
-  version: "0.5.2"
+  version: "0.7.0"
 });
+server.registerTool(
+  "skilldb_set_key",
+  {
+    title: "Set SkillDB API Key",
+    description: "Configure your SkillDB API key without restarting the session. Once set, all subsequent calls (search, get, list) will include full skill content. Get a free key at skilldb.dev/api-access.",
+    inputSchema: z.object({
+      key: z.string().describe("Your SkillDB API key (starts with sk_live_ or sk_test_)")
+    })
+  },
+  async ({ key }) => {
+    if (!key.startsWith("sk_")) {
+      return { content: [{ type: "text", text: "Invalid key format. SkillDB API keys start with `sk_live_` or `sk_test_`. Get one at https://skilldb.dev/api-access" }], isError: true };
+    }
+    apiKey = key;
+    hasApiKey = true;
+    client = new SkillDBClient({ apiKey: key, baseUrl });
+    try {
+      const valid = await client.validate();
+      if (valid) {
+        return { content: [{ type: "text", text: `\u2705 **API key configured successfully!**
+
+All SkillDB tools now return full skill content (instructions, patterns, best practices, code examples).
+
+Try: \`skilldb_search\` or \`skilldb_get\` to load skills with full content.` }] };
+      } else {
+        return { content: [{ type: "text", text: `\u26A0\uFE0F **Key set but validation failed.** The key may be invalid or expired. Calls will still be attempted.
+
+Get a new key at https://skilldb.dev/api-access` }] };
+      }
+    } catch {
+      return { content: [{ type: "text", text: `\u2705 **API key set.** Couldn't validate (API may be temporarily unavailable), but the key will be used for all subsequent calls.` }] };
+    }
+  }
+);
 server.registerTool(
   "skilldb_search",
   {
@@ -159,7 +217,7 @@ server.registerTool(
       const noKey = !hasApiKey;
       const text = res.skills.length === 0 ? `No skills found for "${query}".` : (noKey ? `\u26A0\uFE0F **No API key configured** \u2014 showing metadata only. Full skill content (instructions, patterns, code examples) requires a free API key.
 \u{1F449} Get yours in 30 seconds: https://skilldb.dev/api-access
-\u{1F449} Then: \`claude mcp remove skilldb && claude mcp add skilldb -- skilldb-mcp --api-key YOUR_KEY\`
+\u{1F449} Then use \`skilldb_set_key\` with your key (no restart needed)
 
 ---
 
@@ -174,7 +232,7 @@ server.registerTool(
 ---
 Found ${res.pagination.total} total results. Showing ${res.skills.length}.` + (noKey ? `
 
-\u{1F511} **To unlock full content:** Get a free API key at https://skilldb.dev/api-access` : "");
+\u{1F511} **To unlock full content:** Get a free API key at https://skilldb.dev/api-access then use \`skilldb_set_key\`` : "");
       return { content: [{ type: "text", text }] };
     } catch (e) {
       return { content: [{ type: "text", text: `Error: ${e.message}` }], isError: true };
@@ -210,7 +268,7 @@ ${skill.description}
 
 To load the complete ${skill.lines}-line skill with instructions, patterns, and best practices:
 1. Get a free API key at https://skilldb.dev/api-access
-2. Reconfigure: \`claude mcp remove skilldb && claude mcp add skilldb -- skilldb-mcp --api-key YOUR_KEY\`
+2. Use \`skilldb_set_key\` with your key (no restart needed)
 
 Free keys get 100 calls/month. Pro ($9/mo) gets unlimited access.`;
       }
@@ -463,6 +521,123 @@ server.registerTool(
     }
   }
 );
+server.registerTool(
+  "skilldb_my_skills",
+  {
+    title: "List My Private Skills",
+    description: "List your private skills stored on SkillDB. Requires an API key with 'write' scope. Returns all skills you own plus skills shared with you.",
+    inputSchema: z.object({})
+  },
+  async () => {
+    if (!apiKey) {
+      return { content: [{ type: "text", text: "API key required for private skills. Set one with: skilldb-mcp --api-key sk_live_xxx" }], isError: true };
+    }
+    try {
+      const res = await client.rawRequest("/api/v1/my-skills", { method: "GET" });
+      const data = await res.json();
+      if (!res.ok) return { content: [{ type: "text", text: `Error: ${data.error || res.statusText}` }], isError: true };
+      const own = data.skills || [];
+      const shared = data.shared || [];
+      if (own.length === 0 && shared.length === 0) {
+        return { content: [{ type: "text", text: "No private skills yet. Create one with `skilldb_create_skill`." }] };
+      }
+      let text = `## My Private Skills (${own.length})
+
+`;
+      text += own.map((s, i) => `${i + 1}. **${s.title}** (${s.pack})
+   ID: \`${s.id}\` | ${s.lines} lines | ${s.visibility}`).join("\n\n");
+      if (shared.length > 0) {
+        text += `
+
+## Shared With Me (${shared.length})
+
+`;
+        text += shared.map((s, i) => `${i + 1}. **${s.title}** (${s.pack})
+   ID: \`${s.id}\` | ${s.lines} lines | shared by ${s.owner}`).join("\n\n");
+      }
+      return { content: [{ type: "text", text }] };
+    } catch (e) {
+      return { content: [{ type: "text", text: `Error: ${e.message}` }], isError: true };
+    }
+  }
+);
+server.registerTool(
+  "skilldb_create_skill",
+  {
+    title: "Create Private Skill",
+    description: "Create a new private skill in your SkillDB account. The skill is only visible to you (and anyone you share it with). Requires an API key with 'write' scope.",
+    inputSchema: z.object({
+      name: z.string().describe("Skill filename (e.g. 'my-react-patterns')"),
+      title: z.string().describe("Human-readable title"),
+      content: z.string().describe("Full skill content in markdown"),
+      pack: z.string().optional().default("personal").describe("Pack/folder name (default: 'personal')"),
+      tags: z.array(z.string()).optional().describe("Tags for searchability"),
+      description: z.string().optional().describe("Short description (auto-generated from content if omitted)")
+    })
+  },
+  async ({ name, title, content, pack, tags, description }) => {
+    if (!apiKey) {
+      return { content: [{ type: "text", text: "API key required. Set one with: skilldb-mcp --api-key sk_live_xxx" }], isError: true };
+    }
+    try {
+      const res = await client.rawRequest("/api/v1/my-skills", {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ name, title, content, pack, tags, description })
+      });
+      const data = await res.json();
+      if (!res.ok) return { content: [{ type: "text", text: `Error: ${data.error || res.statusText}` }], isError: true };
+      const s = data.skill;
+      return { content: [{ type: "text", text: `\u2705 Private skill created!
+
+**${s.title}**
+ID: \`${s.id}\`
+Pack: ${s.pack}
+Lines: ${s.lines}
+Visibility: ${s.visibility}
+
+You can now find this skill via \`skilldb_search\` or \`skilldb_my_skills\`.` }] };
+    } catch (e) {
+      return { content: [{ type: "text", text: `Error: ${e.message}` }], isError: true };
+    }
+  }
+);
+server.registerTool(
+  "skilldb_update_skill",
+  {
+    title: "Update Private Skill",
+    description: "Update an existing private skill's content, title, tags, or visibility. Requires an API key with 'write' scope.",
+    inputSchema: z.object({
+      id: z.string().describe("Skill ID (e.g. 'personal/my-react-patterns.md')"),
+      title: z.string().optional().describe("New title"),
+      content: z.string().optional().describe("New content"),
+      tags: z.array(z.string()).optional().describe("New tags"),
+      visibility: z.enum(["private", "shared"]).optional().describe("Visibility setting")
+    })
+  },
+  async ({ id, title, content, tags, visibility }) => {
+    if (!apiKey) {
+      return { content: [{ type: "text", text: "API key required." }], isError: true };
+    }
+    try {
+      const body = {};
+      if (title) body.title = title;
+      if (content) body.content = content;
+      if (tags) body.tags = tags;
+      if (visibility) body.visibility = visibility;
+      const res = await client.rawRequest(`/api/v1/my-skills/${encodeURIComponent(id)}`, {
+        method: "PUT",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(body)
+      });
+      const data = await res.json();
+      if (!res.ok) return { content: [{ type: "text", text: `Error: ${data.error || res.statusText}` }], isError: true };
+      return { content: [{ type: "text", text: `\u2705 Skill updated: **${data.skill.title}** (${data.skill.lines} lines)` }] };
+    } catch (e) {
+      return { content: [{ type: "text", text: `Error: ${e.message}` }], isError: true };
+    }
+  }
+);
 var transport = new StdioServerTransport();
 await server.connect(transport);
 //# sourceMappingURL=mcp.js.map