Skip to content

2.0.0

Choose a tag to compare

@github-actions github-actions released this 18 Jul 11:10
· 48 commits to master since this release
b12bf2e

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-version to agent-skills build and skill-bundle-version to 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 SkillBundleVersion instead of int.
  • 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

  1. Update MackySoft.AgentSkills, MackySoft.AgentSkills.Hosting, MackySoft.AgentSkills.ConsoleAppFramework, and MackySoft.AgentSkills.Cli together to 2.0.0.
  2. Replace public integer bundle-version usage with SkillBundleVersion.
  3. Supply the catalog ID when invoking installation and doctor services.
  4. Update Action references to mackysoft/agent-skills/actions/verify@2.0.0 and mackysoft/agent-skills/actions/sync@2.0.0. Pass skill-bundle-version only when intentionally advancing or reconciling to an exact version.
  5. 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