К основному содержанию
скилл CX Codex

docker-debugger — скилл для Claude Code: отладка Docker

Скилл docker-debugger для Claude Code разбирает сбои сборки и запуска контейнеров, проблемы сети и томов, настройки docker-compose. Находит причины ошибок и предлагает исправления конфигурации.

MIT 314 установок ★ 440 обновлён 2026-10-20

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add OneWave-AI/claude-skills --skill docker-debugger -a claude-code
Открыть на GitHub

Что делает docker-debugger

Сначала скилл относит проблему к сборке, работе контейнера, сети или производительности. Затем предлагает собрать диагностику командами Docker, изучить логи и ошибки и применить исправление. Например, при остановке контейнера он проверяет код выхода и последние логи; при проблемах с сетью — список сетей и настройки контейнера.

В рекомендациях по Dockerfile есть многоэтапная сборка, порядок копирования файлов для кэширования и запуск от непривилегированного пользователя. Для docker-compose скилл предлагает включить интерактивный терминал, переопределить команду и посмотреть логи сервиса. Некоторые советы используют Node.js и npm, поэтому переносить примеры в проект на другом стеке нужно с поправкой на его сборку.

Скилл анализирует ситуацию по диагностическим данным, а не запускает исправления сам. Подготовьте логи и сведения о контейнере, чтобы агент мог опереться на них.

Какие задачи решает

  • найти причину остановки контейнера
  • разобрать ошибку сборки Dockerfile
  • проверить сетевое подключение контейнеров
  • исправить права на подключённый том
  • отладить сервис в docker-compose

Примеры запросов агенту

  • Разбери логи контейнера web и выясни, почему он завершился.
  • Проверь этот Dockerfile: почему сборка падает и что исправить?
  • Помоги отладить сеть и тома сервиса в docker-compose.yml.

Как установить docker-debugger

1Через Skills CLI (Vercel)

npx skills add OneWave-AI/claude-skills --skill docker-debugger -a claude-code

2Вручную: положить файлы

~/.claude/skills/docker-debugger/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/docker-debugger/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о docker-debugger

Как установить docker-debugger в Claude Code?

Выполните npx skills add OneWave-AI/claude-skills --skill docker-debugger -a claude-code, затем используйте скилл из ~/.claude/skills/docker-debugger/SKILL.md.

Что делает docker-debugger?

Помогает разбирать сбои сборки и запуска контейнеров, сетевые ошибки и проблемы с правами на тома. Также даёт рекомендации по Dockerfile и отладке docker-compose.

Какие команды Docker использует скилл для диагностики?

В примерах есть docker ps -a, docker logs, docker inspect, docker stats и команды для проверки сетей и истории образа.

Исходный текст

SKILL.md · MIT
---
name: docker-debugger
description: Debug Docker containers, fix Dockerfile issues, optimize images, and troubleshoot docker-compose. Use when having Docker problems, container issues, or optimizing Docker builds.
---

# Docker Debugger

## Instructions

When debugging Docker issues:

1. **Identify the problem type**: Build, runtime, networking, or performance
2. **Gather information** using diagnostic commands
3. **Analyze logs and errors**
4. **Apply fixes**

## Diagnostic Commands

```bash
# Check running containers
docker ps -a

# View container logs
docker logs <container_id> --tail 100 -f

# Inspect container
docker inspect <container_id>

# Check resource usage
docker stats

# View container processes
docker top <container_id>

# Execute shell in running container
docker exec -it <container_id> /bin/sh

# Check Docker disk usage
docker system df

# View build history
docker history <image_name>
```

## Common Issues & Solutions

### 1. Container exits immediately

```bash
# Check exit code
docker inspect <container_id> --format='{{.State.ExitCode}}'

# View last logs
docker logs <container_id>
```

**Fixes**:
- Ensure CMD/ENTRYPOINT runs a foreground process
- Check for missing dependencies
- Verify environment variables

### 2. Build fails

```dockerfile
# Use multi-stage builds for smaller images
FROM node:20-alpine AS builder
WORKDIR /app
COPY package*.json ./
RUN npm ci
COPY . .
RUN npm run build

FROM node:20-alpine AS runner
WORKDIR /app
COPY --from=builder /app/dist ./dist
COPY --from=builder /app/node_modules ./node_modules
CMD ["node", "dist/index.js"]
```

### 3. Networking issues

```bash
# List networks
docker network ls

# Inspect network
docker network inspect <network_name>

# Check container IP
docker inspect -f '{{range.NetworkSettings.Networks}}{{.IPAddress}}{{end}}' <container>
```

### 4. Volume permission issues

