skilld 0.0.1 → 0.1.1

package/dist/agent/index.d.mts

@@ -0,0 +1,205 @@
+//#region src/agent/types.d.ts
+/**
+ * Agent types and interfaces
+ */
+type AgentType = 'claude-code' | 'cursor' | 'windsurf' | 'cline' | 'codex' | 'github-copilot' | 'gemini-cli' | 'goose' | 'amp' | 'opencode' | 'roo';
+interface AgentConfig {
+  name: AgentType;
+  displayName: string;
+  /** Project-level skills directory (e.g., .claude/skills) */
+  skillsDir: string;
+  /** Global skills directory (e.g., ~/.claude/skills) */
+  globalSkillsDir: string | undefined;
+  /** Check if agent is installed on the system */
+  detectInstalled: () => boolean;
+  /** CLI command name (if agent has a CLI) */
+  cli?: string;
+}
+interface SkillMetadata {
+  name: string;
+  version?: string;
+  /** ISO date string when this version was released */
+  releasedAt?: string;
+  description?: string;
+  /** File patterns this skill applies to (e.g., ["*.vue", "*.ts"]) */
+  globs?: string[];
+}
+/**
+ * Mapping of packages to file patterns they process.
+ * Used to generate skill descriptions with file extension triggers.
+ */
+declare const FILE_PATTERN_MAP: Record<string, string[]>;
+//#endregion
+//#region src/agent/detect.d.ts
+/**
+ * Detect which agents are installed on the system
+ */
+declare function detectInstalledAgents(): AgentType[];
+/**
+ * Detect the target agent (where skills are installed) from env vars and cwd.
+ * This is NOT the generator LLM — it determines the skills directory.
+ */
+declare function detectTargetAgent(): AgentType | null;
+/**
+ * Get the version of an agent's CLI (if available)
+ */
+declare function getAgentVersion(agentType: AgentType): string | null;
+//#endregion
+//#region src/agent/detect-imports.d.ts
+/**
+ * Detect directly-used npm packages by scanning source files
+ * Uses mlly for proper ES module parsing + globby for gitignore support
+ */
+interface PackageUsage {
+  name: string;
+  count: number;
+  source?: 'import' | 'preset';
+}
+interface DetectResult {
+  packages: PackageUsage[];
+  error?: string;
+}
+/**
+ * Scan source files to detect all directly-imported npm packages
+ * Async with gitignore support for proper spinner animation
+ */
+declare function detectImportedPackages(cwd?: string): Promise<DetectResult>;
+//#endregion
+//#region src/agent/install.d.ts
+/**
+ * Sanitize skill name for filesystem
+ */
+declare function sanitizeName(name: string): string;
+/**
+ * Install a skill directly to agent skill directories
+ * Writes to each agent's skill folder in the project (e.g., .claude/skills/package-name/)
+ */
+declare function installSkillForAgents(skillName: string, skillContent: string, options?: {
+  global?: boolean;
+  cwd?: string;
+  agents?: AgentType[]; /** Additional files to write (filename -> content) */
+  files?: Record<string, string>;
+}): {
+  installed: AgentType[];
+  paths: string[];
+};
+//#endregion
+//#region src/agent/prompts/prompt.d.ts
+/**
+ * Skill generation prompt - minimal, agent explores via tools
+ */
+type SkillSection = 'best-practices' | 'api' | 'custom';
+interface BuildSkillPromptOptions {
+  packageName: string;
+  /** Absolute path to skill directory with ./.skilld/ */
+  skillDir: string;
+  /** Package version (e.g., "3.5.13") */
+  version?: string;
+  /** Has GitHub data (issues + discussions) indexed */
+  hasGithub?: boolean;
+  /** Has release notes */
+  hasReleases?: boolean;
+  /** CHANGELOG filename if found in package (e.g. CHANGELOG.md, changelog.md) */
+  hasChangelog?: string | false;
+  /** Resolved absolute paths to .md doc files */
+  docFiles?: string[];
+  /** Doc source type */
+  docsType?: 'llms.txt' | 'readme' | 'docs';
+  /** Package ships its own docs */
+  hasShippedDocs?: boolean;
+  /** Which sections to generate (defaults to all) */
+  sections?: SkillSection[];
+  /** Custom instructions from the user (when 'custom' section selected) */
+  customPrompt?: string;
+}
+/**
+ * Build the skill generation prompt - agent uses tools to explore
+ */
+declare function buildSkillPrompt(opts: BuildSkillPromptOptions): string;
+//#endregion
+//#region src/agent/prompts/skill.d.ts
+/**
+ * SKILL.md file generation
+ */
+interface SkillOptions {
+  name: string;
+  version?: string;
+  releasedAt?: string;
+  /** Production dependencies with version specifiers */
+  dependencies?: Record<string, string>;
+  /** npm dist-tags with version and release date */
+  distTags?: Record<string, {
+    version: string;
+    releasedAt?: string;
+  }>;
+  globs?: string[];
+  description?: string;
+  /** LLM-generated body — replaces default heading + description */
+  body?: string;
+  relatedSkills: string[];
+  hasGithub?: boolean;
+  hasReleases?: boolean;
+  hasChangelog?: string | false;
+  docsType?: 'llms.txt' | 'readme' | 'docs';
+  hasShippedDocs?: boolean;
+  /** Key files in package (entry points + docs) */
+  pkgFiles?: string[];
+}
+declare function generateSkillMd(opts: SkillOptions): string;
+//#endregion
+//#region src/agent/llm/index.d.ts
+type OptimizeModel = 'opus' | 'sonnet' | 'haiku' | 'gemini-3-pro' | 'gemini-3-flash' | 'gemini-2.5-pro' | 'gemini-2.5-flash' | 'gemini-2.5-flash-lite' | 'codex';
+interface ModelInfo {
+  id: OptimizeModel;
+  name: string;
+  hint: string;
+  recommended?: boolean;
+  agentId: string;
+  agentName: string;
+}
+interface StreamProgress {
+  chunk: string;
+  type: 'reasoning' | 'text';
+  text: string;
+  reasoning: string;
+}
+interface OptimizeDocsOptions {
+  packageName: string;
+  skillDir: string;
+  model?: OptimizeModel;
+  version?: string;
+  hasGithub?: boolean;
+  hasReleases?: boolean;
+  hasChangelog?: string | false;
+  docFiles?: string[];
+  onProgress?: (progress: StreamProgress) => void;
+  timeout?: number;
+  verbose?: boolean;
+  noCache?: boolean;
+  /** Which sections to generate */
+  sections?: SkillSection[];
+  /** Custom instructions from the user */
+  customPrompt?: string;
+}
+interface OptimizeResult {
+  optimized: string;
+  wasOptimized: boolean;
+  error?: string;
+  reasoning?: string;
+  finishReason?: string;
+  usage?: {
+    inputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+  };
+  cost?: number;
+}
+declare function getModelName(id: OptimizeModel): string;
+declare function getAvailableModels(): Promise<ModelInfo[]>;
+declare function optimizeDocs(opts: OptimizeDocsOptions): Promise<OptimizeResult>;
+//#endregion
+//#region src/agent/registry.d.ts
+declare const agents: Record<AgentType, AgentConfig>;
+//#endregion
+export { type AgentConfig, type AgentType, FILE_PATTERN_MAP, type ModelInfo, type OptimizeDocsOptions, type OptimizeModel, type OptimizeResult, type SkillMetadata, type SkillOptions, type SkillSection, type StreamProgress, agents, buildSkillPrompt, detectImportedPackages, detectInstalledAgents, detectTargetAgent, generateSkillMd, getAgentVersion, getAvailableModels, getModelName, installSkillForAgents, optimizeDocs, sanitizeName };
+//# sourceMappingURL=index.d.mts.map

