# Send Docker Container Cleaner to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "docker-container-cleaner",
    "name": "Docker Container Cleaner",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/Derick001/docker-container-cleaner",
    "canonicalUrl": "https://clawhub.ai/Derick001/docker-container-cleaner",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/docker-container-cleaner",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=docker-container-cleaner",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "scripts/main.py"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "docker-container-cleaner",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-02T15:45:39.329Z",
      "expiresAt": "2026-05-09T15:45:39.329Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=docker-container-cleaner",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=docker-container-cleaner",
        "contentDisposition": "attachment; filename=\"docker-container-cleaner-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "docker-container-cleaner"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/docker-container-cleaner"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/docker-container-cleaner",
    "downloadUrl": "https://openagent3.xyz/downloads/docker-container-cleaner",
    "agentUrl": "https://openagent3.xyz/skills/docker-container-cleaner/agent",
    "manifestUrl": "https://openagent3.xyz/skills/docker-container-cleaner/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/docker-container-cleaner/agent.md"
  }
}
```
## Documentation

### What This Does

A CLI tool that helps clean up Docker resources to free up disk space. It can:

List and remove stopped containers
Remove dangling images (images with no tag)
Remove unused images (not used by any container)
Remove unused volumes
Remove unused networks
Perform a "prune all" operation (Docker system prune)

The tool provides a safe, interactive mode by default, showing what will be removed and asking for confirmation before deleting anything.

### When To Use

Your Docker disk usage is growing and you need to free up space
You have many stopped containers that are no longer needed
You have old, unused images taking up disk space
You want to clean up Docker resources in a controlled, safe way
You need to automate Docker cleanup in scripts or CI/CD pipelines

### Usage

Interactive cleanup (recommended for first use):

python3 scripts/main.py clean

Remove stopped containers only:

python3 scripts/main.py clean --containers

Remove dangling images only:

python3 scripts/main.py clean --images --dangling

Remove unused images (all images not used by containers):

python3 scripts/main.py clean --images --unused

Remove unused volumes:

python3 scripts/main.py clean --volumes

Remove unused networks:

python3 scripts/main.py clean --networks

Force cleanup (no confirmation):

python3 scripts/main.py clean --all --force

Dry run (show what would be removed):

python3 scripts/main.py clean --all --dry-run

### Example 1: Interactive cleanup

python3 scripts/main.py clean

Output:

Docker Cleanup Tool
===================

Found resources:
- Stopped containers: 3 (using 1.2GB)
- Dangling images: 5 (using 850MB)
- Unused images: 2 (using 450MB)
- Unused volumes: 1 (using 100MB)
- Unused networks: 0

Total disk space that can be freed: 2.6GB

What would you like to clean up?
1. Remove stopped containers
2. Remove dangling images
3. Remove unused images
4. Remove unused volumes
5. Remove unused networks
6. All of the above
7. Cancel

Enter choice [1-7]: 2

About to remove 5 dangling images (850MB):
- python:3.9-alpine (dangling)
- node:16-slim (dangling)
- ...

Are you sure? (y/N): y
Removing images...
✅ Cleanup complete! Freed 850MB of disk space.

### Example 2: Script-friendly JSON output

python3 scripts/main.py status --format json

Output:

{
  "containers": {
    "running": 2,
    "stopped": 3,
    "stopped_size_mb": 1200
  },
  "images": {
    "total": 15,
    "dangling": 5,
    "dangling_size_mb": 850,
    "unused": 2,
    "unused_size_mb": 450
  },
  "volumes": {
    "total": 4,
    "unused": 1,
    "unused_size_mb": 100
  },
  "networks": {
    "total": 3,
    "unused": 0
  },
  "total_reclaimable_mb": 2600
}

### Requirements

Python 3.x
Docker: Must be installed and the Docker daemon must be running
Docker CLI: Must be available in PATH (docker command)
Docker SDK for Python: Optional, but recommended for better performance

Install Docker SDK for Python (optional):

pip install docker

### Limitations

This is a CLI tool, not an auto-integration plugin
Requires Docker daemon to be running and accessible
Some operations require elevated permissions (sudo)
Cannot clean up resources in use by running containers
Image size calculations are approximate
Network and volume cleanup may fail if resources are in use
Does not clean up Docker build cache (use docker builder prune)
Does not clean up Docker Compose resources automatically
Performance depends on number of Docker resources
Large cleanup operations may take significant time
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: Derick001
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-02T15:45:39.329Z
- Expires at: 2026-05-09T15:45:39.329Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/docker-container-cleaner)
- [Send to Agent page](https://openagent3.xyz/skills/docker-container-cleaner/agent)
- [JSON manifest](https://openagent3.xyz/skills/docker-container-cleaner/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/docker-container-cleaner/agent.md)
- [Download page](https://openagent3.xyz/downloads/docker-container-cleaner)