happyskills 0.3.0 → 0.4.0

package/CHANGELOG.md

@@ -7,6 +7,19 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
+## [0.4.0] - 2026-03-05
+
+### Added
+- Add `-g` / `--global` flag to `setup` command to opt into installing `happyskillsai/happyskills-cli` globally (`~/.claude/skills/`)
+
+### Changed
+- Change `setup` default install scope from global to project-level (`.claude/skills/`); pass `-g` to restore the previous global behaviour
+
+## [0.3.1] - 2026-03-04
+
+### Fixed
+- Fix global installs writing `skills-lock.json` to the local project directory instead of `~/.claude/`; global lock state is now read/written from `~/.claude/skills-lock.json` across `install`, `uninstall`, `list`, `update`, and `convert` commands
+
 ## [0.3.0] - 2026-03-04
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "happyskills",
-	"version": "0.3.0",
+	"version": "0.4.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/convert.js

@@ -12,7 +12,7 @@ const { write_manifest } = require('../manifest/writer')
 const { read_lock } = require('../lock/reader')
 const { write_lock, update_lock_skills } = require('../lock/writer')
 const { hash_directory } = require('../lock/integrity')
-const { skills_dir, find_project_root } = require('../config/paths')
+const { skills_dir, find_project_root, lock_root } = require('../config/paths')
 const { file_exists } = require('../utils/fs')
 const { create_spinner } = require('../ui/spinner')
 const { print_help, print_success, print_error, print_info, print_label, print_json } = require('../ui/output')
