Skip to the rows

agentsclimarketplace

Debug docker service

Skill choutos/agent-skills-spec/examples/debug-docker-service

Open specification for packaging procedural knowledge for AI agents. Framework-agnostic SKILL.md format.

Install

npx -y skills add choutos/agent-skills-spec --skill debug-docker-service

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Diagnose and fix Docker container issues. Use when a service is not responding, container is in restart loop, or health check fails. Triggers on: docker, container, service down, not responding, restart loop, health check.

SKILL.md

1.5 KB, as published. Nobody here has run it

Debug Docker Service

Diagnosis Flow

Check container status:
```
docker compose ps
```
If container is restarting:
```
docker compose logs --tail=50 <service>
```
Common causes: missing env vars, port conflicts, OOM kills.

If container is stopped:

docker compose up -d <service>
docker compose logs -f <service>  # watch startup

If container is running but service unresponsive:

docker compose exec <service> sh  # get a shell
# Check if process is running inside
# Check if port is listening
netstat -tlnp || ss -tlnp

Resource issues:

docker stats --no-stream
df -h  # disk full?

Common Fixes

Symptom	Fix
OOM killed	Increase memory limit in compose file
Port conflict	Check `docker compose ps` for port bindings, stop conflicting service
Volume mount error	Verify host path exists: `ls -la <path>`
Image not found	`docker compose pull <service>`
Config changed	`docker compose up -d --force-recreate <service>`

After Fixing

Always verify the service is healthy:

docker compose ps  # status should be "Up"
curl -s http://localhost:<port>/health  # if applicable

Keep looking

Skills are one crate of 328,083. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.