init-agents-config

Generate .agents.yml config from user answers. Provides tech stack templates for Rails, Python, Node, and Generic projects.

⭐13stars🔀0forks📁View on GitHub🕐Updated Jan 3, 2026⬇️1downloads

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.
nameinit-agents-config
descriptionGenerate .agents.yml config from user answers. Provides tech stack templates for Rails, Python, Node, and Generic projects.
allowed-toolsRead, 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

  1. Read the appropriate template based on detected tech_stack
  2. Replace placeholders with collected answers:
    • {{config_version}} - Read from CONFIG_VERSION file
    • {{owner_level}} - beginner, intermediate, senior, expert
    • {{task_management}} - github, linear, beads, file, none
    • Stack-specific fields from user answers
  3. Conditionally include/exclude sections:
    • Remove extras: section if no Solid gems selected (Rails)
    • Remove toolbox.build_task.design_system_path if no design system detected
    • Comment out browser: section unless user selected non-Chrome browser
  4. 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 style
  • data-integrity-reviewer - Migration safety
  • codex-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_cache
  • solid_queue
  • solid_cable

Output

Write generated config to .agents.yml in project root.