devcontainer-setup_skill

Overview

This skill creates Universal DevContainers optimized for AI agent workflows, bundling Claude Code, Snowflake CLI, Cortex Code, and dbt. It scaffolds the .devcontainer layout, copies ready-made templates, and prepares host mounts and config hints so containers work smoothly for data and model development. Use it to get a consistent, reproducible developer environment for agentic and data engineering tasks.

How this skill works

The skill scaffolds a .devcontainer directory and installs a feature pack that includes Snowflake and AI tooling. It copies devcontainer.json, a feature manifest, and an install script into the project, makes the scripts executable, and instructs the user to create host-side cache and config directories for seamless mounts. Finally, it provides common troubleshooting checks for permission and mount issues.

When to use it

• You need a reproducible containerized dev environment for AI agents or data engineering
• Setting up devcontainer.json or adding features like Snowflake CLI, Claude, or dbt
• Onboarding new contributors who require the same toolchain and mounts
• Preparing development for multi-language projects (Python, Node, Java, Rust)
• Resolving inconsistent local setups caused by missing host caches or config files

Best practices

• Create the .devcontainer/snowflake-ai-tools directory and copy templates before opening the container
• Run chmod +x on install scripts so the container build can execute them
• Create host directories (~/.m2, ~/.npm, ~/.cache/uv, ~/.cargo, ~/.snowflake, ~/.claude, ~/.cursor) to avoid mount failures
• Keep Snowflake CLI and Claude config files on the host (~/.snowflake/connections.toml and ~/.claude/) rather than in the container
• Set updateRemoteUserUID: true in devcontainer.json on Linux hosts to avoid UID mismatches

Example use cases

• Scaffold a devcontainer for a dbt + Snowflake analytics project that also needs Claude Code for local agent testing
• Provision a development environment for a multi-runtime repo (Python, Node, Java) that shares caches across containers
• Onboard a new team member with a single command to copy templates and create required host folders
• Fix permission and tool-install issues by re-running the included snowflake-ai-tools setup script