massgen-config-creator

The MassGen Config Creator is an essential utility for developers and agents working within the MassGen ecosystem. Its primary purpose is to provide authoritative guidance on generating well-structured, validated YAML configuration files that adhere to established framework conventions. By following these standards, users ensure configuration consistency across the codebase, minimize common runtime errors, and optimize agent performance. This skill is intended for technical users, contributors, and automation agents who need to build reusable multi-agent workflows, define backend tool integrations, or prepare configs for research and case studies.

• Provides systematic guidance on property placement, including mandatory distinctions between backend-level settings like cwd or enable_web_search and orchestrator-level settings like context_paths and planning_mode.

• Enforces strict adherence to the authoritative writing_configs.rst documentation, which serves as the primary source of truth for all current conventions and schema requirements.

• Facilitates rapid prototyping by encouraging the reuse of patterns from existing stable configurations within massgen/configs/tools/ directories.

• Supports the creation of complex multi-agent setups, including identical system_message synchronization and specialized workspace isolation using separate directories.

• Assists in integrating diverse tools such as Filesystem, MCP, Web Search, and Code Execution environments by providing reliable structural templates.

• Always prioritize reading existing configuration files (e.g., in massgen/configs/basic/multi/) before initializing a new config to ensure compatibility with current naming patterns (agent_description_feature.yaml).

• Never invent new configuration properties; verify all keys against the YAML schema reference and official documentation to avoid failed validations.

• Leverage established patterns for agent backends (claude, openai, gemini) and ensure cost-effective model selection (e.g., gpt-5-mini, gemini-2.5-flash).

• Always conduct a post-creation validation test using the massgen CLI command with your new config to ensure the orchestration flow executes as expected.

• When building configs involving external resources, correctly categorize them into the appropriate directories such as filesystem, multimodal, or mcp for better organization and discovery.