feat: crate package support (#4)

Co-authored-by: Harlan Wilton <harlan@harlanzw.com>

Author: oritwoen

README.md

@@ -149,6 +149,9 @@ skilld add npm:vue npm:nuxt npm:pinia
 # Add a pre-authored skill from a GitHub repo
 skilld add gh:vercel-labs/agent-skills
 
+# Add a skill for a Rust crate (crates.io)
+skilld add crate:serde
+
 # Update outdated skills
 skilld update
 skilld update tailwindcss
@@ -183,7 +186,7 @@ skilld config
 | Command | Description |
 |---------|-------------|
 | `skilld` | Interactive wizard (first run) or status menu (existing skills) |
-| `skilld add <source...>` | Add skills. Sources: `npm:<pkg>`, `gh:<owner/repo>`, or bare names (deprecated) |
+| `skilld add <source...>` | Add skills. Sources: `npm:<pkg>`, `crate:<name>`, `gh:<owner/repo>`, or bare names (deprecated) |
 | `skilld update [pkg]`   | Update outdated skills (all or specific) |
 | `skilld search [query]` | Search indexed docs (`-p` package, `--filter` JSON, `--limit`, `--guide`) |
 | `skilld list`           | List installed skills (`--json` for machine-readable output) |

src/commands/install.ts

@@ -40,6 +40,7 @@ import { defaultFeatures, readConfig } from '../core/config.ts'
 import { timedSpinner } from '../core/formatting.ts'
 import { mergeLocks, parsePackages, readLock, syncLockfilesToDirs, writeLock } from '../core/lockfile.ts'
 import { readPackageJsonSafe } from '../core/package-json.ts'
+import { toStoragePackageName } from '../core/prefix.ts'
 import { sanitizeMarkdown } from '../core/sanitize.ts'
 import { getSharedSkillsDir } from '../core/shared.ts'
 import { createIndex, SearchDepsUnavailableError } from '../retriv/index.ts'
@@ -118,7 +119,7 @@ export async function installCommand(opts: InstallOptions): Promise<void> {
     const needsRestore = !existsSync(skillDir)
       || !existsSync(skillMdPath)
       || !existsSync(referencesPath)
-      || hasStaleReferences(referencesPath, info.packageName || name, info.version!, features)
+      || hasStaleReferences(referencesPath, toStoragePackageName(info.packageName || name), info.version!, features)
 
     if (needsRestore) {
       toRestore.push({ name, info })
@@ -138,7 +139,8 @@ export async function installCommand(opts: InstallOptions): Promise<void> {
 
   for (const { name, info } of toRestore) {
     const version = info.version!
-    const pkgName = info.packageName || unsanitizeName(name, info.source)
+    const identityName = info.packageName || unsanitizeName(name, info.source)
+    const pkgName = toStoragePackageName(identityName)
 
     // Shipped skills: re-link from node_modules or cached dist
     if (info.source === 'shipped') {

src/commands/search-helpers.ts

@@ -5,6 +5,7 @@ import { join } from 'pathe'
 import { agents, detectTargetAgent } from '../agent/index.ts'
 import { getPackageDbPath, REFERENCES_DIR } from '../cache/index.ts'
 import { readLock } from '../core/index.ts'
+import { toStoragePackageName } from '../core/prefix.ts'
 import { getSharedSkillsDir } from '../core/shared.ts'
 
 /** Collect search.db paths for packages installed in the current project (from skilld-lock.yaml) */
@@ -72,10 +73,11 @@ function filterLockDbs(lock: ReturnType<typeof readLock>, packageFilter?: string
       return filterTokens.every(ft => nameTokens.some(nt => nt.includes(ft) || ft.includes(nt)))
     })
     .map((info) => {
-      const exact = getPackageDbPath(info.packageName!, info.version!)
+      const storageName = toStoragePackageName(info.packageName!)
+      const exact = getPackageDbPath(storageName, info.version!)
       if (existsSync(exact))
         return exact
-      const fallback = findAnyPackageDb(info.packageName!)
+      const fallback = findAnyPackageDb(storageName)
       if (fallback)
         p.log.warn(`Using cached search index for ${info.packageName} (v${info.version} not indexed). Run \`skilld update ${info.packageName}\` to re-index.`)
       return fallback

src/commands/status.ts

@@ -11,6 +11,7 @@ import { sharedArgs } from '../cli-helpers.ts'
 import { defaultFeatures, hasConfig, readConfig } from '../core/config.ts'
 import { formatSource, timeAgo } from '../core/formatting.ts'
 import { parsePackages } from '../core/lockfile.ts'
+import { toStoragePackageName } from '../core/prefix.ts'
 import { getSharedSkillsDir, mapInsert } from '../core/shared.ts'
 
 import { iterateSkills } from '../core/skills.ts'
@@ -211,7 +212,7 @@ export async function statusCommand(opts: StatusOptions = {}): Promise<void> {
       lines.push(parts.join('  '))
 
       const meta: string[] = []
-      const pkgName = info.packageName || pkg.name
+      const pkgName = toStoragePackageName(info.packageName || pkg.name)
       const docs = countDocs(pkgName, info.version) || countRefDocs(join(
         pkg.scope === 'global'
           ? agents[pkg.agents.values().next().value!].globalSkillsDir!

src/commands/sync-shared.ts

@@ -1357,6 +1357,8 @@ export async function selectLlmConfig(presetModel?: OptimizeModel, message?: str
 
 export interface EnhanceOptions {
   packageName: string
+  /** Storage/cache key (e.g. namespaced '@skilld-crate/serde'); defaults to packageName */
+  cachePackageName?: string
   version: string
   skillDir: string
   dirName?: string
@@ -1381,15 +1383,16 @@ export interface EnhanceOptions {
 }
 
 export async function enhanceSkillWithLLM(opts: EnhanceOptions): Promise<void> {
-  const { packageName, version, skillDir, dirName, model, resolved, relatedSkills, hasIssues, hasDiscussions, hasReleases, hasChangelog, docsType, hasShippedDocs: shippedDocs, pkgFiles, force, debug, sections, customPrompt, packages, features, eject, overheadLines } = opts
+  const { packageName, cachePackageName, version, skillDir, dirName, model, resolved, relatedSkills, hasIssues, hasDiscussions, hasReleases, hasChangelog, docsType, hasShippedDocs: shippedDocs, pkgFiles, force, debug, sections, customPrompt, packages, features, eject, overheadLines } = opts
+  const cacheKey = cachePackageName || packageName
 
   const effectiveFeatures = features
 
   const llmLog = p.taskLog({ title: `Agent exploring ${packageName}`, limit: 3 })
   const docFiles = listReferenceFiles(skillDir)
   const hasGithub = hasIssues || hasDiscussions
   const { optimized, wasOptimized, usage, cost, warnings, error, debugLogsDir } = await optimizeDocs({
-    packageName,
+    packageName: cacheKey,
     skillDir,
     model,
     version,