init-agents-config

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

SKILL.md

GitHub

Init Agents Config

Assemble .agents.yml from collected user answers during Skill("init").

Resources

Resource Purpose
CONFIG_VERSION Current .agents.yml schema version
assets/rails.yaml Rails config template
assets/python.yaml Python config template
assets/node.yaml Node config template
assets/generic.yaml Generic config template
references/agents-md-template.md AGENTS.md best practices
assets/local-config-template.yaml Local overrides template

Template Selection by Tech Stack

Tech Stack Template
Rails assets/rails.yaml
Python assets/python.yaml
Node assets/node.yaml
Generic assets/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

Task Tracking

Commented out by default (opt-in). Uncomment only if user explicitly enables task tracking:

  • task_tracking.enabled - Create Tasks during workflows for visibility
  • task_tracking.ledger - YAML checkpoints for crash recovery
  • task_tracking.ledger_path - Path to workflow ledger file
  • task_tracking.auto_cleanup - Remove tasks after workflow completion

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.