package/dist/agent/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/agent/types.ts","../../src/agent/detect.ts","../../src/agent/detect-imports.ts","../../src/agent/install.ts","../../src/agent/prompts/prompt.ts","../../src/agent/prompts/skill.ts","../../src/agent/llm/index.ts","../../src/agent/registry.ts"],"mappings":";;AAIA;;KAAY,SAAA;AAAA,UAaK,WAAA;EACf,IAAA,EAAM,SAAA;EACN,WAAA;EAF0B;EAI1B,SAAA;EAHe;EAKf,eAAA;EALM;EAON,eAAA;EAJA;EAMA,GAAA;AAAA;AAAA,UAGe,aAAA;EACf,IAAA;EACA,OAAA;EAFe;EAIf,UAAA;EACA,WAAA;EAL4B;EAO5B,KAAA;AAAA;;;;;cAOW,gBAAA,EAAkB,MAAA;;;;;AA3B/B;iBCJgB,qBAAA,CAAA,GAAyB,SAAA;;;;;iBAUzB,iBAAA,CAAA,GAAqB,SAAA;;;;iBAmFrB,eAAA,CAAgB,SAAA,EAAW,SAAA;;;;ADtG3C;;;UEMiB,YAAA;EACf,IAAA;EACA,KAAA;EACA,MAAA;AAAA;AAAA,UAGe,YAAA;EACf,QAAA,EAAU,YAAA;EACV,KAAA;AAAA;;;;;iBAwBoB,sBAAA,CAAuB,GAAA,YAA8B,OAAA,CAAQ,YAAA;;;;;AFzBnF;iBGJgB,YAAA,CAAa,IAAA;;;;;iBAYb,qBAAA,CACd,SAAA,UACA,YAAA,UACA,OAAA;EACE,MAAA;EACA,GAAA;EACA,MAAA,GAAS,SAAA,IHJX;EGME,KAAA,GAAQ,MAAA;AAAA;EAEP,SAAA,EAAW,SAAA;EAAa,KAAA;AAAA;;;;AH/B7B;;KIEY,YAAA;AAAA,UAEK,uBAAA;EACf,WAAA;EJQe;EINf,QAAA;;EAEA,OAAA;EJKA;EIHA,SAAA;EJIA;EIFA,WAAA;EJMA;EIJA,YAAA;EJQA;EINA,QAAA;EJMG;EIJH,QAAA;EJO4B;EIL5B,cAAA;EJK4B;EIH5B,QAAA,GAAW,YAAA;EJKX;EIHA,YAAA;AAAA;;;;iBAkEc,gBAAA,CAAiB,IAAA,EAAM,uBAAA;;;;AJ3FvC;;UKGiB,YAAA;EACf,IAAA;EACA,OAAA;EACA,UAAA;ELO0B;EKL1B,YAAA,GAAe,MAAA;ELMA;EKJf,QAAA,GAAW,MAAA;IAAiB,OAAA;IAAiB,UAAA;EAAA;EAC7C,KAAA;EACA,WAAA;ELWA;EKTA,IAAA;EACA,aAAA;EACA,SAAA;EACA,WAAA;EACA,YAAA;EACA,QAAA;EACA,cAAA;ELQA;EKNA,QAAA;AAAA;AAAA,iBAGc,eAAA,CAAgB,IAAA,EAAM,YAAA;;;KCP1B,aAAA;AAAA,UAWK,SAAA;EACf,EAAA,EAAI,aAAA;EACJ,IAAA;EACA,IAAA;EACA,WAAA;EACA,OAAA;EACA,SAAA;AAAA;AAAA,UAGe,cAAA;EACf,KAAA;EACA,IAAA;EACA,IAAA;EACA,SAAA;AAAA;AAAA,UAGe,mBAAA;EACf,WAAA;EACA,QAAA;EACA,KAAA,GAAQ,aAAA;EACR,OAAA;EACA,SAAA;EACA,WAAA;EACA,YAAA;EACA,QAAA;EACA,UAAA,IAAc,QAAA,EAAU,cAAA;EACxB,OAAA;EACA,OAAA;EACA,OAAA;ELhDc;EKkDd,QAAA,GAAW,YAAA;;EAEX,YAAA;AAAA;AAAA,UAGe,cAAA;EACf,SAAA;EACA,YAAA;EACA,KAAA;EACA,SAAA;EACA,YAAA;EACA,KAAA;IAAU,WAAA;IAAqB,YAAA;IAAsB,WAAA;EAAA;EACrD,IAAA;AAAA;AAAA,iBA0Bc,YAAA,CAAa,EAAA,EAAI,aAAA;AAAA,iBAIX,kBAAA,CAAA,GAAsB,OAAA,CAAQ,SAAA;AAAA,iBAoO9B,YAAA,CAAa,IAAA,EAAM,mBAAA,GAAsB,OAAA,CAAQ,cAAA;;;cC/T1D,MAAA,EAAQ,MAAA,CAAO,SAAA,EAAW,WAAA"}

