setting-up-devcontainers

Generate devcontainer configurations for Claude Code development environments.

Features

Automatic mode detection: Detects marketplace.json and switches between Generic and Marketplace modes
Generic mode: Clean Claude Code + optional Codex CLI environment
Marketplace mode: Full plugin/skill setup with auto-sync capabilities

Installation

This skill is part of the marketplace-helper plugin. To use it:

Add the marketplace to Claude Code:

claude plugin marketplace add <marketplace-url>

Install the plugin:

claude plugin install marketplace-helper@<marketplace-name>

Enable the skill in your settings (or approve when prompted).

Usage

Generic Mode (no marketplace.json)

Ask Claude to set up a devcontainer for any project:

Set up a devcontainer for this project

The skill will:

Detect no marketplace.json exists
Ask about Codex CLI support
Generate .devcontainer/ files for Claude Code environment

Marketplace Mode (with marketplace.json)

Ask Claude to set up a devcontainer for your marketplace:

Set up a devcontainer for my marketplace

The skill will:

Read your .claude-plugin/marketplace.json
Discover all plugins and skills
Ask about Codex CLI and auto-sync preferences
Generate .devcontainer/ files with plugin configuration

Generated Files

Generic mode:

.devcontainer/
├── devcontainer.json
├── Dockerfile
└── post-create.sh

Marketplace mode (additional files):

.devcontainer/
├── devcontainer.json
├── Dockerfile
├── post-create.sh
├── reinstall-marketplace.sh
└── sync-codex-skills.sh      # (if Codex enabled)

File Structure

setting-up-devcontainers/
├── SKILL.md              # Main skill instructions
├── README.md             # This file (human documentation)
├── templates/            # File templates for generation
│   ├── devcontainer.json.template
│   ├── Dockerfile.template
│   ├── post-create.sh.template
│   ├── reinstall-marketplace.sh.template
│   └── sync-codex-skills.sh.template
├── references/           # Reference documentation
│   ├── devcontainer-spec.md
│   ├── claude-code-installation.md
│   └── codex-cli-installation.md
└── tests/
    └── scenarios.md      # Self-evaluation test scenarios

Templates

The templates/ directory contains template files with placeholders.

See SKILL.md for the complete placeholder reference including:

Common placeholders ({{PROJECT_NAME}}, {{CODEX_*}})
Marketplace-specific placeholders ({{ENABLED_PLUGINS}}, {{SETTINGS_BLOCK}})

Testing

The tests/scenarios.md file contains self-evaluation scenarios for testing this skill across different models (Sonnet, Opus, Haiku).

To run model evaluation:

/evaluating-skills-with-models setting-up-devcontainers

License

Apache-2.0