docker-extend
Best for Development teamsWorks with GitHubLow risk
⌘source
- author
@coleam00- repo
- coleam00/Archon
- language
- TypeScript
★19kstars
2.9kforks
Apr 18, 2026
✦overview.md
Key Features
- ·Sets up gitignored Dockerfile.user and docker-compose.override.yml
- ·Adds personal tools to Docker environment without affecting maintainer files
- ·Keeps user-specific configuration out of git commits
- ·Automatically detects development or deployment mode
- ·Works with existing Docker Compose setups
Use Cases
- →Adding personal development tools like vim or ripgrep to a team Docker environment
- →Customizing Docker containers for individual workflow preferences without breaking shared configurations
- →Setting up user-specific Docker tooling in collaborative projects
Best for
- ✓Development teams
- ✓Individual developers working in shared Docker environments
- ✓Projects using Docker Compose
Not ideal for
- !Production deployments
- !One-time container builds
- !Projects without Docker Compose
FAQs
name
docker-extend
description
Use when: User wants to extend Docker with custom tools, personalize the Docker environment,
or set up user-specific Docker customization.
Triggers: 'extend docker', 'docker-extend', 'add tools to docker', 'customize docker',
'add my tools to the container', 'personalize docker setup', 'docker user setup',
'install tools in docker'.
Does: Interactively sets up Dockerfile.user and docker-compose.override.yml so users can
add personal tools to their Docker environment without affecting maintainer files or
committing user-specific config to git.
argument-hint:[optional: tools to install, e.g. "vim ripgrep jq"]
Docker Extend
Sets up personal Docker tool customization using the project's gitignored override pattern.
Your Dockerfile.user and docker-compose.override.yml are yours — never committed to git.
Step 1: Detect Context
Determine if the user is in dev (source build) or deploy (GHCR) mode:
!if [ -f docker-compose.yml ] && grep -q 'build: \.' docker-compose.yml 2>/dev/null; then echo "DEV_MODE: Building from source (root docker-compose.yml)"; elif [ -f deploy/docker-compose.yml ]; then echo "DEPLOY_MODE: Using GHCR image (deploy/docker-compose.yml)"; else echo "UNKNOWN_MODE: No docker-compose.yml found in root or deploy/"; fi
Decision:
DEV_MODE→ work withDockerfile.user+docker-compose.override.yml(repo root)DEPLOY_MODE→ work withdeploy/Dockerfile.user+deploy/docker-compose.override.ymlUNKNOWN_MODE→ ask the user which directory theirdocker-compose.ymllives in before proceeding
Step 2: Check Current State
DEV_MODE — check root files:
$install
1-click copynpx skills add coleam00/Archon --skill docker-extendSafety assessment
★
Clarity score
How clear and easy to understand the SKILL.md instructions are, rated from 1 to 5.
5/ 5
excellentVery clear and well structured, with almost no room for misunderstanding.
◎
Actionability score
How directly an agent can act on the SKILL.md instructions, rated from 1 to 5.
5/ 5
very highHighly actionable with clear, concrete steps that an agent can follow directly.