docker-extend

Generate user-specific Docker overrides in Dockerfile.user and docker-compose.override.yml.

Updated Apr 11, 2026
One-click install
npx skills add https://github.com/az9713/Archon-tutorial --skill docker-extend-az9713
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: docker-extend
Source: https://github.com/az9713/Archon-tutorial/tree/main/.claude/skills/docker-extend
Command: npx skills add https://github.com/az9713/Archon-tutorial --skill docker-extend-az9713

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Many developers want to tailor Docker environments for personal tools without altering the repo maintainers' files or committing user-specific configurations.

Core Features & Use Cases

  • Detects development (root docker-compose) vs deployment (deploy/ GHCR) contexts and applies the appropriate user overrides.
  • Creates and maintains Dockerfile.user and docker-compose.override.yml that are gitignored and private to the user.
  • Supports installing optional tools (e.g., vim, jq) without impacting the main Dockerfiles.

Quick Start

Specify the tools you want to install, and the Skill will generate your personal Docker overrides.

Frequently Asked Questions about docker-extend

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I customize Docker with personal tools without modifying the maintainer's Dockerfile?

To customize Docker without modifying maintainer files, you can create user-specific overrides in isolated files like Dockerfile.user and docker-compose.override.yml. These files are automatically gitignored, ensuring your personal tool installations remain private and do not impact the main repository configuration.

What is the best way to add personal utilities to a Docker environment in both development and deployment contexts?

Adding personal utilities across Docker contexts involves detecting whether you are using root docker-compose for development or deploy/ GHCR images for deployment. The system then applies the appropriate user overrides to your isolated configuration files, ensuring consistent personal tool availability across different stages without altering shared project files.

Can I install optional tools like vim or jq in Docker without affecting the main Dockerfiles?

Yes, you can install optional tools like vim or jq without affecting main Dockerfiles by specifying your desired tools during the setup process. The system generates personal Docker overrides that handle the installation, keeping your development environment customized without modifying the shared repository configuration.

Does Docker work with gitignored overrides for user-specific configurations?

Docker works seamlessly with gitignored overrides by utilizing Dockerfile.user and docker-compose.override.yml to manage user-specific configurations. This approach ensures that any personal customization or tool installation is isolated from the maintainer's files and automatically ignored by version control, preventing accidental commits.

Why does my Docker customization keep overwriting the repo maintainer's files?

Docker customization overwrites maintainer files when changes are applied directly to shared configurations. To prevent this, use isolated override files like Dockerfile.user and docker-compose.override.yml for your personal tools, ensuring your modifications remain separate and automatically gitignored from the main repository.

What happens if the Docker template for user overrides is missing?

If the Docker template for user overrides is missing, the system handles the absence by guiding you through the tool installation process and generating the necessary Dockerfile.user and docker-compose.override.yml files from scratch, ensuring your personal environment is still configured correctly.