← Explore all skills

CONTAINERS / docker

Docker Project Foundations

Create the first Dockerfile, Compose stack and dockerignore with local-port and build-secret boundaries.

“Use this skill when setting up, initializing, or Dockerizing a project, even if the user doesn't explicitly mention Docker but describes a need for containerized local development, adding a database or cache dependency, or running services without host-level installs. Covers Dockerfile, compose.yaml, and .dockerignore creation with Docker best practices.”

01 / THE REASONING

Why this made the selection.

  • It creates a first Dockerfile, compose.yaml, and .dockerignore, and it mounts npm credentials instead of copying them into the image.
  • Published ports bind to loopback, and development databases stay on the Compose network rather than a host install.
  • Defines a coherent initial file set and separate ownership for later build/Compose tuning.
  • Explains optional npmrc BuildKit secrets and warns dependency scripts can access mounted credentials.

02 / THE REVIEW RECORD

What we actually inspected.

Source review has boundaries.
A clear record is more useful than a “safe” badge.

Material inspected

  • skills/docker-project-foundations/SKILL.md
  • skills/docker-project-foundations/scripts/verify-setup.sh
  • README.md
  • LICENSE

Our findings

  • The skill always creates Dockerfile, .dockerignore, and compose.yaml for a project that does not have them.
  • npm registry credentials are mounted for the build and must not be copied or passed through ARG or ENV.
  • Application ports bind to loopback by default, and unauthenticated datastores stay on the Compose network.
  • It does not recommend brew or apt installs for Postgres, Redis, or similar development dependencies.
  • verify-setup.sh checks three file names and runs docker compose config --quiet, returning failure for missing/invalid config.
  • Source keeps unauthenticated datastores on the Compose network and treats private-registry credentials as build-time access.

Not established by this review

  • The resource was not executed and its tools were not called.
  • No skill execution, authenticated service operation, or outcome benchmark was performed.
  • Not executed: it was not installed or run.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

Add a skill to your workflow.

Upstream setup instructions ↗

DOCUMENTED COMMAND

npx skills add docker/skills/skills/docker-project-foundations

Run in your terminal to choose your AI tools, project or global scope, and installation method. This short command follows the current upstream version; the review covers the revision shown above.

Optional: install the reviewed revision

Keeps the original source and installer version where recorded, while leaving your AI tools and installation scope for you to choose.

npx skills add https://github.com/docker/skills/tree/f79172733725e2fd236343ee7b963c446ed85d09/skills/docker-project-foundations
  1. Install the pinned skill directory interactively, retaining its bundled references and scripts.
  2. Inspect the app and create dockerignore before the first image build.
  3. Adapt starter assets, bind development ports to loopback and run verify-setup.sh from the project root.

Before you start

  • Docker and Compose v2
  • Application build/start commands and dependency requirements

04 / FOLLOW THE EVIDENCE

The source trail.

Our notes are separate from the original resource.
Check upstream before adopting a new version.

  1. Pinned skill definition ↗Checked

    https://github.com/docker/skills/blob/f79172733725e2fd236343ee7b963c446ed85d09/skills/docker-project-foundations/SKILL.md

    Supports: summary, whySelected, bestFor, limitations, install, access, review

  2. https://github.com/docker/skills/blob/f79172733725e2fd236343ee7b963c446ed85d09/README.md

    Supports: install

  3. Apache-2.0 licence ↗Checked

    https://github.com/docker/skills/blob/f79172733725e2fd236343ee7b963c446ed85d09/LICENSE

    Supports: license

  4. https://github.com/docker/skills/blob/f79172733725e2fd236343ee7b963c446ed85d09/skills/docker-project-foundations/scripts/verify-setup.sh

    Supports: review, limitations, access, install

  5. https://raw.githubusercontent.com/docker/skills/f79172733725e2fd236343ee7b963c446ed85d09/skills/docker-project-foundations/SKILL.md

    Supports: upstreamDescription, review.notTested, review.reviewedAt

Evidence & Ask