🎯

docker-desktop

🎯Skill
g1joshi/agent-skills2 Installs9Last Updated Feb 10, 2026

Installation

$npx skills add g1joshi/agent-skills --skill docker-desktop

Run it in a terminal; it asks which AI coding tools to install it for (Claude Code, Codex, Cursor and more).

Uses skills.sh Β· Node.js 22.20+

After installing

Ask for related work and the agent uses it on its own, or call it yourself.

Run it (Claude Code)/docker-desktop
Install by hand

Copy the whole skill folder from GitHub to the place below. Copying only SKILL.md can leave out files the skill uses.

Open the skill folder β†’
  • This project .claude/skills/docker-desktop/
  • All projects ~/.claude/skills/docker-desktop/

These paths are for Claude Code. For other tools, the command above puts it in the right place.

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

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

More from this repository10