@@ -154,7 +154,8 @@ const run = (args) => catch_errors('Convert failed', async () => {
 	if (push_err) { pub_spinner.fail('Publish failed'); throw e('Push failed', push_err) }
 
 	pub_spinner.update('Updating lock file...')
-	const [, lock_data] = await read_lock(project_root)
+	const lock_dir = lock_root(is_global, project_root)
+	const [, lock_data] = await read_lock(lock_dir)
 	const [, integrity] = await hash_directory(skill_dir)
 
 	const full_name = `${workspace.slug}/${skill_name}`
@@ -170,7 +171,7 @@ const run = (args) => catch_errors('Convert failed', async () => {
 	}
 
 	const new_skills = update_lock_skills(lock_data, updates)
-	const [lock_err] = await write_lock(project_root, new_skills)
+	const [lock_err] = await write_lock(lock_dir, new_skills)
 	if (lock_err) { pub_spinner.fail('Failed to write lock file'); throw e('Lock write failed', lock_err) }
 
 	pub_spinner.succeed(`Converted ${full_name}@${version}`)

package/src/commands/list.js

@@ -1,6 +1,6 @@
 const { error: { catch_errors, wrap_errors: e } } = require('puffy-core')
 const { read_lock, get_all_locked_skills } = require('../lock/reader')
-const { skills_dir, skill_install_dir, find_project_root } = require('../config/paths')
+const { skills_dir, skill_install_dir, find_project_root, lock_root } = require('../config/paths')
 const { file_exists } = require('../utils/fs')
 const { scan_skills_dir } = require('../utils/skill_scanner')
 const { print_help, print_table, print_json, print_info } = require('../ui/output')
@@ -32,7 +32,7 @@ const run = (args) => catch_errors('List failed', async () => {
 	const project_root = find_project_root()
 	const base_dir = skills_dir(is_global, project_root)
 
-	const [, lock_data] = await read_lock(project_root)
+	const [, lock_data] = await read_lock(lock_root(is_global, project_root))
 	const skills = get_all_locked_skills(lock_data)
 	const managed_entries = Object.entries(skills)
 

package/src/commands/setup.js

@@ -7,18 +7,20 @@ const { EXIT_CODES } = require('../constants')
 
 const SKILL_NAME = 'happyskillsai/happyskills-cli'
 
-const HELP_TEXT = `Usage: happyskills setup
+const HELP_TEXT = `Usage: happyskills setup [options]
 
-Install (or update) the official HappySkills CLI skill globally.
+Install (or update) the official HappySkills CLI skill.
 
-Installs happyskillsai/happyskills-cli into ~/.claude/skills/ so AI agents
+Installs happyskillsai/happyskills-cli into .claude/skills/ so AI agents
 (Claude Code, etc.) can interact with HappySkills using natural language.
 
 Options:
+  -g, --global  Install globally (~/.claude/skills/) instead of project-level
   --json        Output as JSON
 
 Examples:
-  happyskills setup`
+  happyskills setup
+  happyskills setup -g`
 
 const run = (args) => catch_errors('Setup failed', async () => {
 	if (args.flags._show_help) {
@@ -27,7 +29,7 @@ const run = (args) => catch_errors('Setup failed', async () => {
 	}
 
 	const options = {
-		global: true,
+		global: args.flags.global || false,
 		yes: true,
 		version: 'latest',
 		project_root: find_project_root()

package/src/commands/update.js

@@ -3,7 +3,7 @@ const { install } = require('../engine/installer')
 const { read_lock, get_all_locked_skills } = require('../lock/reader')
 const { print_help, print_success, print_info, print_json } = require('../ui/output')
 const { exit_with_error, UsageError } = require('../utils/errors')
-const { find_project_root } = require('../config/paths')
+const { find_project_root, lock_root } = require('../config/paths')
 const { EXIT_CODES } = require('../constants')
 
 const HELP_TEXT = `Usage: happyskills update [owner/skill|--all] [options]
@@ -40,7 +40,8 @@ const run = (args) => catch_errors('Update failed', async () => {
 		throw new UsageError("Specify a skill to update or use --all (e.g., 'happyskills update acme/deploy-aws' or 'happyskills update --all').")
 	}
 
-	const [, lock_data] = await read_lock(project_root)
+	const is_global = args.flags.global || false
+	const [, lock_data] = await read_lock(lock_root(is_global, project_root))
 	const skills = get_all_locked_skills(lock_data)
 
 	const to_update = target_skill
@@ -57,7 +58,7 @@ const run = (args) => catch_errors('Update failed', async () => {
 	}
 
 	const options = {
-		global: args.flags.global || false,
+		global: is_global,
 		fresh: true,
 		project_root
 	}

package/src/config/paths.js

@@ -26,6 +26,10 @@ const tmp_dir = (base_skills_dir) => path.join(base_skills_dir, '.tmp')
 
 const install_lock_path = (base_skills_dir) => path.join(base_skills_dir, '.install.lock')
 
+const lock_root = (is_global, project_root) => {
+	return is_global ? path.join(home_dir, '.claude') : project_root
+}
+
 const lock_file_path = (project_root = process.cwd()) => path.join(project_root, 'skills-lock.json')
 
 const skill_install_dir = (base_skills_dir, name) => path.join(base_skills_dir, name)
@@ -60,6 +64,7 @@ module.exports = {
 	skills_dir,
 	tmp_dir,
 	install_lock_path,
+	lock_root,
 	lock_file_path,
 	skill_install_dir,
 	find_project_root

package/src/engine/installer.js

@@ -8,7 +8,7 @@ const { check_system_dependencies } = require('./system_deps')
 const { hash_directory, verify_integrity } = require('../lock/integrity')
 const { read_lock, get_locked_skill } = require('../lock/reader')
 const { write_lock, update_lock_skills } = require('../lock/writer')
-const { skills_dir, tmp_dir, skill_install_dir } = require('../config/paths')
+const { skills_dir, tmp_dir, skill_install_dir, lock_root } = require('../config/paths')
 const { ensure_dir, remove_dir, file_exists } = require('../utils/fs')
 const { create_spinner } = require('../ui/spinner')
 const { print_success, print_warn } = require('../ui/output')
@@ -22,8 +22,9 @@ const install = (skill, options = {}) => catch_errors('Install failed', async ()
 	const { version, global: is_global = false, force = false, fresh = false, project_root } = options
 	const base_dir = skills_dir(is_global, project_root)
 	const temp_dir = tmp_dir(base_dir)
+	const lock_dir = lock_root(is_global, project_root)
 
-	const [, lock_data] = fresh ? [null, null] : await read_lock(project_root)
+	const [, lock_data] = fresh ? [null, null] : await read_lock(lock_dir)
 
 	if (!fresh && lock_data) {
 		const locked = get_locked_skill(lock_data, skill)
@@ -148,7 +149,7 @@ const install = (skill, options = {}) => catch_errors('Install failed', async ()
 		}
 
 		const new_skills = update_lock_skills(lock_data, updates)
-		const [lock_errors] = await write_lock(project_root, new_skills)
+		const [lock_errors] = await write_lock(lock_dir, new_skills)
 		if (lock_errors) { spinner.fail('Failed to write lock file'); throw e('Lock write failed', lock_errors) }
 
 		spinner.succeed(`Installed ${packages_to_install.length} package(s)`)

package/src/engine/uninstaller.js

@@ -1,7 +1,7 @@
 const { error: { catch_errors, wrap_errors: e } } = require('puffy-core')
 const { read_lock, get_locked_skill, get_all_locked_skills } = require('../lock/reader')
 const { write_lock, update_lock_skills } = require('../lock/writer')
-const { skills_dir, skill_install_dir } = require('../config/paths')
+const { skills_dir, skill_install_dir, lock_root } = require('../config/paths')
 const { remove_dir } = require('../utils/fs')
 const { print_success, print_info } = require('../ui/output')
 
@@ -24,8 +24,9 @@ const find_orphans = (skills, removed_skill) => {
 const uninstall = (skill, options = {}) => catch_errors('Uninstall failed', async () => {
 	const { global: is_global = false, project_root } = options
 	const base_dir = skills_dir(is_global, project_root)
+	const lock_dir = lock_root(is_global, project_root)
 
-	const [lock_errors, lock_data] = await read_lock(project_root)
+	const [lock_errors, lock_data] = await read_lock(lock_dir)
 	if (lock_errors || !lock_data) {
 		throw new Error('No skills-lock.json found. Nothing to uninstall.')
 	}
@@ -58,7 +59,7 @@ const uninstall = (skill, options = {}) => catch_errors('Uninstall failed', asyn
 	}
 
 	const new_skills = update_lock_skills(lock_data, updates)
-	const [write_errors] = await write_lock(project_root, new_skills)
+	const [write_errors] = await write_lock(lock_dir, new_skills)
 	if (write_errors) throw e('Failed to update lock file', write_errors)
 
 	print_success(`Removed ${skill}`)