# CI Images

> Work with this repo’s GitHub Actions CI and GHCR Docker image publishing workflow. Use when changing generation checks, tests, formatting, or when preparing a release and validating image tags. Use when this capability is needed.

- Skill: `tomevault-io/ci-images` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/ci-images`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/ci-images/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/ci-images

---


## Tooling assumptions

- Use a terminal runner with bash and git available.
- Prefer `make` targets when available; fall back to direct CLI commands when needed.

## CI overview (local equivalents)

The CI workflow enforces:

- generated code is up to date (templ + sqlc)
- gofmt formatting
- go vet
- go test

Local one-liners:

```bash
make generate
make fmt
make vet
make test
```

## Docker image publishing

Workflow: `.github/workflows/docker-publish.yml`

- Runs on GitHub Release publish (and manually via workflow_dispatch)
- Publishes to GHCR with tags:
  - semver `vX.Y.Z`
  - `X.Y`, `X`
  - `latest` on release

## Suggested pre-release checklist

```bash
make test
make validate-openapi
```

If you changed SQL/templ, ensure `make generate` output is committed.

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/matt-riley) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-14 -->