Skip to content

Switch the skills CLI to versioned repositories - #23

Closed
git-hulk wants to merge 1 commit into
skills-transactional-reconcilefrom
skills-versioned-manifest-cli
Closed

Switch the skills CLI to versioned repositories#23
git-hulk wants to merge 1 commit into
skills-transactional-reconcilefrom
skills-versioned-manifest-cli

Conversation

@git-hulk

@git-hulk git-hulk commented Aug 31, 2026

Copy link
Copy Markdown
Owner

Rewire every skills command onto the versioned manifest and
transactional Reconcile, and delete the legacy mutable-checkout
implementation (clone/pull sources, per-skill overwrite installs, and
the legacy manifest).

  • skills install [@Version] resolves the version (latest when
    omitted), opens a multi-select over the catalog at that locked
    version, and reconciles; --force re-offers installed skills for
    reinstall. Local directory paths are rejected with an explicit
    unsupported-source error instead of writing an unreproducible
    manifest entry.

  • skills update [[@Version]] updates one repository, or every
    repository to latest, preserving selected skills; an update whose
    catalog lost a selected skill fails without changing anything.

  • skills sync applies only the locked versions and never rewrites a
    hand-edited manifest; with all snapshots cached it needs no
    network. skills purge removes unreferenced cache entries, and
    skills uninstall drops a repository together with its final skill.

  • skills list shows repositories, locked versions, selected skills,
    and per-target install state without network access.

  • Plugin-provided skills install at resolved, locked versions
    through the same reconcile path.

CLI output and errors use the credential-free canonical repository
rather than the original transport URL.

🤖 Generated with Claude Code

@git-hulk
git-hulk force-pushed the skills-versioned-manifest-cli branch from ce03aa9 to 1de60ef Compare August 31, 2026 13:50
@git-hulk
git-hulk changed the base branch from skills-snapshot-cache to skills-transactional-reconcile August 31, 2026 13:51
@git-hulk git-hulk changed the title Lock skills to repository versions with transactional apply Switch the skills CLI to versioned repositories Aug 31, 2026
Rewire every skills command onto the versioned manifest and
transactional Reconcile, and delete the legacy mutable-checkout
implementation (clone/pull sources, per-skill overwrite installs, and
the legacy manifest).

  - skills install <repo>[@Version] resolves the version (latest when
    omitted), opens a multi-select over the catalog at that locked
    version, and reconciles; --force re-offers installed skills for
    reinstall. Local directory paths are rejected with an explicit
    unsupported-source error instead of writing an unreproducible
    manifest entry.

  - skills update [<repo>[@Version]] updates one repository, or every
    repository to latest, preserving selected skills; an update whose
    catalog lost a selected skill fails without changing anything.

  - skills sync applies only the locked versions and never rewrites a
    hand-edited manifest; with all snapshots cached it needs no
    network. skills purge removes unreferenced cache entries, and
    skills uninstall drops a repository together with its final skill.

  - skills list shows repositories, locked versions, selected skills,
    and per-target install state without network access.

  - Plugin-provided skills install at resolved, locked versions
    through the same reconcile path.

CLI output and errors use the credential-free canonical repository
rather than the original transport URL.

Assistant By Fable 5
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@git-hulk
git-hulk force-pushed the skills-versioned-manifest-cli branch from 1de60ef to 247ab7f Compare September 1, 2026 02:18
@git-hulk git-hulk closed this Sep 1, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant