Does it support automated synchronization after setup?

Yes, it configures GitHub Actions workflows in both the parent and child repositories to ensure that updates are automatically propagated across the architecture.

What happens if the setup process is interrupted?

The skill maintains a detailed state file (.submodule-setup-state.json) and creates a backup branch before starting, allowing you to resume exactly where you left off or rollback safely.

Can this skill migrate existing branch content into submodules?

Yes, it includes a dedicated migration phase that can extract content from specific source branches and move it into the newly created submodule repositories while maintaining history.

How does it handle GitHub authentication and security?

The skill provides a guided manual intervention protocol for creating Fine-Grained Personal Access Tokens (PATs) and then automates the deployment of these tokens to GitHub Secrets.

Is the repository creation process efficient?

The skill uses parallel execution rules for tasks without dependencies, such as creating multiple repositories or setting secrets, to minimize wait times.

Submodule Architecture Setup

Name: Submodule Architecture Setup
Author: bengous

bybengous

•

Deployment & DevOps

Automates the creation and synchronization of Git submodule architectures with integrated GitHub Actions for seamless multi-repo management.

About

This skill streamlines the complex process of transitioning from branch-based content management to a robust Git submodule architecture. It automates repository creation via the GitHub CLI, handles data migration from existing branches, configures secure authentication using Fine-Grained Personal Access Tokens (PATs), and deploys GitHub Actions workflows to ensure parent-child repository synchronization. By transforming content separation into always-present directories, it eliminates developer context-switching and provides a reliable, automated source of truth for multi-repository projects.

Key Features

One-click migration of content from existing branches to new submodules
Automated creation of multiple submodule repositories via GitHub CLI
Secure secret management and Fine-Grained PAT configuration guidance
2 GitHub stars
State-aware execution with built-in backup, validation, and resume capabilities
Integrated GitHub Actions setup for automated parent-child repo synchronization

Use Cases

Automating multi-repo synchronization workflows to reduce manual git maintenance for large teams
Converting a monolithic repository with distinct branch-based content into a clean submodule architecture
Setting up dedicated documentation or asset repositories that must stay synced with a main project

About

Key Features

One-click migration of content from existing branches to new submodules
Automated creation of multiple submodule repositories via GitHub CLI
Secure secret management and Fine-Grained PAT configuration guidance
2 GitHub stars
State-aware execution with built-in backup, validation, and resume capabilities
Integrated GitHub Actions setup for automated parent-child repo synchronization

Use Cases

Automating multi-repo synchronization workflows to reduce manual git maintenance for large teams
Converting a monolithic repository with distinct branch-based content into a clean submodule architecture
Setting up dedicated documentation or asset repositories that must stay synced with a main project