Documentation/Tools/Docker Compose
🔧

Docker Compose

v1.10.0Apache 2.0

Docker Compose validation and best practices

toolsskillhooklspdockerdocker-composecontainersdevops

Installation

Install han binary (required for hooks to work):

curl -fsSL https://han.guru/install.sh | bash

Then install this plugin:

han plugin install docker-compose

Overview

Docker Compose configuration validation for container orchestration.

Features

  • Validates Docker Compose files with docker compose config
  • Provides skills for working with Docker Compose

Requirements

Install Docker with Compose plugin:

bash
# macOS
brew install docker

# Linux
curl -fsSL https://get.docker.com | sh

Skills Included

  • docker-compose-basics: Docker Compose configuration and usage

Hook Behavior

Validates Docker Compose files (docker-compose..yaml, compose..yaml) using docker compose config.

Installation

Install with npx (no installation required):

bash
han plugin install jutsu-docker-compose

LSP Servers

🧠

docker-compose-langserver

Languages:

dockercompose

File Extensions:

.yaml.yml

Command:

${CLAUDE_PLUGIN_ROOT}/scripts/lsp-entrypoint.sh --stdio

Skills

📖

docker-compose-basics

Use when defining and running multi-container Docker applications with Docker Compose YAML configuration.

📖

docker-compose-networking

Use when configuring networks and service communication in Docker Compose including bridge networks, overlay networks, service discovery, and inter-service communication.

📖

docker-compose-production

Use when deploying Docker Compose applications to production including security hardening, resource management, health checks, logging, monitoring, and high-availability patterns.

Hooks

⚠ī¸

Token Usage Notice

Hooks run automatically during Claude Code sessions and their output is sent to the model for processing. This may increase token usage and associated costs. Consider disabling hooks you don't need via han-config.yml.

🛑

Stop

Runs when the main Claude Code agent has finished responding. Can verify task completion, check quality gates, or ensure documentation requirements are met before the session ends.

docker compose config > /dev/null