package/dist/agent/index.mjs

@@ -0,0 +1,2 @@
+import { a as FILE_PATTERN_MAP, c as sanitizeName, d as detectTargetAgent, f as getAgentVersion, i as generateSkillMd, l as detectImportedPackages, n as getModelName, o as buildSkillPrompt, p as agents, r as optimizeDocs, s as installSkillForAgents, t as getAvailableModels, u as detectInstalledAgents } from "../_chunks/llm.mjs";
+export { FILE_PATTERN_MAP, agents, buildSkillPrompt, detectImportedPackages, detectInstalledAgents, detectTargetAgent, generateSkillMd, getAgentVersion, getAvailableModels, getModelName, installSkillForAgents, optimizeDocs, sanitizeName };

package/dist/cache/index.d.mts

@@ -0,0 +1,2 @@
+import { C as CachedDoc, D as SEARCH_DB, E as REFERENCES_DIR, O as getPackageDbPath, S as CacheConfig, T as CACHE_DIR, _ as listCached, a as clearAllCache, b as resolvePkgDir, c as getPkgKeyFiles, d as isCached, f as linkGithub, g as linkShippedSkill, h as linkReleases, i as ShippedSkill, l as getShippedSkills, m as linkReferences, n as getCacheKey, o as clearCache, p as linkPkg, r as getVersionKey, s as ensureCacheDir, t as getCacheDir, u as hasShippedDocs, v as listReferenceFiles, w as CachedPackage, x as writeToCache, y as readCachedDocs } from "../_chunks/version.mjs";
+export { CACHE_DIR, type CacheConfig, type CachedDoc, type CachedPackage, REFERENCES_DIR, SEARCH_DB, type ShippedSkill, clearAllCache, clearCache, ensureCacheDir, getCacheDir, getCacheKey, getPackageDbPath, getPkgKeyFiles, getShippedSkills, getVersionKey, hasShippedDocs, isCached, linkGithub, linkPkg, linkReferences, linkReleases, linkShippedSkill, listCached, listReferenceFiles, readCachedDocs, resolvePkgDir, writeToCache };

package/dist/cache/index.mjs

@@ -0,0 +1,3 @@
+import { a as getCacheDir, i as getPackageDbPath, n as REFERENCES_DIR, o as getCacheKey, r as SEARCH_DB, s as getVersionKey, t as CACHE_DIR } from "../_chunks/config.mjs";
+import { _ as writeToCache, a as getShippedSkills, c as linkGithub, d as linkReleases, f as linkShippedSkill, g as resolvePkgDir, h as readCachedDocs, i as getPkgKeyFiles, l as linkPkg, m as listReferenceFiles, n as clearCache, o as hasShippedDocs, p as listCached, r as ensureCacheDir, s as isCached, t as clearAllCache, u as linkReferences } from "../_chunks/storage.mjs";
+export { CACHE_DIR, REFERENCES_DIR, SEARCH_DB, clearAllCache, clearCache, ensureCacheDir, getCacheDir, getCacheKey, getPackageDbPath, getPkgKeyFiles, getShippedSkills, getVersionKey, hasShippedDocs, isCached, linkGithub, linkPkg, linkReferences, linkReleases, linkShippedSkill, listCached, listReferenceFiles, readCachedDocs, resolvePkgDir, writeToCache };