Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Changelog

All notable changes to this project are documented here. The format is based on Keep a Changelog, and this project adheres to Semantic Versioning. Releases from this point forward are managed by release-please based on Conventional Commits.

1.4.0 (2026-09-01)

Features

  • one [[agent_skills]] stanza names many skills from one source (#79) (cfe7d88)
  • scan –mcp and migrate project MCP servers (#76) (11f72be)

Bug Fixes

  • doctor walks harness skill roots (#74) (a7d624b)
  • drop [[skills]] row on plugin remove and purge (#72) (31dc6ef)
  • name marketplaces from the manifest, not the repo basename (#78) (58a920d)
  • plan npm agent-skill rows so sync dry-run matches apply (#75) (5fe0b5f)
  • show source kind on every list Agent Skill line (#73) (99f6182)

Documentation

  • record Pi skill listing and upstream wiki-manager description limit (#70) (2a82ed8)

1.3.0 (2026-08-30)

Features

  • copy Agent Skills from a marketplace clone via marketplace and path (d9c065e)
  • doctor warns when hub wiki-manager is Claude-flavored for Pi or Grok (8baa6d8)
  • hint Agent Skill trees under plugins/*/skills after marketplace add (41e83c7)
  • select an Agent Skill tree with path inside a source clone (c48f505)
  • skill install –path for non-conventional Agent Skill roots (b743ac8)

Bug Fixes

  • declare marketplace source in skills.toml so sync can clone on a fresh machine (675ad99)
  • doctor: guard the shipped SKILL.md against verbs removed in 1.0 (#52) (10528b8)
  • print plugins and next install command after marketplace add (#56) (2906957)

Documentation

  • declare llm-wiki plugin and OpenCode Agent Skills for Claude, Pi, and Grok (ed4197f)
  • update command surface and harness rules for 1.2.0 (#48) (470abd2)

1.2.0 (2026-08-25)

Features

  • register the Agent Skill hub in Pi settings (#45) (b99398a)
  • symlink hub skills into per-harness roots (#46) (e92139e)

1.1.0 (2026-08-24)

Features

  • name which harnesses can see a plugin or Agent Skill (#35) (daad031), closes #34

1.0.0 (2026-08-24)

⚠ BREAKING CHANGES

  • typed plugin, skill, and mcp command groups (#32)

Features

  • typed plugin, skill, and mcp command groups (#32) (5562c42)

0.9.0 (2026-08-22)

Features

  • pin a marketplace so update and upgrade cannot float it (#28) (b604aca)

Bug Fixes

  • discover Agent Skills under .agents/skills/, not only skills/ (#31) (37334fb)
  • stop reporting owned skills as unmanaged, and stop faking inventory (#30) (bfdf5ca)

0.8.0 (2026-08-20)

Features

  • install from repo + cross-client skill path + sync –adopt (#21) (64274b2)
  • sparse Agent Skill installs from git repos + install –skill flag (#24) (9623646)
  • zskills install <owner/repo> — direct install from a git repo (#18) (2756dc0)

Bug Fixes

  • sparse installs work on marketplace repos and nested skill layouts (#25) (7dcd9a5)

Documentation

  • adopt the house PR standard — template, STE100 card, labels (#27) (80a6b59)
  • ship Agent Skill + MCP-aware docs for v0.7.0 (#16) (66ad32f)
  • theme: terminal aesthetic + readability tune + ← zot24.com link (#23) (a34aeae)
  • update for ~/.agents/skills/ path + sync –adopt + quieter npm (#22) (38a5c58)

0.7.0 (2026-05-16)

Features

  • [[mcps]] manifest support + sync reconciliation (#13) (882bfe5)
  • add -i interactive mode to install, search, remove (#8) (33ae160)
  • doctor statically validates MCP servers (#11) (8295670)
  • prefer fzf for interactive pickers, fall back to dialoguer (#9) (1e13340)
  • zskills list –paths shows on-disk location for each entry (#15) (d1dcc04)
  • zskills list aggregates MCP servers across all scopes (#10) (b13ca45)

Documentation

  • reposition as multi-runtime, not Claude-only (#12) (b8429ac)
  • site: add OG/Twitter card image for social previews (#6) (631a426)

0.6.0 (2026-05-13)

Features

  • add search command and optional skills.sh driver (#4) (f65573c)

Bug Fixes

  • list: cleaner group header — bare name + arrow source kind (ea68a63)
  • sync: honor npm/claims ownership; skip already-present source entries (be3e187)
  • sync: prevent data loss via safer defaults (b97c721)

Documentation

  • add mdBook static site + GitHub Pages deploy (4a12893)
  • cover v0.5/v0.5.1 features in depth (cd802ef)
  • document v0.6 search command and skills-sh optional feature (#5) (793ec61)
  • site: add CNAME for zskills.zot24.com (a82cf7e)
  • site: mirror .md files + add llms.txt and llms-full.txt (4e0be13)

0.5.0 (2026-05-13)

Features

  • tarball update for non-git marketplaces (db6e370)
  • v0.5 — upgrade command, npm sources, grouped list (fb37468)

Bug Fixes

  • claims field + quiet git output + skip non-git marketplaces (b424711)

0.4.0 (2026-05-12)

Features

  • initial v0.1 — package manager for Claude Code skills (c03fcea)
  • v0.2 — Agent Skills support (~/.claude/skills/) (fcd7773)
  • v0.3 — migrate-skill, migrate-all, optional source (d4144d9)

Bug Fixes

  • manifest: use XDG ~/.config across platforms, not platform default (25e9b10)

Documentation

  • release-please + CHANGELOG + docs/ folder (bdb002c)

0.3.0 - 2026-05-12

Features

  • migrate-skill: promote ONE agent skill across every project under a tree. Hashes each project’s copy to detect content divergence, picks the first as canonical, copies to user scope, optionally removes from all projects, appends a [[agent_skills]] entry to the manifest.
  • migrate-all: interactive sweep over a tree. Groups by skill name, sorts by occurrence count, prompts per skill (promote? source? remove from projects?). --threshold N filters; -y/--yes accepts defaults.
  • Optional source on [[agent_skills]] entries. A name-only entry declares a local-only skill: tracked in inventory but not refreshed from a remote by sync.
  • Manifest writes preserve formatting: append uses toml_edit::DocumentMut so existing comments/structure in skills.toml survive round-trip.

Internal

  • Added dialoguer for interactive prompts.
  • 13/13 integration tests passing, including new coverage for migrate-skill.

0.2.0 - 2026-05-12

Features

  • Agent Skills support (raw SKILL.md format under ~/.claude/skills/). New [[agent_skills]] manifest section with source (owner/repo or git URL) and optional name.
  • Source repos cached at $XDG_CACHE_HOME/zskills/agent-skills/<owner>-<repo>/.
  • Own inventory at ~/.claude/skills/.zskills.json (since Claude Code’s installed_plugins.json doesn’t cover Agent Skills).
  • sync applies both [[skills]] and [[agent_skills]] in a single pass.
  • list shows plugins AND agent skills; flags untracked agent skills.
  • doctor detects orphans across all three states (settings, inventory, disk).
  • scan walks .claude/skills/<name>/SKILL.md directories at project scope (default depth bumped 4 → 6).
  • migrate also promotes .claude/skills/ directories to user scope.

0.1.0 - 2026-05-12

Initial release — package manager for Claude Code plugins.

Features

  • Commands: list, install, remove, purge, enable, disable, sync, update, doctor, scan, migrate, marketplace add|remove|list|update.
  • Atomic JSON round-trip preserves all unknown fields in ~/.claude/settings.json (hooks, permissions, env, etc.).
  • Multi-marketplace support with name@marketplace qualification matching Claude Code’s syntax.
  • Declarative skills.toml manifest auto-discovered from CWD or ~/.config/zskills/.
  • Scan + migrate for promoting project-scope skills to user scope.
  • Git shelled out (no libgit2 bundling); rustls TLS; single static binary.
  • 8 integration tests using assert_cmd + tempfile-isolated CLAUDE_HOME.