```dockerfile
# Create non-root user
RUN addgroup -g 1001 -S appgroup && \
    adduser -u 1001 -S appuser -G appgroup

# Set ownership
COPY --chown=appuser:appgroup . .

USER appuser
```

## Dockerfile Best Practices

```dockerfile
# 1. Use specific tags, not :latest
FROM node:20.10-alpine

# 2. Set working directory
WORKDIR /app

# 3. Copy dependency files first (better caching)
COPY package*.json ./
RUN npm ci --only=production

# 4. Copy source after dependencies
COPY . .

# 5. Use non-root user
USER node

# 6. Set proper labels
LABEL maintainer="[email protected]"
LABEL version="1.0"

# 7. Use HEALTHCHECK
HEALTHCHECK --interval=30s --timeout=3s \
  CMD wget -q --spider http://localhost:3000/health || exit 1

# 8. Expose ports
EXPOSE 3000

# 9. Use exec form for CMD
CMD ["node", "server.js"]
```

## docker-compose Debugging

```yaml
# docker-compose.yml
services:
  app:
    build:
      context: .
      dockerfile: Dockerfile
    # Add for debugging
    stdin_open: true
    tty: true
    # Override command for debugging
    command: /bin/sh
    volumes:
      - .:/app
    environment:
      - DEBUG=true
```

```bash
# Rebuild without cache
docker-compose build --no-cache

# View logs
docker-compose logs -f app

# Restart single service
docker-compose restart app
```

© OneWave-AI · MIT · OneWave-AI/claude-skills

Похожие скиллы

Все скиллы по теме «DevOps и инфраструктура» →
docker codewithmukesh Скилл docker настраивает контейнеризацию приложений на .NET 10: многоэтапную сборку, запуск под непривилегированным пользователем и проверку работоспособности. CX Codex +1 4 000установок docker-project-foundations docker Скилл docker-project-foundations настраивает первичное окружение Docker для нового проекта. Он сразу создаёт базовую тройку файлов: .dockerignore, Dockerfile и compose.yaml. CX Codex +1 1 700установок docker-development Alireza Rezvani Скилл docker-development для Claude Code анализирует Dockerfile, Docker Compose и контейнеры, выявляя проблемы с размером, сборкой и безопасностью. Разбирает Docker-конфигурацию по чек-листу. CX Codex +1 702установок docker-containerization aj-geddes Скилл docker-containerization для Claude Code: multi-stage сборки, минимальный образ, безопасная конфигурация. Превращает приложение в Docker-образ и приводит в порядок существующие Dockerfile. CX Codex +1 683установок bun-docker secondsky Скилл bun-docker подсказывает, как собрать Dockerfile и docker-compose для приложения на Bun: официальные образы oven/bun, многоэтапные сборки, hot reload. CX Codex +1 431установок docker-expert PCL Team Скилл docker-expert для Claude Code и других агентов: собирает образы, чинит Dockerfile и настраивает Compose. Уменьшает раздувшийся контейнер и устраняет падение на старте. CX Codex +1 375установок

Из того же набора185

Весь набор →
sports-podcast-outline-generator Скилл sports-podcast-outline-generator собирает структуру выпуска спортивного подкаста: тайминг сегментов, темы для спора, вопросы слушателей и места под рекламу. CX Codex +1 320установок post-game-press-conference-simulator Генерирует правдоподобные ответы тренеров и игроков на послематчевых пресс-конференциях. Создаёт реплики для спортивных медиа, текстов и игровых диалогов после побед, поражений и травм. CX Codex +1 320установок api-endpoint-scaffolder Скилл api-endpoint-scaffolder собирает REST-эндпоинты по шаблонам для Next.js App Router и Express: схема Zod, коды ответов, обработка ошибок. CX Codex +1 317установок error-boundary-creator Скилл error-boundary-creator создаёт предохранители ошибок, запасные интерфейсы и перехват сбоев для React и Next.js. Помогает изолировать падения сторонних библиотек и настроить логирование. CX Codex +1 316установок scout Скилл scout для Claude Code разбирает текущий диалог и рекомендует скилл или субагента для задачи. Помогает выбрать инструмент среди десятков команд. CX Codex +1 314установок test-coverage-improver Скилл test-coverage-improver находит пробелы в покрытии тестами и генерирует недостающие тесты для критичных участков кода. CX Codex +1 312установок env-setup-wizard Скилл env-setup-wizard настраивает файлы .env, создаёт типобезопасные схемы валидации через Zod и защищает проект от утечки секретов в git. CX Codex +1 308установок client-proposal-generator Скилл client-proposal-generator для Claude Code собирает из брифа проект коммерческого предложения в proposal.md с планом работ и вариантами цены. Готовит предложение под конкретного клиента. CX Codex +1 301установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой