Devcontainer

This is a diagnostic framework for fixing slow or broken devcontainer setups. It walks through six states from no containerization to validated environments, with specific interventions for each problem: slow startups get Dockerfile caching advice, configuration errors get compatibility checklists, and multi-service setups get compose templates. The core insight is that every choice affects startup time and team onboarding, so it forces you to make those tradeoffs explicit. Includes analyzer scripts and templates for common patterns. Use this when your container takes five minutes to start or works locally but breaks in Codespaces. Skip it if you're writing application code or dealing with production deployments.

skills.sh installs: 327
GitHub stars: 182
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add jwynia/agent-skills --skill devcontainer --agent claude-code

Installs into .claude/skills of the current project.

Files

Devcontainer Diagnostic

Diagnose devcontainer and Docker development environment problems. Help create reproducible, fast-starting development environments that work consistently across VS Code, GitHub Codespaces, and team members.

When to Use This Skill

Use this skill when:

Setting up a new devcontainer
Container startup is too slow
Configuration errors or conflicts
Different behavior in VS Code vs Codespaces
Multi-service development environment needed

Do NOT use this skill when:

Writing application code
Deploying to production
Configuring CI/CD pipelines

Core Principle

Development containers should provide instant productivity. Every configuration choice affects startup time, reproducibility, and team onboarding. Make these trade-offs explicit.