skillfish 1.0.11 → 1.0.13

package/README.md

@@ -20,7 +20,11 @@
 ## Quick Start
 
 ```bash
+# One-off skill installation
 npx skillfish add owner/repo
+
+# For skill management (list, update, remove), install globally
+npm i -g skillfish
 ```
 
 One command installs to **all detected agents** on your system.
@@ -52,11 +56,11 @@ All commands support `--json` for automation.
 ## Examples
 
 ```bash
-npx skillfish add user/my-skill          # Install a skill
-npx skillfish add owner/repo --all       # Install all skills from repo
-npx skillfish list                       # See what's installed
-npx skillfish update                     # Update all skills
-npx skillfish remove old-skill           # Remove a skill
+skillfish add user/my-skill          # Install a skill
+skillfish add owner/repo --all       # Install all skills from repo
+skillfish list                       # See what's installed
+skillfish update                     # Update all skills
+skillfish remove old-skill           # Remove a skill
 ```
 
 ## Supported Agents
@@ -99,15 +103,15 @@ Works with 17+ agents including:
 Install skills from a repository.
 
 ```bash
-npx skillfish add owner/repo                    # Auto-discover SKILL.md
-npx skillfish add owner/repo my-skill           # Install by skill name
-npx skillfish add owner/repo/path/to/skill      # Full path syntax
-npx skillfish add owner/repo --path skills/foo  # Explicit path
-npx skillfish add owner/repo --all              # Install all skills
-npx skillfish add owner/repo --force            # Overwrite existing
-npx skillfish add owner/repo --yes              # Skip confirmation
-npx skillfish add owner/repo --project          # Project only (./)
-npx skillfish add owner/repo --global           # Global only (~/)
+skillfish add owner/repo                    # Auto-discover SKILL.md
+skillfish add owner/repo my-skill           # Install by skill name
+skillfish add owner/repo/path/to/skill      # Full path syntax
+skillfish add owner/repo --path skills/foo  # Explicit path
+skillfish add owner/repo --all              # Install all skills
+skillfish add owner/repo --force            # Overwrite existing
+skillfish add owner/repo --yes              # Skip confirmation
+skillfish add owner/repo --project          # Project only (./)
+skillfish add owner/repo --global           # Global only (~/)
 ```
 
 ### list
@@ -115,10 +119,10 @@ npx skillfish add owner/repo --global           # Global only (~/)
 View installed skills.
 
 ```bash
-npx skillfish list                       # List all installed skills
-npx skillfish list --global              # Global skills only (~/)
-npx skillfish list --project             # Project skills only (./)
-npx skillfish list --agent "Claude Code" # Specific agent
+skillfish list                       # List all installed skills
+skillfish list --global              # Global skills only (~/)
+skillfish list --project             # Project skills only (./)
+skillfish list --agent "Claude Code" # Specific agent
 ```
 
 ### remove
@@ -126,13 +130,13 @@ npx skillfish list --agent "Claude Code" # Specific agent
 Remove installed skills.
 
 ```bash
-npx skillfish remove                          # Interactive picker
-npx skillfish remove my-skill                 # By name
-npx skillfish remove --all                    # Remove all
-npx skillfish remove my-skill --project       # Project only
-npx skillfish remove my-skill --global        # Global only
-npx skillfish remove my-skill --agent "Cursor" # Specific agent
-npx skillfish remove my-skill --yes           # Skip confirmation
+skillfish remove                          # Interactive picker
+skillfish remove my-skill                 # By name
+skillfish remove --all                    # Remove all
+skillfish remove my-skill --project       # Project only
+skillfish remove my-skill --global        # Global only
+skillfish remove my-skill --agent "Cursor" # Specific agent
+skillfish remove my-skill --yes           # Skip confirmation
 ```
 
 ### update
@@ -140,9 +144,9 @@ npx skillfish remove my-skill --yes           # Skip confirmation
 Update installed skills to latest version.
 
 ```bash
-npx skillfish update                     # Check for updates interactively
-npx skillfish update --yes               # Update all without prompting
-npx skillfish update --json              # Check for updates (JSON output)
+skillfish update                     # Check for updates interactively
+skillfish update --yes               # Update all without prompting
+skillfish update --json              # Check for updates (JSON output)
 ```
 
 <details>

package/dist/commands/add.js

@@ -471,11 +471,11 @@ async function discoverSkillPaths(owner, repo, installAll, jsonMode, jsonOutput,
         return { paths: [skill.dir], branch, sha };
     }
     // Build options for selection with frontmatter metadata
-    // Title in label, description in hint (shows on focus)
+    // Title in label, truncated description in hint (keeps UI clean)
     const optionsList = skills.map((skill) => ({
         value: skill.dir,
         label: pc.bold(toTitleCase(skill.name)),
-        hint: skill.description || undefined,
+        hint: skill.description ? truncate(skill.description, 70) : undefined,
     }));
     // Non-TTY or JSON mode: require --all or --path for multiple skills
     if (!isInputTTY() || jsonMode) {

package/dist/index.js

@@ -8,6 +8,7 @@ import { Command } from 'commander';
 import { readFileSync } from 'fs';
 import { fileURLToPath } from 'url';
 import { dirname, join } from 'path';
+import updateNotifier from 'update-notifier';
 import { addCommand } from './commands/add.js';
 import { listCommand } from './commands/list.js';
 import { removeCommand } from './commands/remove.js';
@@ -15,6 +16,8 @@ import { updateCommand } from './commands/update.js';
 // Read version from package.json (single source of truth)
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const pkg = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf-8'));
+// Check for updates (runs in background, non-blocking)
+const notifier = updateNotifier({ pkg });
 const program = new Command()
     .name('skillfish')
     .description('Install and manage AI agent skills from GitHub repositories')
@@ -52,7 +55,17 @@ program.on('option:json', () => {
     // JSON mode is handled by commands
 });
 // Parse and run
-program.parseAsync(process.argv).catch((err) => {
+program
+    .parseAsync(process.argv)
+    .then(() => {
+    // Show update notification after command completes (if update available)
+    notifier.notify({
+        message: `Update available: {currentVersion} → {latestVersion}
+Run: npx skillfish@latest
+Or:  npm i -g skillfish`,
+    });
+})
+    .catch((err) => {
     console.error('Error:', err instanceof Error ? err.message : String(err));
     process.exit(1);
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skillfish",
-  "version": "1.0.11",
+  "version": "1.0.13",
   "description": "Install AI agent skills from GitHub with a single command",
   "type": "module",
   "bin": {
@@ -71,11 +71,13 @@
     "@clack/prompts": "^0.11.0",
     "commander": "^14.0.2",
     "giget": "^3.1.1",
-    "picocolors": "^1.1.1"
+    "picocolors": "^1.1.1",
+    "update-notifier": "^7.3.1"
   },
   "devDependencies": {
     "@eslint/js": "^9.39.2",
     "@types/node": "^20.0.0",
+    "@types/update-notifier": "^6.0.8",
     "eslint": "^9.39.2",
     "eslint-config-prettier": "^10.1.8",
     "husky": "^9.1.7",