agentsclimarketplace

Docker dev environment

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

Claude Code marketplace and home of claude-engineer: an opinionated, design-system-first, plan-gated autonomous engineer for full greenfield React/Next and FastAPI projects.

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.

One thing to look at

  • 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.

What its author says it does

Copied from the file, not written here

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.

SKILL.md

1.8 KB, 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.

Keep looking

Skills are one crate of 328,083. 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.