docker-debugger — скилл для Claude Code: отладка Docker
Скилл docker-debugger для Claude Code разбирает сбои сборки и запуска контейнеров, проблемы сети и томов, настройки docker-compose. Находит причины ошибок и предлагает исправления конфигурации.
MIT 314 установок ★ 440 обновлён 2026-10-20
npx skills add OneWave-AI/claude-skills --skill docker-debugger -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/docker-debugger/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/docker-debugger/
1Через Skills CLI (Vercel)
npx skills add OneWave-AI/claude-skills --skill docker-debugger -a codex2Вручную: положить файлы
.agents/skills/docker-debugger/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add OneWave-AI/claude-skills --skill docker-debugger -a cursor2Вручную: положить файлы
.cursor/skills/docker-debugger/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install OneWave-AI/claude-skills docker-debugger2Вручную: положить файлы
.github/skills/docker-debugger/SKILL.md1Через Skills CLI (Vercel)
npx skills add OneWave-AI/claude-skills --skill docker-debugger -a gemini-cli2Командой платформы
gemini skills install https://github.com/OneWave-AI/claude-skills --path docker-debuggerВручную: положить файлы
.devin/skills/docker-debugger/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add OneWave-AI/claude-skills --skill docker-debugger -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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