agentleFS
G1JoshiG1Joshi/Agent-Skills/skills/tools/docker-desktop/SKILL.md

docker-desktop

Skill15 starsChanged 42 days agoMITView on GitHub

Expert Docker Desktop assistance covering container resource allocation, Docker Compose, Kubernetes, Extensions, and VirtioFS. Use when configuring and troubleshooting local developer container environments.

1 other project uses a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

2 rules. About 0 are common, 1 is distinctive, and 1 is very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈1

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Run docker system prune --volumes periodically to reclaim gigabytes of orphaned build cache.

    line 125
  2. Distinctive:

    Use Docker Desktop in production server environments.

    line 130

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Docker Desktop

Docker Desktop provides a comprehensive GUI, integrated Kubernetes cluster, credential management, and development extensions for containerized software delivery.

When to Use

  • Local Containerized Development on macOS & Windows: Running Docker and Kubernetes with native OS filesystem optimizations.
  • VirtioFS & Rosetta 2 Virtualization (Apple Silicon): Fast cross-platform x86_64 emulation and high-speed disk sharing on macOS.
  • Single-Node Local Kubernetes: One-click local Kubernetes cluster for testing manifests and Helm charts.
  • Docker Extensions & Resource Allocation: Monitoring container CPU, memory, and disk usage visually.

Quick Start

# Check Docker Desktop daemon and engine version
docker version

# Test container runtime
docker run --rm hello-world

# Inspect allocated CPU, memory, and disk resources
docker info

Core Concepts

VirtioFS & Resource Tuning Configuration

Optimizing disk performance in settings.json:

{
  "cpus": 6,
  "memoryMiB": 12288,
  "swapMiB": 2048,
  "diskSizeMiB": 102400,
  "filesharingImplementation": "virtiofs",
  "useVirtualizationFramework": true,
  "useWindowsContainers": false,
  "kubernetes": {
    "enabled": true,
    "showSystemContainers": false
  }
}

Local Multi-Container Development Workflow

Orchestrating services with port publishing and health checks:

# Check Docker engine version and virtualization driver
docker version

# Inspect resource consumption across local containers
docker stats --no-stream

# Clean up build caches and dangling volumes to reclaim disk
docker system prune -a --volumes

Enabling Single-Node Kubernetes

Testing Kubernetes manifests locally:

# Switch kubectl context to Docker Desktop cluster
kubectl config use-context docker-desktop

# Verify local cluster nodes
kubectl get nodes

Common Patterns

Docker Compose Multi-Container Development Stack

Problem: Coordinating app, database, and cache containers locally with volume mounts.

Solution: Define unified docker-compose.yml:

version: "3.8"

services:
  app:
    build: .
    ports:
      - "3000:3000"
    environment:
      - DATABASE_URL=postgres://user:pass@db:5432/mydb
    volumes:
      - ./src:/app/src
    depends_on:
      - db

  db:
    image: postgres:16-alpine
    environment:
      POSTGRES_USER: user
      POSTGRES_PASSWORD: pass
      POSTGRES_DB: mydb
    ports:
      - "5432:5432"
    volumes:
      - pgdata:/var/lib/postgresql/data

volumes:
  pgdata:

Best Practices

Do:

  • Enable VirtioFS on macOS for up to 10x faster file-syncing in bind-mounted development directories.
  • Enable Rosetta 2 emulation on Apple Silicon to run x86_64 images with near-native performance.
  • Configure explicit memory and CPU limits in Docker Desktop settings to prevent starving host applications.
  • Run docker system prune --volumes periodically to reclaim gigabytes of orphaned build cache.

Don't:

  • Allocate 100% of host RAM to the Docker VM; leave at least 4GB-8GB for the host OS.
  • Use Docker Desktop in production server environments; deploy native Docker Engine or containerd on Linux.
  • Store persistent production data inside local Docker Desktop volumes.

Troubleshooting

ErrorCauseSolution
Docker Desktop failed to startCorrupted settings JSON or port conflict in virtualization service.Reset Docker to factory defaults in Troubleshoot menu.
Slow file synchronization on macOS/WindowsLegacy osxfs/gRPC FUSE file sharing slowing down volume mounts.Enable VirtioFS in Docker Desktop Settings > General / Virtualization.
No space left on deviceVirtual disk (Docker.raw) filled by dangling images and volumes.Run docker system prune -af --volumes or resize virtual disk in Settings.

References

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.