happyskills 0.33.1 → 0.35.0

package/CHANGELOG.md

@@ -7,6 +7,25 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
+## [0.35.0] - 2026-04-10
+
+### Added
+- Add multi-skill `install` — pass multiple skills in one command (e.g., `happyskills install acme/foo acme/bar@1.0 teamb/baz`)
+- Add multi-skill `uninstall` — remove multiple skills in one command (e.g., `happyskills uninstall acme/foo acme/bar`)
+- Add per-skill inline `@version` pinning for multi-skill install (e.g., `acme/foo@1.2.0 acme/bar@latest`)
+- Add graceful error handling for batch operations — individual failures print a warning and do not interrupt remaining skills
+- Add `--version` flag guard — rejects ambiguous usage with multiple skills, directs to inline `@version` syntax
+- Add `errors` array in JSON output for partial failures alongside successful `data`
+
+## [0.34.0] - 2026-04-09
+
+### Changed
+- Make smart search (semantic + quality ranking) the default when a query is provided — `search "query"` now uses hybrid vector + full-text matching instead of keyword-only
+
+### Added
+- Add `--exact` flag to `search` command to opt out of smart search and use keyword-only matching
+- Add `hint` field to `--exact --json` responses nudging users toward smart search for better results
+
 ## [0.33.1] - 2026-04-08
 
 ### Fixed

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "happyskills",
-	"version": "0.33.1",
+	"version": "0.35.0",
 	"description": "Package manager for AI agent skills",
 	"license": "SEE LICENSE IN LICENSE",
 	"author": "Nicolas Dao <nic@cloudlesslabs.com> (https://cloudlesslabs.com)",

package/src/commands/install.js

@@ -2,14 +2,14 @@ const { error: { catch_errors, wrap_errors: e } } = require('puffy-core')
 const { install, install_from_manifest, install_from_lock } = require('../engine/installer')
 const { read_lock } = require('../lock/reader')
 const { read_manifest } = require('../manifest/reader')
-const { print_help, print_hint, print_json, code } = require('../ui/output')
+const { print_help, print_hint, print_json, print_warn, code } = require('../ui/output')
 const { exit_with_error, UsageError } = require('../utils/errors')
 const { find_project_root } = require('../config/paths')
 const { EXIT_CODES } = require('../constants')
 
-const HELP_TEXT = `Usage: happyskills install [<owner>/<skill>[@<version>]] [options]
+const HELP_TEXT = `Usage: happyskills install [<owner>/<skill>[@<version>]] [...] [options]
 
-Install a skill and its dependencies.
+Install one or more skills and their dependencies.
 Without arguments, installs all dependencies from skill.json (or skills-lock.json if no skill.json exists).
 
 Arguments:
@@ -18,8 +18,8 @@ Arguments:
   owner/skill@latest       Force install of the latest version (bypasses lock skip check)
 
 Options:
-  -g, --global        Install globally (~/.claude/skills/)
-  --version <ver>     Pin to specific version (overrides inline @version)
+  -g, --global        Install globally (~/.agents/skills/)
+  --version <ver>     Pin to specific version (single skill only, overrides inline @version)
   --force             Force install on dependency conflicts
   --fresh             Ignore lock file, re-resolve from scratch
   --agents <list>     Target specific agents (comma-separated, e.g., claude,cursor)
@@ -32,8 +32,8 @@ Aliases: i, add
 Examples:
   happyskills install
   happyskills install acme/deploy-aws
