Agent skill · software engineering · thebushidocollective
act-docker-setup
Use when configuring Docker environments for act, selecting runner images, managing container resources, or troubleshooting Docker-related issues with local GitHub Actions testing.
Why this skill is useful
Provides specific commands and configurations for optimizing Docker environments tailored for act, which the AI wouldn't reliably generate on its own.
What it needs
Requires docker installed locally. About 5k tokens when loaded. Last updated 2026-07-19. 187 stars on the source repository.
What this skill does
Act - Docker Configuration and Setup Use this skill when configuring Docker for act, choosing runner images, managing container resources, and optimizing Docker performance for local GitHub Actions workflow testing. Runner Images Image Size Categories Act supports three image size categories: Size Image Tools Use Case ------ ------- ------- ---------- Micro node:16-buster-slim Minimal Simple Node.js workflows Medium catthehacker/ubuntu:act- Common tools Most workflows Large catthehacker/ubuntu:full- Everything Maximum compatibility Official catthehacker Images Language-Specific Images Platform Configuration .actrc Configuration Create .actrc in project root for persistent settings: Per-Workflow Configuration Create .github/workflows/.actrc for workflow-specific settings: Command Line Override Container Management Reusing Containers Container Lifecycle Inspect Containers Volume Mounts and Binds Default Mounts Act automatically mounts: Current directory → /github/workspace Act cache → /root/.cache/act Docker socket (if needed) Custom Bind Mounts Persistent Cache Docker Configuration Docker Socket Container Architecture Network Configuration Resource Management Memory Limits CPU Limits Disk Space Security Capabilities Privileged Mode Multi-Platform Builds Docker Buildx Test with act: Troubleshooting Image Pull Failures Permission Issues DNS Issues Container Exit Codes Performance Optimization Image Selection Choose the smallest image that meets your needs: Layer Caching Parallel Jobs Custom Images Building Custom Image Create Dockerfile: Build and use: Publishing Custom Image Best Practices DO ✅ Use .actrc for consistent configuration across team ✅ Choose appropriate image size for your needs ✅ Use --reuse during development ✅ Clean up Docker resources regularly ✅ Pin image versions in production workflows ✅ Use layer caching for faster builds ✅ Document image requirements in README DON'T ❌ Use :latest tags in production ❌ Run containers in privileged mode unnecessaril …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills thebushidocollective/act-docker-setup