Repository navigation
docs(skills): add mise/melange/apko tooling skills - #46
Merged
Merged
Conversation
Port the three operator tooling skills from template-go-api, adapted for this repository's toolset, and refresh the agent-facing docs. - .agents/skills/mise: the mise toolchain (tool list taken from mise.toml — go, moon, golangci-lint, kubebuilder, setup-envtest, kubectl, helm, chainsaw, ko, tilt, ctlptl, kind, melange, apko, cosign, with controller-gen on the go: backend and chainsaw via aqua:kyverno/chainsaw), fail-closed lock, moon-on- system, the bump/lock workflow, and the macos-x64/nested-worktree gotchas. - .agents/skills/melange: building the controller-manager apk (./cmd -> manager, no version-var stamping, native per-arch builds, --runner docker locally). - .agents/skills/apko: assembling the minimal multi-arch nonroot image (/usr/bin/manager, uid 65532), apko publish + the registry-resolved index digest, keyless cosign, syft SBOM, and the attest.yml SLSA L3 + Kyverno tie-in. - AGENTS.md / CLAUDE.md: reference the new skills in Local Skills. - DELETE_ME.md: add melange.yaml/apko.yaml and the tooling skills to the downstream-customization checklist; drop the stale Docker-cache-scope / OCI archive / OCI-label notes left over from the Dockerfile build. Each ported skill was adapted from the proven template-go-api originals and adversarially verified against this repo's mise.toml / melange.yaml / apko.yaml. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Final slice of the template-go-api session-015 reproduction (mise → melange/apko
→ SLSA L3 → skills/docs). Ports the three operator tooling skills and
refreshes the agent docs.
.agents/skills/mise— the mise toolchain: tool list grounded inmise.toml(incl.controller-genon thego:backend and chainsaw viaaqua:kyverno/chainsaw), fail-closed lock, moon-on-system, the bump/lockworkflow, and the macos-x64 + nested-worktree gotchas.
.agents/skills/melange— building the controller-manager apk(
./cmd→manager, no version-var stamping, native per-arch,--runner docker)..agents/skills/apko— the minimal multi-arch nonroot image(
/usr/bin/manager, uid 65532),apko publish+ registry-resolved indexdigest, keyless cosign, syft SBOM, and the
attest.ymlSLSA L3 + Kyvernotie-in.
melange.yaml/apko.yaml+ the skills to thedownstream-customization checklist; drop stale Dockerfile-era notes
(Docker cache scopes, OCI archive names, OCI labels).
Testing
adversarially verified (a per-skill verify pass) against this repo's
mise.toml/melange.yaml/apko.yaml: melange + apko clean, one mise nit(a
root:-prefix) fixed.🤖 Generated with Claude Code