-  happyskills install acme/deploy-aws@1.2.0
-  happyskills install acme/deploy-aws@latest
+  happyskills install acme/deploy-aws acme/monitor acme/logging
+  happyskills install acme/deploy-aws@1.2.0 acme/monitor@latest
   happyskills install acme/deploy-aws --version 1.2.0
   happyskills i acme/deploy-aws -g`
 
@@ -43,20 +43,9 @@ const run = (args) => catch_errors('Install failed', async () => {
 		return process.exit(EXIT_CODES.SUCCESS)
 	}
 
-	let skill = args._[0]
-	let version = args.flags.version || undefined
-
-	// Support owner/skill@version inline syntax
-	if (skill && skill.includes('@')) {
-		const at_idx = skill.lastIndexOf('@')
-		const inline_version = skill.slice(at_idx + 1)
-		skill = skill.slice(0, at_idx)
-		if (inline_version && !args.flags.version) version = inline_version
-	}
-
-	const options = {
+	const skills_raw = args._
+	const base_options = {
 		global: args.flags.global || false,
-		version,
 		force: args.flags.force || false,
 		fresh: args.flags.fresh || false,
 		yes: args.flags.yes || false,
@@ -64,12 +53,12 @@ const run = (args) => catch_errors('Install failed', async () => {
 		project_root: find_project_root()
 	}
 
-	if (!skill) {
+	if (skills_raw.length === 0) {
 		const [manifest_err, manifest] = await read_manifest()
 		if (manifest_err) {
-			const [, lock_data] = await read_lock(options.project_root)
+			const [, lock_data] = await read_lock(base_options.project_root)
 			if (lock_data && lock_data.skills && Object.keys(lock_data.skills).length > 0) {
-				const [errors, result] = await install_from_lock(lock_data, options)
+				const [errors, result] = await install_from_lock(lock_data, base_options)
 				if (errors) throw e('Install from lock failed', errors)
 				if (args.flags.json) {
 					print_json({ data: result })
@@ -80,7 +69,7 @@ const run = (args) => catch_errors('Install failed', async () => {
 			throw new UsageError("No skill specified and no skill.json found. Run 'happyskills init' to create a skill.json, or specify a skill to install.")
 		}
 
-		const [errors, result] = await install_from_manifest(manifest, options)
+		const [errors, result] = await install_from_manifest(manifest, base_options)
 		if (errors) throw e('Install from manifest failed', errors)
 		if (args.flags.json) {
 			print_json({ data: result })
@@ -89,22 +78,62 @@ const run = (args) => catch_errors('Install failed', async () => {
 		return
 	}
 
-	if (!skill.includes('/')) {
-		throw new UsageError('Skill must be in owner/name format (e.g., acme/deploy-aws).')
+	// Parse each argument: extract skill name and optional inline @version
+	const parsed = skills_raw.map(raw => {
+		let skill = raw, version = undefined
+		if (skill.includes('@')) {
+			const at_idx = skill.lastIndexOf('@')
+			version = skill.slice(at_idx + 1)
+			skill = skill.slice(0, at_idx)
+		}
+		return { skill, version }
+	})
+
+	for (const { skill } of parsed) {
+		if (!skill.includes('/')) {
+			throw new UsageError(`Skill must be in owner/name format (e.g., acme/deploy-aws). Got: ${skill}`)
+		}
 	}
 
-	const [errors, result] = await install(skill, options)
-	if (errors) throw e(`Install ${skill} failed`, errors)
+	// --version flag only makes sense for a single skill
+	const flag_version = args.flags.version || undefined
+	if (flag_version && parsed.length > 1) {
+		throw new UsageError('--version flag cannot be used with multiple skills. Use inline @version syntax instead (e.g., acme/foo@1.2.0 acme/bar@2.0.0).')
+	}
+
+	const results = []
+	const failures = []
+	for (const { skill, version: inline_version } of parsed) {
+		const version = flag_version || inline_version
+		const [errors, result] = await install(skill, { ...base_options, version })
+		if (errors) {
+			const msg = errors[0]?.message || errors.message || String(errors)
+			print_warn(`Failed to install ${skill}: ${msg}`)
+			failures.push({ skill, error: msg })
+		} else {
+			results.push({ skill, result })
+		}
+	}
+
+	if (results.length === 0 && failures.length > 0) {
+		throw new Error(`All ${failures.length} install(s) failed.`)
+	}
 
 	if (args.flags.json) {
-		print_json({ data: {
+		const items = results.map(({ skill, result }) => ({
 			skill,
 			version: result.version,
 			installed: result.installed || [],
 			skipped: result.skipped || [],
 			warnings: result.warnings || [],
 			forced: result.forced || []
-		} })
+		}))
+		const data = results.length === 1 && failures.length === 0 ? items[0] : items
+		if (failures.length > 0) {
+			print_json({ data, errors: failures })
+		} else {
+			print_json({ data })
+		}
 		return
 	}
 

package/src/commands/search.js

@@ -10,6 +10,9 @@ const HELP_TEXT = `Usage: happyskills search [query] [options]
 
 Search the skill registry.
 
