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

•

デプロイメントとDevOps

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

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.

主な機能

01One-click migration of content from existing branches to new submodules

02Automated creation of multiple submodule repositories via GitHub CLI

03Secure secret management and Fine-Grained PAT configuration guidance

042 GitHub stars

05State-aware execution with built-in backup, validation, and resume capabilities

06Integrated GitHub Actions setup for automated parent-child repo synchronization

ユースケース

01Automating multi-repo synchronization workflows to reduce manual git maintenance for large teams

02Converting a monolithic repository with distinct branch-based content into a clean submodule architecture

03Setting up dedicated documentation or asset repositories that must stay synced with a main project

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add bengous/claude-code-plugins submodule-setup

For use in Claude.ai and ChatGPT

Download Skill