2.0.0
Highlights
Agent Skills 2.0 makes bundle version changes explicit and scopes default skill installations by catalog. Product-owned catalogs can coexist under a host's skill root, while existing managed flat installations continue to be detected and updated in place.
Added
- Added
--skill-bundle-versiontoagent-skills buildandskill-bundle-versionto the sync Action for selecting an exact current or next bundle version. - Added catalog-scoped default installation directories for OpenAI / Codex and GitHub Copilot CLI.
- Added target selection across host-declared current and compatible locations, including structured failures for duplicate catalog installations, cross-catalog skill-name collisions, and unsafe paths.
Changed
- Breaking: Public bundle and manifest APIs now expose
SkillBundleVersioninstead ofint. - Breaking: Installation operations now require a catalog ID so install, update, uninstall, prune, and doctor resolve the same catalog-owned target.
- Changed normal bundle builds to preserve the version authored in
bundle.json. Content changes no longer advance the bundle version implicitly. - Changed new default installations to use a catalog subdirectory. Existing managed flat installations are reused without creating a duplicate installation.
Fixed
- Fixed first-time explicit-version publication when no generated bundle exists.
- Fixed publication failure and cancellation handling so generated output is restored or removed atomically.
Migration
- Update
MackySoft.AgentSkills,MackySoft.AgentSkills.Hosting,MackySoft.AgentSkills.ConsoleAppFramework, andMackySoft.AgentSkills.Clitogether to2.0.0. - Replace public integer bundle-version usage with
SkillBundleVersion. - Supply the catalog ID when invoking installation and doctor services.
- Update Action references to
mackysoft/agent-skills/actions/verify@2.0.0andmackysoft/agent-skills/actions/sync@2.0.0. Passskill-bundle-versiononly when intentionally advancing or reconciling to an exact version. - Existing managed flat installations require no manual move. New default installations are created under the catalog-scoped location.
Included changes
- Added explicit bundle version targeting. (#62)
- Made first-time bundle publication transactional. (#63)
- Added catalog-scoped installation target selection. (#64)
Full Changelog: 1.0.0...2.0.0