+When a query is provided, smart search (semantic + quality ranking) is used by
+default. Use --exact to fall back to keyword-only matching.
+
 Arguments:
   query               Search term (optional with --mine, --personal, or --workspace)
 
@@ -19,21 +22,22 @@ Options:
   --personal              Search only your personal workspace
   --tags <tags>           Filter by tags (comma-separated)
   --type <type>           Filter by type (skill, kit)
-  --smart, -S             Use semantic search (vector + text + quality ranking)
-  --limit <n>             Max results (default: 10, max: 50) — used with --smart
-  --min-quality <n>       Minimum quality score 0-100 — used with --smart
+  --exact                 Use keyword-only matching instead of smart search
+  --limit <n>             Max results (default: 10, max: 50)
+  --min-quality <n>       Minimum quality score 0-100
   --json                  Output as JSON
 
 Aliases: s
 
 Examples:
   happyskills search deploy
+  happyskills search "REST API with Node.js"
   happyskills search --mine
-  happyskills search "REST API with Node.js" --smart
   happyskills search deploy --workspace acme
   happyskills search --type kit
   happyskills s --personal --json
-  happyskills search "deploy to AWS" -S --limit 5`
+  happyskills search "deploy to AWS" --limit 5
+  happyskills search deploy --exact`
 
 const QUALITY_TIERS = [
 	{ min: 80, label: 'High quality', color: cyan },
@@ -140,7 +144,7 @@ const run_smart_search = (args, query, options) => catch_errors('Smart search fa
 	console.log(`\n${gray(`Showing ${items.length} result${items.length === 1 ? '' : 's'}. Install with: happyskills install <owner>/<name>`)}\n`)
 })
 
