scaffold-compose

Adds templated service definitions to Docker Compose files with validation via docker-compose.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/semicolon-devteam/sax-infra --skill scaffold-compose
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: scaffold-compose
Source: https://github.com/semicolon-devteam/sax-infra/tree/main/skills/scaffold-compose
Command: npx skills add https://github.com/semicolon-devteam/sax-infra --skill scaffold-compose

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the creation and modification of Docker Compose service definitions, significantly reducing manual configuration errors and accelerating the integration of new services into your infrastructure.

Core Features & Use Cases

  • Templated Service Creation: Generate Docker Compose service blocks based on predefined templates for common service types like Next.js, Spring Boot, or Node.js microservices.
  • Environment Variable Integration: Automatically adds necessary image tag variables to .env.dev and .env.stg files, ensuring consistent versioning.
  • Automated Validation: Includes a final docker-compose config check to ensure the newly added service definition is syntactically correct.
  • Use Case: Quickly add a new ms-notification Node.js microservice to your core-compose repository, complete with health checks, logging volumes, and environment variable placeholders.

Quick Start

Add a new 'ms-notification' service of type 'node' to the Docker Compose file.

Frequently Asked Questions about scaffold-compose

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a new service to my Docker Compose file?

Add a new service to your Docker Compose file by defining a service block with image, environment, volumes, and health checks. This Skill automates that process using templated definitions for common service types like Node.js, Spring Boot, or Next.js, then validates the configuration with docker-compose config.

Can I automatically generate environment variable templates when adding Docker Compose services?

Yes. When you add a service, this Skill automatically creates and updates .env.dev and .env.stg files with the necessary image tag variables, ensuring consistent versioning across environments without manual edits.

What's the fastest way to scaffold a microservice in Docker Compose?

Use templated service creation to rapidly generate Docker Compose service blocks for microservices like Node.js or Spring Boot. The Skill enforces per-service templates, updates your docker-compose.yml, and validates syntax in a single operation, eliminating manual configuration errors.

How do I ensure a new Docker Compose service definition is valid?

This Skill validates the resulting service configuration by running docker-compose config automatically after adding the service. This catches syntax errors and misconfigurations before deployment.

Does this work with existing docker-compose.yml files?

Yes. This Skill modifies existing docker-compose.yml files by inserting new service definitions while preserving your current configuration, then validates the complete file to ensure compatibility.

What service types can I scaffold with Docker Compose templates?

This Skill provides predefined templates for common service types including Next.js frontends, Spring Boot applications, and Node.js microservices, each with appropriate health checks, logging volumes, and environment variable placeholders.