Claude Skill

colima

Use when Docker commands fail with "Cannot connect to Docker daemon", when starting/stopping container environments on macOS, when managing Docker contexts or profiles, or when running incus (system containers / VMs with nested virtualization) on macOS - provides Colima lifecycle

LLM Mart · 0 points · 1 views 0 listing impressions 0 install-command copies
Download technicalpickles-pickled-claude-plugins-plugins_dev-tools_skills_colima-8d13327.zip · 20 KB

Install

skills CLI npx skills add https://github.com/technicalpickles/pickled-claude-plugins/tree/main/plugins/dev-tools/skills/colima
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install technicalpickles-pickled-claude-plugins@llmmart
Git git clone https://github.com/technicalpickles/pickled-claude-plugins.git

The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole technicalpickles/pickled-claude-plugins collection as a plugin from our marketplace. Git is the plain clone.

README

Working with Colima Skill

A Claude Code skill for working with Colima, a container runtime for macOS.

When This Skill Activates

  • Docker commands fail with "Cannot connect to Docker daemon"
  • Starting/stopping container environments on macOS
  • Managing multiple Docker profiles/contexts
  • Troubleshooting container environment issues
  • SSH agent forwarding for Docker builds

Structure

working-with-colima/
├── SKILL.md                     # Entry point (~80 lines)
├── README.md                    # This file
├── docs/
│   └── test-cases.md            # RED/GREEN test validation
└── references/
    ├── docker-contexts.md       # Context switching, DOCKER_HOST
    ├── profile-management.md    # Creating, configuring profiles
    ├── troubleshooting.md       # Common issues and solutions
    ├── common-options.md        # CLI flags, VM configuration
    └── colima-upstream/         # Official Colima docs
        ├── README.md
        ├── FAQ.md
        └── INSTALL.md

Design

Uses progressive disclosure:

  • SKILL.md is a compact navigation map with quick reference
  • Detailed content lives in references/ for when deeper knowledge is needed
  • Upstream docs included locally for comprehensive reference

Testing

See docs/test-cases.md for RED/GREEN validation scenarios used during development.

Key finding: Without this skill, agents default to Docker Desktop troubleshooting. With this skill, agents correctly use Colima-specific diagnostics (colima status, Docker contexts, correct socket paths).

Updating Upstream Docs

To refresh the upstream Colima documentation:

uvx gitingest https://github.com/abiosoft/colima -i "*.md" -o /tmp/colima-docs.txt
# Then manually update files in references/colima-upstream/

Skill manifest

Colima

Overview

Colima provides container and VM runtimes (Docker, Containerd, Incus) on macOS with minimal setup. It runs a Linux VM and exposes the chosen runtime to the host.

Use this skill when:

  • Docker commands fail ("Cannot connect to Docker daemon")
  • Starting/stopping container runtime on macOS
  • Managing multiple Docker profiles/contexts
  • Troubleshooting container environment issues
  • Need SSH agent forwarding for Docker builds
  • Running incus on macOS (system containers or VMs with nested virtualization)

Not for: Docker Compose or Kubernetes clusters.

Quick Reference

Operation Command
Start colima start or colima start <profile>
Start with SSH agent colima start <profile> -s
Stop colima stop or colima stop --force
Status colima status -p <profile>
List profiles colima list
SSH into VM colima ssh or colima ssh -- <cmd>
SSH with chained commands colima ssh -- bash -c "cmd1 && cmd2"
Get socket path colima status -p <profile> --json \| jq -r .docker_socket

Docker Context Basics

Colima creates Docker contexts per profile:

  • Profile default → context colima
  • Profile work → context colima-work
# Switch context (global - affects all terminals)
docker context use colima-work

# Override per-session
export DOCKER_CONTEXT=colima-work

# Override per-command
docker --context colima-work ps

For details, see references/docker-contexts.md.

Common Issues

Docker daemon not connecting?

  1. colima status - is it running?
  2. docker context list - right context selected?
  3. See references/troubleshooting.md for more

Need more VM resources?

colima stop && colima start --cpu 4 --memory 8

"Broken" status after restart?

colima stop --force && colima start

References

  • references/ssh-commands.md - SSH command syntax, chaining, escaping
  • references/docker-contexts.md - Context switching, DOCKER_HOST, socket paths
  • references/profile-management.md - Creating, configuring, deleting profiles
  • references/troubleshooting.md - Common issues and solutions
  • references/common-options.md - Flags, VM types, resource configuration
  • references/incus-runtime.md - Running incus (containers + VMs with nested virt) on Apple Silicon

Upstream Documentation

Local copies of official Colima docs (from github.com/abiosoft/colima):

  • references/colima-upstream/README.md - Official README with features and usage
  • references/colima-upstream/FAQ.md - Official FAQ and troubleshooting
  • references/colima-upstream/INSTALL.md - Installation options
