How do I install the Make skill?

Run npx skillmds@latest add ansible/make in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Make?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

ansible (@ansible) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Make by ansible — Agent Skill

Name: Make
Author: ansible

Make

Reference for running lint, test, generate, and image build via the Makefile. Agents MUST use make targets for quality gates — do not invoke golangci-lint, go test, or controller-gen directly unless a skill explicitly allows it for debugging. This skill is the canonical lookup for which target to use.

ansible 950c90e 3.7 KB Updated Sep 17, 2026

File contents

make — Developer & Agent Orchestration

Usage

/make                  # Show this reference (read SKILL.md)
/make lint             # golangci-lint
/make test             # envtest unit tests
/make generate         # DeepCopy + controller-gen

The root Makefile is the primary orchestration layer. CI runs the same commands developers run locally.

Hard Rules

Quality gates before PR: make lint and make test (see pr-new).
Do not skip go mod tidy when CI does it (test.yml runs tidy before test).
After API or marker changes: make manifests generate then commit CRD/RBAC updates together with Go changes.
Image builds: make docker-build IMG=... or OpenShift BuildConfig in lab gitops; Dockerfile uses UBI go-toolset + ubi-minimal.

Target Reference

Quality gates (run before every PR)

Target	What it runs	When to use
`make lint`	`golangci-lint run` (via `bin/golangci-lint`)	Before every commit/PR
`make test`	envtest + `go test` (excludes `./test/e2e`)	After controller/manifest changes
`make fmt`	`go fmt ./...`	Optional; lint may expect formatted code
`make vet`	`go vet ./...`	Included in `make test` recipe chain

Code generation

Target	What it runs	When to use
`make generate`	controller-gen object DeepCopy	After `api/` type changes
`make manifests`	CRD, RBAC, webhook scaffolding	After kubebuilder markers / RBAC comments change

make test and make build depend on manifests generate fmt vet.

Build & image

Target	What it runs	When to use
`make build`	`go build` → `bin/manager`	Quick local compile
`make docker-build`	`docker build` / `podman build`	Local image (`IMG=...`)
`make docker-push`	Push `IMG`	After docker-build
`make docker-buildx`	Multi-arch buildx push	Release images
`make build-installer`	kustomize → `dist/install.yaml`	Offline install bundle

Cluster deploy (inner loop)

Target	What it runs	When to use
`make install`	CRDs only	First-time CRD install
`make deploy`	CRD + RBAC + manager Deployment	Dev cluster (`IMG=...`)
`make undeploy`	Remove manager	Tear down operator
`make uninstall`	Remove CRDs	Destructive

See also scripts/operator.mk (NAMESPACE, QUAY_USER, DEV_CR).

E2E (optional, slower)

Target	What it runs	When to use
`make test-e2e`	Kind + ginkgo e2e	Full cluster smoke (CI: `test-e2e.yml`)

Common Agent Workflows

"I changed controller or manifests"

make manifests generate   # if api/ or +kubebuilder markers changed
make lint
make test

"I changed only Dockerfile or manager Deployment resources"

make lint                 # if Go unchanged, still run if any .go touched
make docker-build IMG=quay.io/$USER/apme-operator:dev

"List all targets"

make help

CI parity

Workflow	Command
`.github/workflows/prek.yml`	`make golangci-lint` + prek
`.github/workflows/test.yml`	`go mod tidy && make test`
`.github/workflows/test-e2e.yml`	`make test-e2e`
`.github/workflows/release.yml`	multi-arch image push + `make build-installer`

---name: makedescription: Reference for running lint, test, generate, and image build via the Makefile. Agents MUST use make targets for quality gates — do not invoke golangci-lint, go test, or controller-gen directly unless a skill explicitly allows it for debugging. This skill is the canonical lookup for which target to use.---# make — Developer & Agent Orchestration## Usage```/make # Show this reference (read SKILL.md)/make lint # golangci-lint/make test # envtest unit tests/make generate # DeepCopy + controller-gen```The root `Makefile` is the primary orchestration layer. CI runs the samecommands developers run locally.## Hard Rules1. **Quality gates before PR:** `make lint` and `make test` (see `pr-new`).2. **Do not skip `go mod tidy`** when CI does it (`test.yml` runs tidy before test).3. **After API or marker changes:** `make manifests generate` then commit CRD/RBAC updates together with Go changes.4. **Image builds:** `make docker-build IMG=...` or OpenShift `BuildConfig` in lab gitops; Dockerfile uses UBI go-toolset + ubi-minimal.## Target Reference### Quality gates (run before every PR)| Target | What it runs | When to use ||--------|--------------|-------------|| `make lint` | `golangci-lint run` (via `bin/golangci-lint`) | Before every commit/PR || `make test` | envtest + `go test` (excludes `./test/e2e`) | After controller/manifest changes || `make fmt` | `go fmt ./...` | Optional; lint may expect formatted code || `make vet` | `go vet ./...` | Included in `make test` recipe chain |### Code generation| Target | What it runs | When to use ||--------|--------------|-------------|| `make generate` | controller-gen object DeepCopy | After `api/` type changes || `make manifests` | CRD, RBAC, webhook scaffolding | After kubebuilder markers / RBAC comments change |`make test` and `make build` depend on `manifests generate fmt vet`.### Build & image| Target | What it runs | When to use ||--------|--------------|-------------|| `make build` | `go build` → `bin/manager` | Quick local compile || `make docker-build` | `docker build` / `podman build` | Local image (`IMG=...`) || `make docker-push` | Push `IMG` | After docker-build || `make docker-buildx` | Multi-arch buildx push | Release images || `make build-installer` | kustomize → `dist/install.yaml` | Offline install bundle |### Cluster deploy (inner loop)| Target | What it runs | When to use ||--------|--------------|-------------|| `make install` | CRDs only | First-time CRD install || `make deploy` | CRD + RBAC + manager Deployment | Dev cluster (`IMG=...`) || `make undeploy` | Remove manager | Tear down operator || `make uninstall` | Remove CRDs | Destructive |See also `scripts/operator.mk` (`NAMESPACE`, `QUAY_USER`, `DEV_CR`).### E2E (optional, slower)| Target | What it runs | When to use ||--------|--------------|-------------|| `make test-e2e` | Kind + ginkgo e2e | Full cluster smoke (CI: `test-e2e.yml`) |## Common Agent Workflows### "I changed controller or manifests"```bashmake manifests generate # if api/ or +kubebuilder markers changedmake lintmake test```### "I changed only Dockerfile or manager Deployment resources"```bashmake lint # if Go unchanged, still run if any .go touchedmake docker-build IMG=quay.io/$USER/apme-operator:dev```### "List all targets"```bashmake help```## CI parity| Workflow | Command ||----------|---------|| `.github/workflows/prek.yml` | `make golangci-lint` + prek || `.github/workflows/test.yml` | `go mod tidy && make test` || `.github/workflows/test-e2e.yml` | `make test-e2e` || `.github/workflows/release.yml` | multi-arch image push + `make build-installer` |

Frequently asked questions