setup-repos

Generate .ralph-repos.yml configuration files for GitHub Projects V2 multi-repo projects.

2|Updated Jan 23, 2026
One-click install
npx skills add https://github.com/cdubiel08/ralph-hero --skill setup-repos
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: setup-repos
Source: https://github.com/cdubiel08/ralph-hero/tree/main/plugin/ralph-hero/skills/setup-repos
Command: npx skills add https://github.com/cdubiel08/ralph-hero --skill setup-repos

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill automates the creation of a .ralph-repos.yml file, which is essential for managing multiple repositories within your GitHub Projects V2 board. It helps configure how Ralph Hero interacts with your codebase.

Core Features & Use Cases

  • Automated Registry Generation: Discovers linked repositories, infers their domains and tech stacks, and generates a starter .ralph-repos.yml file.
  • Configuration Assistance: Guides you through setting per-repo defaults for labels, assignees, and estimates.
  • Decomposition Pattern Setup: Optionally helps define patterns for splitting features across multiple repositories.
  • Use Case: When setting up Ralph Hero for the first time on a new project with several microservices, use this skill to quickly generate the necessary repository configuration file.

Quick Start

Run the setup-repos skill to bootstrap your .ralph-repos.yml file.

Frequently Asked Questions about setup-repos

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

FAQPage Schema
How do I bootstrap a repository configuration file for managing multiple GitHub Projects V2 repositories?

To bootstrap a repository configuration file for GitHub Projects V2, automate the generation of a .ralph-repos.yml file. This process discovers linked repositories, infers domains and tech stacks, and outputs the necessary configuration to manage multi-repo projects.

What is the best way to automate multi-repo configuration discovery across linked GitHub repositories?

Automating multi-repo configuration discovery is best achieved by using GitHub API and CLI tools for repository introspection. This approach scans linked repositories to infer their domains and tech stacks, generating a starter configuration file automatically.

Can I configure per-repo defaults like labels and assignees when setting up my GitHub repository registry?

Yes, you can configure per-repo defaults like labels, assignees, and estimates during registry setup. The configuration process guides you through defining these settings to ensure your multi-repo project board is properly initialized.

Does the repository setup process support defining cross-repo decomposition patterns for microservices?

Yes, the repository setup process optionally supports defining cross-repo decomposition patterns. This helps you establish patterns for splitting features across multiple repositories, which is particularly useful for microservices architectures.

When do I need to generate a .ralph-repos.yml file for my GitHub Projects V2 board?

You need to generate a .ralph-repos.yml file when setting up a new multi-repo project within GitHub Projects V2 for the first time. It is essential for configuring how your codebase interacts with the project management board.