Files (pickled-claude-plugins)
  • docs
    • finding-test-sessions.md 2.5 KB
      Loading…
    • test-cases.md 2.3 KB
      Loading…
  • references
    • colima-upstream
      • FAQ.md 15.3 KB
        Loading…
      • INSTALL.md 973 B
        Loading…
      • README.md 5.9 KB
        Loading…
    • common-options.md 1.9 KB
      Loading…
    • docker-contexts.md 1.8 KB
      Loading…
    • incus-runtime.md 5.4 KB
      Loading…
    • profile-management.md 1.8 KB
      Loading…
    • ssh-commands.md 1.9 KB
      Loading…
    • troubleshooting.md 2.9 KB
      Loading…
  • README.md 1.9 KB
    # Working with Colima Skill
    
    A Claude Code skill for working with [Colima](https://github.com/abiosoft/colima), a container runtime for macOS.
    
    ## When This Skill Activates
    
    - Docker commands fail with "Cannot connect to Docker daemon"
    - Starting/stopping container environments on macOS
    - Managing multiple Docker profiles/contexts
    - Troubleshooting container environment issues
    - SSH agent forwarding for Docker builds
    
    ## Structure
    
    ```
    working-with-colima/
    ├── SKILL.md                     # Entry point (~80 lines)
    ├── README.md                    # This file
    ├── docs/
    │   └── test-cases.md            # RED/GREEN test validation
    └── references/
        ├── docker-contexts.md       # Context switching, DOCKER_HOST
        ├── profile-management.md    # Creating, configuring profiles
        ├── troubleshooting.md       # Common issues and solutions
        ├── common-options.md        # CLI flags, VM configuration
        └── colima-upstream/         # Official Colima docs
            ├── README.md
            ├── FAQ.md
            └── INSTALL.md
    ```
    
    ## Design
    
    Uses **progressive disclosure**:
    - `SKILL.md` is a compact navigation map with quick reference
    - Detailed content lives in `references/` for when deeper knowledge is needed
    - Upstream docs included locally for comprehensive reference
    
    ## Testing
    
    See `docs/test-cases.md` for RED/GREEN validation scenarios used during development.
    
    Key finding: Without this skill, agents default to Docker Desktop troubleshooting. With this skill, agents correctly use Colima-specific diagnostics (`colima status`, Docker contexts, correct socket paths).
    
    ## Updating Upstream Docs
    
    To refresh the upstream Colima documentation:
    
    ```bash
    uvx gitingest https://github.com/abiosoft/colima -i "*.md" -o /tmp/colima-docs.txt
    # Then manually update files in references/colima-upstream/
    ```
    
  • SKILL.md 3 KB
    ---
    name: colima
    description: Use when Docker commands fail with "Cannot connect to Docker daemon", when starting/stopping container environments on macOS, when managing Docker contexts or profiles, or when running incus (system containers / VMs with nested virtualization) on macOS - provides Colima lifecycle management, profile handling, SSH commands, and troubleshooting
    ---
    
    # Colima
    
    ## Overview
    
    Colima provides container and VM runtimes (Docker, Containerd, Incus) on macOS with minimal setup. It runs a Linux VM and exposes the chosen runtime to the host.
    
    **Use this skill when:**
    - Docker commands fail ("Cannot connect to Docker daemon")
    - Starting/stopping container runtime on macOS
    - Managing multiple Docker profiles/contexts
    - Troubleshooting container environment issues
    - Need SSH agent forwarding for Docker builds
    - Running incus on macOS (system containers or VMs with nested virtualization)
    
    **Not for:** Docker Compose or Kubernetes clusters.
    
    ## Quick Reference
    
    | Operation | Command |
    |-----------|---------|
    | Start | `colima start` or `colima start <profile>` |
    | Start with SSH agent | `colima start <profile> -s` |
    | Stop | `colima stop` or `colima stop --force` |
    | Status | `colima status -p <profile>` |
    | List profiles | `colima list` |
    | SSH into VM | `colima ssh` or `colima ssh -- <cmd>` |
    | SSH with chained commands | `colima ssh -- bash -c "cmd1 && cmd2"` |
    | Get socket path | `colima status -p <profile> --json \| jq -r .docker_socket` |
    
    ## Docker Context Basics
    
    Colima creates Docker contexts per profile:
    - Profile `default` → context `colima`
    - Profile `work` → context `colima-work`
    
    ```bash
    # Switch context (global - affects all terminals)
    docker context use colima-work
    
    # Override per-session
    export DOCKER_CONTEXT=colima-work
    
    # Override per-command
    docker --context colima-work ps
    ```
    
    For details, see `references/docker-contexts.md`.
    
    ## Common Issues
    
    **Docker daemon not connecting?**
    1. `colima status` - is it running?
    2. `docker context list` - right context selected?
    3. See `references/troubleshooting.md` for more
    
    **Need more VM resources?**
    ```bash
    colima stop && colima start --cpu 4 --memory 8
    ```
    
    **"Broken" status after restart?**
    ```bash
    colima stop --force && colima start
    ```
    
    ## References
    
    - `references/ssh-commands.md` - SSH command syntax, chaining, escaping
    - `references/docker-contexts.md` - Context switching, DOCKER_HOST, socket paths
    - `references/profile-management.md` - Creating, configuring, deleting profiles
    - `references/troubleshooting.md` - Common issues and solutions
    - `references/common-options.md` - Flags, VM types, resource configuration
    - `references/incus-runtime.md` - Running incus (containers + VMs with nested virt) on Apple Silicon
    
    ## Upstream Documentation
    
    Local copies of official Colima docs (from [github.com/abiosoft/colima](https://github.com/abiosoft/colima)):
    
    - `references/colima-upstream/README.md` - Official README with features and usage
    - `references/colima-upstream/FAQ.md` - Official FAQ and troubleshooting
    - `references/colima-upstream/INSTALL.md` - Installation options
    

Comments (0)

Sign in to join the conversation.

No comments yet.

Reviews (0)

No reviews yet.