init-agents-config
Generate .agents.yml config from user answers. Provides tech stack templates for Rails, Python, Node, and Generic projects.
When & Why to Use This Skill
The init-agents-config skill automates the generation of `.agents.yml` configuration files, serving as a powerful initialization utility for agentic workflows. It streamlines project setup by providing optimized templates for popular tech stacks like Rails, Python, and Node.js, ensuring that agents are correctly configured with the right tools, reviewers, and environment settings from the start.
Use Cases
- Project Initialization: Automatically generate a standardized .agents.yml file when starting a new repository to ensure immediate compatibility with agentic tools.
- Tech Stack Customization: Tailor agent configurations to specific frameworks, such as enabling 'dhh-code-reviewer' for Rails projects or configuring data integrity checks for Python environments.
- Workflow Standardization: Define consistent task management (GitHub, Linear, etc.) and quality gate reviewers across multiple projects to maintain high engineering standards.
- Environment Configuration: Easily toggle advanced settings like browser preferences (Brave/Edge) or specific library integrations (Solid gems) through a guided setup process.
| name | init-agents-config |
|---|---|
| description | Generate .agents.yml config from user answers. Provides tech stack templates for Rails, Python, Node, and Generic projects. |
| allowed-tools | Read, Write |
Init Agents Config
Assemble .agents.yml from collected user answers during /majestic:init.
Resources
| Resource | Purpose |
|---|---|
CONFIG_VERSION |
Current .agents.yml schema version |
resources/rails.yaml |
Rails config template |
resources/python.yaml |
Python config template |
resources/node.yaml |
Node config template |
resources/generic.yaml |
Generic config template |
resources/agents-md-template.md |
AGENTS.md best practices |
resources/local-config-template.yaml |
Local overrides template |
Template Selection by Tech Stack
| Tech Stack | Template |
|---|---|
| Rails | resources/rails.yaml |
| Python | resources/python.yaml |
| Node | resources/node.yaml |
| Generic | resources/generic.yaml |
Assembly Instructions
- Read the appropriate template based on detected
tech_stack - Replace placeholders with collected answers:
{{config_version}}- Read fromCONFIG_VERSIONfile{{owner_level}}- beginner, intermediate, senior, expert{{task_management}}- github, linear, beads, file, none- Stack-specific fields from user answers
- Conditionally include/exclude sections:
- Remove
extras:section if no Solid gems selected (Rails) - Remove
toolbox.build_task.design_system_pathif no design system detected - Comment out
browser:section unless user selected non-Chrome browser
- Remove
- Write to
.agents.yml
Conditional Sections
Quality Gate Reviewers
Each stack has default reviewers. Include optional reviewers only if user enables them:
dhh-code-reviewer- Rails strict styledata-integrity-reviewer- Migration safetycodex-reviewer/gemini-reviewer- External LLM
Browser Config
Default is commented out (uses Chrome). Uncomment only if user selects Brave or Edge.
Extras (Rails only)
Include only Solid gems the user selected:
solid_cachesolid_queuesolid_cable
Output
Write generated config to .agents.yml in project root.