---

name: docker-docs description: Reference Docker and Compose documentation for configuration patterns and best practices

Docker Documentation Reference Skill

Overview

This skill provides access to comprehensive Docker and Docker Compose documentation. Use this skill to look up exact configurations, command syntax, and best practices before generating any Docker-related files.

Documentation Location

All documentation is stored in: /home/mwguerra/projects/mwguerra/claude-code-plugins/docker-specialist/skills/docker-docs/references/

Directory Structure

references/
├── 01-introduction.md       # Docker concepts, key terms
├── 02-dockerfile.md         # Dockerfile instructions, multi-stage builds
├── 03-compose-fundamentals.md  # Compose file structure, options
├── 04-networking.md         # Network types, DNS, external networks
├── 05-databases.md          # PostgreSQL, MySQL, MongoDB, Redis
├── 06-services.md           # Dependencies, scaling, patterns
├── 07-ports-ssl.md          # Port mapping, Traefik, Nginx SSL
├── 08-volumes.md            # Volume types, persistence, backups
├── 09-environment.md        # Env vars, secrets, .env files
├── 10-architecture.md       # Project structures, folder organization
├── 11-global-local.md       # Global vs project containers
├── 12-examples.md           # Complete working examples
├── 13-commands.md           # Essential Docker commands
├── 14-security.md           # Security best practices
├── 15-port-conflicts.md     # Port conflict resolution
├── 16-restart-strategies.md # Restart policies, data persistence
└── 17-troubleshooting.md    # Common issues and solutions

Usage

When to Use This Skill

1. Before generating any Dockerfile or compose configuration
2. When troubleshooting Docker errors
3. To verify correct command syntax
4. To find proper configuration patterns
5. To understand Docker networking
6. For security best practices

Search Workflow

1. Identify Topic: Determine what documentation is needed
2. Navigate to File: Go to relevant documentation file
3. Read Documentation: Extract exact patterns
4. Apply Knowledge: Use in configuration generation

Common Lookups

Topic	File
Dockerfile creation	02-dockerfile.md
Compose configuration	03-compose-fundamentals.md
Container networking	04-networking.md
Database setup	05-databases.md
Multi-container apps	06-services.md
SSL/TLS setup	07-ports-ssl.md
Volume management	08-volumes.md
Environment variables	09-environment.md
Project structure	10-architecture.md
Commands reference	13-commands.md
Security	14-security.md
Troubleshooting	17-troubleshooting.md

Documentation Reading Pattern

When reading documentation:

1. Find the right file: Match topic to documentation file
2. Read the overview: Understand the concept
3. Extract code examples: Copy exact patterns
4. Note configuration options: Review available settings
5. Check best practices: Apply security and performance tips

Example Usage

Looking up PostgreSQL Configuration

1. Navigate to 05-databases.md
2. Find PostgreSQL section
3. Extract:
   • Image version
   • Environment variables
   • Health check configuration
   • Volume setup
   • Network configuration

Looking up Network Configuration

1. Navigate to 04-networking.md
2. Find relevant section (bridge, external, internal)
3. Extract:
   • Network definition syntax
   • Service network configuration
   • DNS resolution patterns

Output

After reading documentation, provide:

1. Exact configuration pattern from docs
2. Required settings
3. Optional configurations
4. Best practices noted
5. Security considerations