simba-skills 0.2.0 → 0.3.0

package/README.md

@@ -1,5 +1,9 @@
 # Simba
 
+<p align="center">
+  <img src="assets/simba.jpg" alt="Simba the cat" width="600">
+</p>
+
 [![npm version](https://img.shields.io/npm/v/simba-skills)](https://www.npmjs.com/package/simba-skills)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "simba-skills",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "AI skills manager - central store with symlink-based distribution across 14+ coding agents",
   "publishConfig": {
     "access": "public",
@@ -31,7 +31,7 @@
   },
   "files": [
     "src",
-    "!src/**/*.test.ts"
+    "!assets"
   ],
   "scripts": {
     "dev": "bun run src/index.ts",

package/src/commands/install.ts

@@ -281,6 +281,7 @@ export interface InstallOptions {
   skillsDir: string
   registryPath: string
   useSSH: boolean
+  skillName?: string // Install specific skill by name, skip selection
   onSelect: (skills: DiscoveredSkill[]) => Promise<string[]>
 }
 
@@ -346,16 +347,30 @@ export async function runInstall(options: InstallOptions): Promise<void> {
       return
     }
 
-    console.log(`\nFound ${discovered.length} skills:`)
-    for (const skill of discovered) {
-      console.log(`  * ${skill.name}${skill.description ? ` - ${skill.description}` : ""}`)
-    }
+    let selected: string[]
 
-    const selected = await options.onSelect(discovered)
+    if (options.skillName) {
+      // Direct install of specific skill
+      const skill = discovered.find(s => s.name === options.skillName)
+      if (!skill) {
+        console.log(`Skill "${options.skillName}" not found in source.`)
+        console.log(`Available skills: ${discovered.map(s => s.name).join(", ")}`)
+        return
+      }
+      selected = [options.skillName]
+      console.log(`Installing skill: ${options.skillName}`)
+    } else {
+      console.log(`\nFound ${discovered.length} skills:`)
+      for (const skill of discovered) {
+        console.log(`  * ${skill.name}${skill.description ? ` - ${skill.description}` : ""}`)
+      }
 
-    if (selected.length === 0) {
-      console.log("No skills selected.")
-      return
+      selected = await options.onSelect(discovered)
+
+      if (selected.length === 0) {
+        console.log("No skills selected.")
+        return
+      }
     }
 
     for (const name of selected) {
@@ -458,6 +473,7 @@ export default defineCommand({
   args: {
     source: { type: "positional", description: "GitHub repo (user/repo) or local path", required: true },
     ssh: { type: "boolean", description: "Use SSH for GitHub repos (for private repos)", default: false },
+    skill: { type: "string", description: "Install specific skill by name (skip selection)", required: false },
   },
   async run({ args }) {
     await runInstall({
@@ -465,6 +481,7 @@ export default defineCommand({
       skillsDir: getSkillsDir(),
       registryPath: getRegistryPath(),
       useSSH: args.ssh,
+      skillName: args.skill,
       onSelect: async (skills) => {
         const result = await p.multiselect({
           message: "Select skills to install:",

package/src/commands/update.ts

@@ -1,9 +1,10 @@
 import { defineCommand } from "citty"
-import { readFile, mkdir, rm } from "node:fs/promises"
-import { join } from "node:path"
+import { readFile, readdir, mkdir, rm } from "node:fs/promises"
+import { join, relative } from "node:path"
 import * as p from "@clack/prompts"
 import simpleGit from "simple-git"
 import { tmpdir } from "node:os"
+import { createHash } from "node:crypto"
 import { RegistryStore } from "../core/registry-store"
 import { SkillsStore } from "../core/skills-store"
 import { getSkillsDir, getRegistryPath } from "../utils/paths"
@@ -12,6 +13,50 @@ import { discoverSkills } from "./install"
 import type { ManagedSkill, InstallSource } from "../core/types"
 import matter from "gray-matter"
 
+/**
+ * Recursively get all files in a directory (sorted for deterministic hashing)
+ */
+async function getAllFiles(dir: string): Promise<string[]> {
+  const files: string[] = []
+  
+  async function scan(currentDir: string): Promise<void> {
+    const entries = await readdir(currentDir, { withFileTypes: true })
+    for (const entry of entries) {
+      const fullPath = join(currentDir, entry.name)
+      if (entry.isDirectory()) {
+        await scan(fullPath)
+      } else {
+        files.push(relative(dir, fullPath))
+      }
+    }
+  }
+  
+  await scan(dir)
+  return files.sort()
+}
+
+/**
+ * Compute a content hash for an entire skill directory.
+ * Hash includes: sorted file paths + their contents
+ */
+async function hashSkillDir(dir: string): Promise<string> {
+  const files = await getAllFiles(dir)
+  const hash = createHash("sha256")
+  
+  for (const file of files) {
+    // Include file path in hash (detects renames/additions/deletions)
+    hash.update(file)
+    hash.update("\0")
+    
+    // Include file content
+    const content = await readFile(join(dir, file))
+    hash.update(content)
+    hash.update("\0")
+  }
+  
+  return hash.digest("hex")
+}
+
 interface SkillUpdate {
   skill: ManagedSkill
   newPath: string
@@ -119,16 +164,23 @@ export async function runUpdate(options: UpdateOptions): Promise<void> {
           continue
         }
 
-        const existingPath = join(options.skillsDir, skill.name, "SKILL.md")
-        const existingContent = await readFile(existingPath, "utf-8")
-        const newContent = await readFile(join(remote.path, "SKILL.md"), "utf-8")
-
-        const comparison = compareFiles(existingContent, newContent, "SKILL.md")
+        const localDir = join(options.skillsDir, skill.name)
+        
+        // Hash entire directories to detect any file changes
+        const [localHash, remoteHash] = await Promise.all([
+          hashSkillDir(localDir),
+          hashSkillDir(remote.path)
+        ])
 
-        if (comparison.identical) {
+        if (localHash === remoteHash) {
           console.log(`  ✓ ${skill.name}: up to date`)
         } else {
           console.log(`  ↑ ${skill.name}: update available`)
+          
+          // Still read SKILL.md for version display purposes
+          const existingContent = await readFile(join(localDir, "SKILL.md"), "utf-8")
+          const newContent = await readFile(join(remote.path, "SKILL.md"), "utf-8")
+          
           allUpdates.push({
             skill,
             newPath: remote.path,

package/src/core/config-store.ts

@@ -13,7 +13,7 @@ const AGENT_DEFINITIONS: [string, string, string, string, string][] = [
     ["windsurf", "Windsurf", "Windsurf", "~/.codeium/windsurf/skills", ".windsurf/skills"],
     ["amp", "Amp", "Amp", "~/.config/agents/skills", ".agents/skills"],
     ["goose", "Goose", "Goose", "~/.config/goose/skills", ".goose/skills"],
-    ["opencode", "OpenCode", "OpenCode", "~/.config/opencode/skill", ".opencode/skill"],
+    ["opencode", "OpenCode", "OpenCode", "~/.config/opencode/skills", ".opencode/skills"],
     ["kilo", "Kilo Code", "Kilo", "~/.kilocode/skills", ".kilocode/skills"],
     ["roo", "Roo Code", "Roo", "~/.roo/skills", ".roo/skills"],
     ["antigravity", "Antigravity", "Antigrav", "~/.gemini/antigravity/skills", ".agent/skills"],