Works with the AI Agents you already use

    Claude CodeClaude CodeCursorCursorCodex CLICodex CLIMuseMuseDotsDots+21 more

    Docker Ops Playbook skill

    1

    A safe Docker operations assistant for container management, troubleshooting, and risk-aware cleanup.

    $5

    Secure checkout via Stripe

    Money-back guarantee

    Converts to your local currency at checkout

    Security scanned
    Docker Ops Playbook skill

    Docker Ops Playbook skill

    Example session with this skill installed

    My web-app container is failing its health check and restarting. Can you help me diagnose the logs and fix it? The container name is 'prod-api-v1'.

    • Read your context and instructions
    • Compiled the docker ops playbook

    I will diagnose the health check failure for 'prod-api-v1' by inspecting the current status, logs, and health configuration.

    Docker Health Diagnosis: prod-api-v1

    1. Operation: Initial Status & Config Inspection

    First, we need to see exactly why Docker marks it as unhealthy and what the defined health check is actually doing.

    2. Commands

    
    # Check current container status and last 5 health check outputs
    docker inspect --format='{{json .State.Health}}' prod-api-v1 | jq
    
    # View the last 50 lines of logs with timestamps
    docker logs --tail 50 --timestamps prod-api-v1
    

    3. Explanation

    • docker inspect: Extracts the specific Health object from the container metadata. This shows the exit codes and logs of the internal health check command.
    • docker logs: Provides the application-level stdout/stderr to see if the app is crashing before the health check even runs.

    4. Verification

    If the Status in the inspect output is unhealthy, look at Log array in the JSON. An exit code of 1 usually indicates the health check command (like curl or a script) failed to reach the service.

    5. Safety Note

    Do not restart the container until you have captured the logs; if the restart policy is active, logs from the failed instance might be rotated or lost depending on your logging driver.

    6. Troubleshooting

    If the logs show "Connection Refused," check if the service is listening on the expected port inside the container:

    docker exec prod-api-v1 netstat -tulpn
    

    Next steps

    • Provide the output of the docker inspect command above.
    • Confirm if the application requires a specific startup delay before the health check begins.
    • Check if the health check command (e.g., curl) is actually installed in the container image.

    Connects securely to your tools. The creator never sees your data.

    About this skill

    Docker management often involves trial-and-error commands that risk data loss or system downtime. This skill provides a structured operational framework for managing containers, images, and stacks with a focus on safety and verification. It transforms vague troubleshooting into precise, executable steps.

    What it does

    • Container Lifecycle Management handles starting, stopping, and renaming containers with pre-operation status checks.
    • Log Diagnosis extracts specific error patterns and health check failures to identify root causes of restart loops.
    • Volume & Network Audits maps persistent data paths and container-to-container connectivity to prevent configuration drift.
    • Compose Orchestration manages multi-container stacks including scaling, rebuilding, and targeted service restarts.
    • Risk-Aware Cleanup identifies dangling images and unused volumes while requiring verification before destructive pruning.

    How it works

    1. Inspection starts by querying the current state of the Docker engine or specific resource.
    2. Operation Planning generates the necessary docker or docker compose commands based on the identified state.
    3. Safety Verification provides a "dry-run" or targeted command to prevent broad data loss.
    4. Execution and Validation delivers the final commands alongside specific checks to confirm the desired state was reached.

    Frameworks & tools

    Docker Engine, Docker Compose, and standard Linux/Unix CLI utilities for container management.

    Why this beats prompting it yourself

    Generic prompts often suggest destructive prune commands or broad rm flags without checking for volume persistence. This skill enforces an inspection-first workflow, ensuring you verify resource dependencies and health status before making changes.

    Use cases

    • Troubleshooting a container that is stuck in a CrashLoopBackOff or restart cycle.
    • Safely reclaiming disk space by identifying truly unused images and build caches.
    • Mapping complex container networks to resolve service-to-service communication errors.
    • Migrating or backing up persistent volumes after verifying mount points.

    Known limitations

    Does not support Kubernetes/K8s orchestration or cloud-specific container services like ECS/Fargate. Requires manual input of existing resource names or states to avoid inventing system data.

    Does not support Kubernetes. Cannot auto-detect environment state without user-provided logs or command output. No support for cloud-specific container services like AWS ECS.

    How to use

    1. 1

      Connect your agent to the Agensi MCP

      Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup

    2. 2

      Sign in to Agensi

      Your agent shows a sign-in link. Sign in and click Allow.

    3. 3

      Ask for what you need

      Your agent loads this skill and uses it on your task. It always asks before any payment.

    Reviews

    No reviews yet

    Be one of the first to try it. Every listed skill goes through the trust checks below.

    Security scanned

    Checked by our 8-point scan before listing

    Fresh listing

    Recently published to Agensi

    Money-back guarantee

    Doesn't do what its page promises? You get your money back.

    Trust & safety

    Security scan

    Security scan passed 1 month ago

    Permissions

    No special permissions declared or detected

    Listed1 month ago

    What's inside

    Frequently Asked Questions

    The skill provides a structured, safety-first framework for Docker and Docker Compose management, prioritizing pre-operation inspections and dependency checks to prevent accidental data loss or service downtime.

    This skill is compatible with AI agents that have access to a terminal or CLI environment and supports standard Docker Engine and Docker Compose setups on Linux or Unix-based systems.

    No, this skill is specifically designed for local or server-based Docker and Docker Compose environments and does not support Kubernetes (K8s) or cloud-native services like AWS ECS or Fargate.

    The skill includes the complete operational logic for container management, log diagnosis, and volume auditing, along with a guide on how to integrate these workflows into your preferred AI agent.

    Yes, the skill includes a 'Risk-Aware Cleanup' module that identifies dangling images and unused volumes, requiring a verification step before any destructive pruning commands are suggested.

    New in DevOps & Cloud