Skip to content

docs(skills): add mise/melange/apko tooling skills - #46

Merged
jmgilman merged 1 commit into
masterfrom
docs/tooling-skills
Jun 28, 2026
Merged

jmgilman merged 1 commit into
masterfrom
docs/tooling-skills

Conversation

@jmgilman

Copy link
Copy Markdown
Contributor

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 in
    mise.toml (incl. 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, --runner docker).
  • .agents/skills/apko — the minimal multi-arch nonroot image
    (/usr/bin/manager, uid 65532), apko publish + 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.
  • DELETE_ME.md — add melange.yaml/apko.yaml + the skills to the
    downstream-customization checklist; drop stale Dockerfile-era notes
    (Docker cache scopes, OCI archive names, OCI labels).

Testing

  • Each skill was ported from the proven template-go-api originals and
    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.
  • Markdown/docs only — no Go, chart, or workflow logic changes.

🤖 Generated with Claude Code

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>
@jmgilman
jmgilman merged commit 553fc73 into master Jun 28, 2026
6 of 7 checks passed
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