-const run_keyword_search = (args, query, options) => catch_errors('Keyword search failed', async () => {
+const run_keyword_search = (args, query, options, { is_exact } = {}) => catch_errors('Keyword search failed', async () => {
 	const [errors, results] = await repos_api.search(query, options)
 	if (errors) throw e('Search failed', errors)
 
@@ -149,7 +153,9 @@ const run_keyword_search = (args, query, options) => catch_errors('Keyword searc
 
 	if (items.length === 0) {
 		if (args.flags.json) {
-			print_json({ data: { query, scope: effective_scope, results: [], count: 0 } })
+			const data = { query, scope: effective_scope, results: [], count: 0 }
+			if (is_exact) data.hint = 'Smart search (default) uses semantic matching for better results. Remove --exact to use it.'
+			print_json({ data })
 			return
 		}
 		const context = query ? ` for "${query}"` : ''
@@ -165,7 +171,9 @@ const run_keyword_search = (args, query, options) => catch_errors('Keyword searc
 			version: item.latest_version || item.version || '-',
 			visibility: item.visibility || 'public'
 		}))
-		print_json({ data: { query, scope: effective_scope, results: mapped, count: mapped.length } })
+		const data = { query, scope: effective_scope, results: mapped, count: mapped.length }
+		if (is_exact) data.hint = 'Smart search (default) uses semantic matching for better results. Remove --exact to use it.'
+		print_json({ data })
 		return
 	}
 
@@ -191,13 +199,11 @@ const run = (args) => catch_errors('Search failed', async () => {
 
 	const query = args._.join(' ') || null
 	const { mine, personal, workspace, tags, type } = args.flags
-	const is_smart = !!(args.flags.smart || args.flags.S)
+	const is_exact = !!args.flags.exact
+	// --smart / -S accepted for backward compat (now the default when a query is provided)
+	const use_smart = query && !is_exact
 	const has_scope_flag = mine || personal || workspace
 
-	if (is_smart && !query) {
-		throw new UsageError('--smart requires a search query.')
-	}
-
 	if (!query && !has_scope_flag && !tags && !type) {
 		throw new UsageError('Please provide a search query or use --mine, --personal, or --workspace.')
 	}
@@ -221,7 +227,7 @@ const run = (args) => catch_errors('Search failed', async () => {
 	if (tags) options.tags = tags
 	if (type) options.type = type
 
-	if (is_smart) {
+	if (use_smart) {
 		const [errors] = await run_smart_search(args, query, options)
 		if (errors) throw e('Smart search failed', errors)
 	} else {
@@ -231,7 +237,7 @@ const run = (args) => catch_errors('Search failed', async () => {
 			kw_options.workspace = options.workspace_slug
 			delete kw_options.workspace_slug
 		}
-		const [errors] = await run_keyword_search(args, query, kw_options)
+		const [errors] = await run_keyword_search(args, query, kw_options, { is_exact })
 		if (errors) throw e('Search failed', errors)
 	}
 }).then(([errors]) => { if (errors) { exit_with_error(errors); return } })

package/src/commands/uninstall.js

@@ -1,16 +1,16 @@
 const { error: { catch_errors, wrap_errors: e } } = require('puffy-core')
 const { uninstall } = require('../engine/uninstaller')
-const { print_help, print_json } = require('../ui/output')
+const { print_help, print_json, print_warn } = require('../ui/output')
 const { exit_with_error, UsageError } = require('../utils/errors')
 const { find_project_root } = require('../config/paths')
 const { EXIT_CODES } = require('../constants')
 
-const HELP_TEXT = `Usage: happyskills uninstall <owner/skill> [options]
+const HELP_TEXT = `Usage: happyskills uninstall <owner/skill> [...] [options]
 
-Remove a skill and prune orphaned dependencies.
+Remove one or more skills and prune orphaned dependencies.
 
 Arguments:
-  owner/skill       Skill to remove (e.g., acme/deploy-aws)
+  owner/skill       Skill(s) to remove (e.g., acme/deploy-aws teamb/logging)
 
 Options:
   -g, --global        Remove from global scope
@@ -23,6 +23,7 @@ Aliases: rm, remove
 
 Examples:
   happyskills uninstall acme/deploy-aws
+  happyskills uninstall acme/deploy-aws acme/monitor acme/logging
   happyskills rm acme/deploy-aws -g`
 
 const run = (args) => catch_errors('Uninstall failed', async () => {
@@ -31,13 +32,15 @@ const run = (args) => catch_errors('Uninstall failed', async () => {
 		return process.exit(EXIT_CODES.SUCCESS)
 	}
 
-	const skill = args._[0]
-	if (!skill) {
+	const skills_raw = args._
+	if (skills_raw.length === 0) {
 		throw new UsageError('Please specify a skill to uninstall (e.g., happyskills uninstall acme/deploy-aws).')
 	}
 
-	if (!skill.includes('/')) {
-		throw new UsageError('Skill must be in owner/name format (e.g., acme/deploy-aws).')
+	for (const skill of skills_raw) {
+		if (!skill.includes('/')) {
+			throw new UsageError(`Skill must be in owner/name format (e.g., acme/deploy-aws). Got: ${skill}`)
+		}
 	}
 
 	const options = {
@@ -46,15 +49,35 @@ const run = (args) => catch_errors('Uninstall failed', async () => {
 		project_root: find_project_root()
 	}
 
-	const [errors, result] = await uninstall(skill, options)
-	if (errors) throw e(`Uninstall ${skill} failed`, errors)
+	const results = []
+	const failures = []
+	for (const skill of skills_raw) {
+		const [errors, result] = await uninstall(skill, options)
+		if (errors) {
+			const msg = errors[0]?.message || errors.message || String(errors)
+			print_warn(`${skill}: ${msg}`)
+			failures.push({ skill, error: msg })
+		} else {
+			results.push({ skill, result })
+		}
+	}
+
+	if (results.length === 0 && failures.length > 0) {
+		throw new Error(`All ${failures.length} uninstall(s) failed.`)
+	}
 
 	if (args.flags.json) {
-		print_json({ data: {
+		const items = results.map(({ skill, result }) => ({
 			skill,
 			removed: result.removed || [],
 			orphans_pruned: result.orphans_pruned || []
-		} })
+		}))
+		const data = results.length === 1 && failures.length === 0 ? items[0] : items
+		if (failures.length > 0) {
+			print_json({ data, errors: failures })
+		} else {
+			print_json({ data })
+		}
 		return
 	}
 }).then(([errors]) => { if (errors) { exit_with_error(errors); return } })