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.
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 - Install the pinned skill directory interactively, retaining its bundled references and scripts.
- Inspect the app and create dockerignore before the first image build.
- 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.
- 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
https://github.com/docker/skills/blob/f79172733725e2fd236343ee7b963c446ed85d09/README.md
Supports: install
- Apache-2.0 licence ↗Checked
https://github.com/docker/skills/blob/f79172733725e2fd236343ee7b963c446ed85d09/LICENSE
Supports: license
https://github.com/docker/skills/blob/f79172733725e2fd236343ee7b963c446ed85d09/skills/docker-project-foundations/scripts/verify-setup.sh
Supports: review, limitations, access, install
https://raw.githubusercontent.com/docker/skills/f79172733725e2fd236343ee7b963c446ed85d09/skills/docker-project-foundations/SKILL.md
Supports: upstreamDescription, review.notTested, review.reviewedAt