agentsclimarketplace
Sign in

Docker dev environment

Skill martian56/claude-engineer/plugins/claude-engineer/skills/docker-dev-environment

Use when setting up local development services or running the project locally. Establishes the "stateful services in Docker, app runs native" pattern with Postgres, Redis, MinIO, and Mailpit.From its SKILL.md

Install
npx -y skills add martian56/claude-engineer --skill docker-dev-environment

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

3 things to look at

  • reads credentialsReads from 1 credential source: `.env`.
  • 2 stars2 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
  • runs commandsInstructs the agent to run 5 commands, including `docker compose up -d` and 4 more.

SKILL.md

1.8 KB, 424 tokens by cl100k_base, as published. Nobody here has run it

Docker Dev Environment

Announce at start: "I'm using claude-engineer:docker-dev-environment to run services in Docker and the app native."

Iron Law

Only stateful services run in Docker. The app (frontend + backend) runs NATIVELY in its own shell. Rationale: instant uvicorn --reload / next dev / vite HMR, real debuggers, and CI/toolchain parity - Docker handles only the painful-to-install backing services.

The baseline services (docker-compose.yml)

  • PostgreSQL - primary DB (localhost:5432).
  • Redis - cache, sessions, rate-limit, job broker (localhost:6379).
  • MinIO - S3-compatible object storage (localhost:9000 API / 9001 console) + a bucket-bootstrap step.
  • Mailpit - email capture for signup/reset flows (localhost:1025 SMTP / 8025 UI). All with healthchecks and named volumes. The native app connects via localhost URLs in .env.

The dev flow

  1. docker compose up -d (services only).
  2. Backend in shell A: uv run uvicorn ... (native).
  3. Frontend in shell B: pnpm dev / bun dev / vite (native).

Non-negotiables

  1. Never containerize the app for local dev (the guard hook will remind you).
  2. Healthchecks on every service; the app waits for healthy services.
  3. Secrets/connection strings via .env (git-ignored), documented.

Full detail (the complete compose file, MinIO bucket bootstrap, Mailpit SMTP config, connection settings): read references/dev-services.md on demand.

Red flags - STOP

  • docker compose up that builds/starts the app itself for local dev.
  • Hardcoded service URLs instead of .env.
  • A service with no healthcheck.

What ships with it: 1 file

35.9 KB alongside SKILL.md

references/

Keep looking

Skills are one crate of 325,949. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.