happyskills 0.5.0 → 0.6.0

package/CHANGELOG.md

@@ -7,6 +7,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
+## [0.6.0] - 2026-03-06
+
+### Added
+- Add `--public` flag to `publish` command to explicitly publish a skill as publicly discoverable in the catalog
+
+### Changed
+- Change `publish` default visibility from public to private — skills are now private by default; pass `--public` to make a skill visible in the catalog
+- Change `convert` to no longer auto-publish to the registry after converting; the skill is registered locally and the user is prompted to run `happyskills publish <skill-name>` as a separate step
+
+### Fixed
+- Fix `--version` flag collision where commands accepting `--version <value>` (e.g., `convert --version 1.0.0`) would incorrectly trigger the root `--version` output instead of passing the value to the command
+
 ## [0.5.0] - 2026-03-05
 
 ### Added

package/package.json

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

package/src/api/push.js

@@ -12,13 +12,13 @@ const estimate_payload_size = (files) => {
 	return size
 }
 
-const smart_push = (owner, repo, { version, message, files }, on_progress) =>
+const smart_push = (owner, repo, { version, message, files, visibility }, on_progress) =>
 	catch_errors('Smart push failed', async () => {
 		const payload_size = estimate_payload_size(files)
 
 		if (payload_size < DIRECT_PUSH_THRESHOLD) {
 			// Small payload — use direct push
-			const [err, data] = await repos_api.push(owner, repo, { version, message, files })
+			const [err, data] = await repos_api.push(owner, repo, { version, message, files, visibility })
 			if (err) throw e('Direct push failed', err)
 			return data
 		}
@@ -28,7 +28,7 @@ const smart_push = (owner, repo, { version, message, files }, on_progress) =>
 
 		// Step 1: Initiate
 		const [init_err, init_data] = await initiate_upload(owner, repo, {
-			version, message, files: file_meta
+			version, message, files: file_meta, visibility
 		})
 		if (init_err) throw e('Upload initiation failed', init_err)
 

package/src/commands/convert.js

@@ -5,9 +5,7 @@ const { error: { catch_errors, wrap_errors: e } } = require('puffy-core')
 const { require_token } = require('../auth/token_store')
 const repos_api = require('../api/repos')
 const workspaces_api = require('../api/workspaces')
-const { smart_push } = require('../api/push')
 const { parse_frontmatter } = require('../utils/skill_scanner')
-const { collect_files } = require('../utils/file_collector')
 const { write_manifest } = require('../manifest/writer')
 const { read_lock } = require('../lock/reader')
 const { write_lock, update_lock_skills } = require('../lock/writer')
@@ -125,7 +123,7 @@ const run = (args) => catch_errors('Convert failed', async () => {
 		console.error(`  Description: ${description || '(none)'}`)
 		console.error(`  Keywords:    ${keywords.length ? keywords.join(', ') : '(none)'}`)
 		console.error('')
-		const answer = await confirm('Publish this skill to the registry? [y/N] ')
+		const answer = await confirm('Convert this skill to a managed package? [y/N] ')
 		if (answer !== 'y' && answer !== 'yes') {
 			print_info('Aborted.')
 			return process.exit(EXIT_CODES.SUCCESS)
@@ -138,21 +136,6 @@ const run = (args) => catch_errors('Convert failed', async () => {
 	const [manifest_err] = await write_manifest(skill_dir, manifest)
 	if (manifest_err) { pub_spinner.fail('Failed to write skill.json'); throw e('Failed to write skill.json', manifest_err) }
 
-	pub_spinner.update('Packaging skill...')
-	const [collect_err, skill_files] = await collect_files(skill_dir)
-	if (collect_err) { pub_spinner.fail('Failed to collect files'); throw e('File collection failed', collect_err) }
-
-	pub_spinner.update(`Publishing ${workspace.slug}/${skill_name}@${version}...`)
-	const on_progress = (completed, total) => {
-		pub_spinner.update(`Uploading files (${completed}/${total})...`)
-	}
-	const [push_err, push_data] = await smart_push(workspace.slug, skill_name, {
-		version,
-		message: `Release ${version}`,
-		files: skill_files
-	}, on_progress)
-	if (push_err) { pub_spinner.fail('Publish failed'); throw e('Push failed', push_err) }
-
 	pub_spinner.update('Updating lock file...')
 	const lock_dir = lock_root(is_global, project_root)
 	const [, lock_data] = await read_lock(lock_dir)
@@ -162,8 +145,8 @@ const run = (args) => catch_errors('Convert failed', async () => {
 	const updates = {
 		[full_name]: {
 			version,
-			ref: push_data?.ref || `refs/tags/v${version}`,
-			commit: push_data?.commit || null,
+			ref: null,
+			commit: null,
 			integrity: integrity || null,
 			requested_by: ['__root__'],
 			dependencies: {}
@@ -185,6 +168,9 @@ const run = (args) => catch_errors('Convert failed', async () => {
 		} })
 		return
 	}
+
+	console.error('')
+	print_info(`Next step: enrich metadata, then run \`happyskills publish ${skill_name}\` to publish.`)
 }).then(([errors]) => { if (errors) { exit_with_error(errors); return } })
 
 module.exports = { run }

package/src/commands/publish.js

@@ -24,6 +24,7 @@ Arguments:
 Options:
   --bump <type>          Auto-bump version before publishing (patch, minor, major)
   --workspace <slug>     Target workspace (overrides lock file owner)
+  --public               Publish as public (default is private)
 
 Aliases: pub
 
@@ -120,10 +121,12 @@ const run = (args) => catch_errors('Publish failed', async () => {
 	const on_progress = (completed, total) => {
 		spinner.update(`Uploading files (${completed}/${total})...`)
 	}
+	const visibility = args.flags.public ? 'public' : 'private'
 	const [push_err] = await smart_push(workspace.slug, manifest.name, {
 		version: manifest.version,
 		message: `Release ${manifest.version}`,
-		files: skill_files
+		files: skill_files,
+		visibility
 	}, on_progress)
 	if (push_err) { spinner.fail('Publish failed'); throw e('Push failed', push_err) }
 

package/src/index.js

@@ -115,7 +115,7 @@ const run = (argv) => {
 		set_json_mode()
 	}
 
-	if (args.flags.version) {
+	if (args.flags.version === true) {
 		show_version()
 		return process.exit(EXIT_CODES.SUCCESS)
 	}