Skip to content

v0.3.0

Choose a tag to compare

@github-actions github-actions released this 05 Oct 07:11
· 12 commits to main since this release
v0.3.0
41e1640

What's changed

skillctrl now keeps acquisition, direct editing, and deliberate hash recording separate. Use the same basic commands locally and in automation:

skillctrl update chosen-skill
# Inspect the diff and saved intent, edit the skill, and verify it.
skillctrl record chosen-skill
skillctrl check
  • Familiar find, add, list, update, and remove commands, with search, install, ls, and rm aliases. Acquisition defaults to the pinned skills executable; --adapter accepts only skills, gh, or git.
  • Add and merge share positional owner/repo:skill inputs. Single-input add supports --name; merge creates routing to complete originals under references/<upstream-skill-name>/.
  • Native registrations remain compatible with root skills-lock.json. Aliases, merged inputs, and supplementary provenance live in .agents/skillctrl/upstreams.json. Independent native changes/removal invalidate stale supplementary metadata.
  • The distributed skillctrl skill is itself managed as a merged skill, with saved integration intent and a verified whole-directory hash. Self-contained AI setup is in docs/start.md; maintained Japanese documentation is in docs/ja/.

Migration from v0.2.x

This minor release changes command behavior in the pre-1.0 CLI.

  • add, merge, and update only acquire/register originals. They do not invoke AI or advance accepted hashes. Edit skill and intent files directly, verify, then run record NAME.

  • Only skills with both upstream registration and saved intent enter accepted hashes. record with no names only prunes ineligible hashes and accepts no content.

  • check reports local drift offline and exits successfully when differences are found. It never fetches upstreams or judges intent. For a Bash CI gate:

    set -euo pipefail
    skillctrl check | jq -e '.local.lock_changed == false'
  • ci, schedule, intent, status, plan, prompt, and schema are removed. A scheduler calls update; the existing agent reviews/edits/verifies; Git/GitHub CLI publishes through a PR. The CLI never starts AI, creates worktrees, commits, pushes, or opens a PR.

  • Operate in the current repository; use cd to select another repository. --repo, --worktree-provider, and --from are removed.

  • Legacy registrations remain readable. Recognized skillctrl metadata moves out of the native lock only after a successful import; read-only commands and dry runs do not migrate files. Existing numeric merged layouts update in place; explicit re-merge creates the named reference layout.

  • Install the skill separately from the CLI using skillctrl add wwwyo/skillctrl:skillctrl. Follow your repository's exact pinning and release cooldown policy for acquisition tools.

See command details and automation.

Distribution

Archives and SHA-256 checksums cover macOS/Linux on amd64 and arm64. The release includes the generated Homebrew formula. CLI installation is available through the mise GitHub backend, wwwyo/tap/skillctrl, and go install github.com/wwwyo/skillctrl@v0.3.0.