https://github.com/netresearch/docker-development-skill
Agent Skill: Docker image development patterns - Dockerfile best practices, CI testing, compose orchestration. By Netresearch.
https://github.com/netresearch/docker-development-skill
agent-skill ci-cd claude-code container docker docker-compose dockerfile testing
Last synced: 3 months ago
JSON representation
Agent Skill: Docker image development patterns - Dockerfile best practices, CI testing, compose orchestration. By Netresearch.
- Host: GitHub
- URL: https://github.com/netresearch/docker-development-skill
- Owner: netresearch
- License: other
- Created: 2026-01-29T17:18:27.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2026-03-28T08:35:59.000Z (3 months ago)
- Last Synced: 2026-03-28T13:07:20.043Z (3 months ago)
- Topics: agent-skill, ci-cd, claude-code, container, docker, docker-compose, dockerfile, testing
- Language: Shell
- Size: 75.2 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE-CC-BY-SA-4.0
- Agents: AGENTS.md
Awesome Lists containing this project
README
# Docker Development Skill
[](#license)
[](https://claude.ai/claude-code)
Agent Skill for Docker image development - Dockerfile best practices, CI testing patterns, and Docker Compose orchestration.
## Features
- **Dockerfile Best Practices** - Multi-stage builds, layer optimization, security
- **CI Testing Patterns** - Test Docker images reliably in CI pipelines
- **Docker Compose** - Service orchestration, health checks, networking
- **Docker Bake** - Multi-platform builds with BuildKit
- **Security** - Vulnerability scanning, non-root users, secret management
## Automatic Triggers
This skill activates automatically when working with:
| File Pattern | Description |
|--------------|-------------|
| `Dockerfile`, `Dockerfile.*`, `*.dockerfile` | Container image definitions |
| `docker-compose.yml`, `compose.yml` | Multi-container orchestration |
| `docker-bake.hcl` | BuildKit bake configurations |
| `.dockerignore` | Build context optimization |
## Installation
### Marketplace (Recommended)
Add the [Netresearch marketplace](https://github.com/netresearch/claude-code-marketplace) once, then browse and install skills:
```bash
# Claude Code
/plugin marketplace add netresearch/claude-code-marketplace
```
### npx ([skills.sh](https://skills.sh))
Install with any [Agent Skills](https://agentskills.io)-compatible agent:
```bash
npx skills add https://github.com/netresearch/docker-development-skill --skill docker-development
```
### Download Release
Download the [latest release](https://github.com/netresearch/docker-development-skill/releases/latest) and extract to your agent's skills directory.
### Git Clone
```bash
git clone https://github.com/netresearch/docker-development-skill.git
```
### Composer (PHP Projects)
```bash
composer require netresearch/docker-development-skill
```
Requires [netresearch/composer-agent-skill-plugin](https://github.com/netresearch/composer-agent-skill-plugin).
## Usage
The skill activates automatically when working on:
- Dockerfile development
- Docker Compose configurations
- Docker Bake multi-platform builds
- CI/CD pipelines for container images
- Container troubleshooting
### Example Prompts
- "Create a multi-stage Dockerfile for a Node.js app"
- "Set up GitHub Actions to build and push Docker images"
- "Why is my nginx config test failing in CI?"
- "Add health checks to my docker-compose.yml"
- "Create a docker-bake.hcl for multi-platform builds"
## Key Patterns
### Testing Images with Entrypoints
```bash
# Bypass entrypoint for direct testing
docker run --rm --entrypoint php myimage -v
```
### Testing nginx Configs in Isolation
```bash
# Mock upstream DNS
docker run --rm --add-host backend:127.0.0.1 nginx-image nginx -t
```
### Compose Validation in CI
```bash
# Create .env before validation
cp .env.example .env
sed -i 's/PLACEHOLDER/test_value/g' .env
docker compose config > /dev/null
```
## References
Extended documentation in `skills/docker-development/references/`:
- `ci-testing.md` - Comprehensive CI testing patterns
## Contributing
1. Fork the repository
2. Create a feature branch
3. Submit a pull request
## License
This project uses split licensing:
- **Code** (scripts, workflows, configs): [MIT](LICENSE-MIT)
- **Content** (skill definitions, documentation, references): [CC-BY-SA-4.0](LICENSE-CC-BY-SA-4.0)
See the individual license files for full terms.
## Author
[Netresearch DTT GmbH](https://www.netresearch.de)