skills.rest
moonklabs
moonklabsOFFICIAL
Explore all skills by this author →
WebsiteGitHub

git-submodule-manager

Coordinates Git worktrees and submodules for monorepo feature development.

Updated Mar 27, 2026
Search Tags:#automation#git#worktree#monorepo#branch-management#submodules
One-click install
npx skills add https://github.com/moonklabs/skills --skill git-submodule-manager
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: git-submodule-manager
Source: https://github.com/moonklabs/skills/tree/main/dev-workflow/skills/git-submodule-manager
Command: npx skills add https://github.com/moonklabs/skills --skill git-submodule-manager

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Coordinate Git worktrees and submodules for monorepos.

Core Features & Use Cases

  • Unified worktree creation, switching, and status across main repo and submodules for feature development.
  • Unified commit and push workflow that updates submodule pointers in the main repository in a deterministic order.
  • Safe, interactive-by-default workflow with an optional --yes mode for non-interactive automation and straightforward integration into Claude Code.

Quick Start

Use the create operation to spin up a new feature worktree with synchronized submodule branches.

Frequently Asked Questions about git-submodule-manager

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

FAQPage Schema
How do I synchronize Git submodule branches when creating a worktree for feature development?▼

You synchronize Git submodule branches during worktree creation by applying a defined submodule mapping, ensuring the main repository and all submodules share aligned feature branches automatically.

What is the best way to commit and push changes across a monorepo with multiple Git submodules?▼

Committing and pushing across a monorepo with submodules is done via a unified workflow that updates submodule pointers in the main repository in a deterministic order during batch operations.

Can I automate Git worktree and submodule management for non-interactive pipelines?▼

Yes, Git worktree and submodule management can be automated using an optional --yes mode designed for non-interactive automation and direct integration into automated pipelines.

Does Git worktree management work with existing submodule mappings?▼

Yes, Git worktree management works with existing submodule mappings by enforcing the defined structure during branch creation, switching, and status checks across the main repository and its submodules.

Why do my Git submodule pointers get out of sync when switching worktree branches?▼

Submodule pointers get out of sync when switching branches manually without a unified manager; coordinating worktrees and submodules together enforces synchronized branch switching and prevents this.

Related Skills

Explore More Software Engineering Skills→
codacy-open-source-projects-scanscodacy-open-source-projects-scans
1

create-worktree

Create a git worktree for a specified branch in the ClickHouse repository.

Official
Advanced
ippontechippontech
14

ship

Create or update a GitHub PR from local changes with conventional commits.

Official
Advanced
jackspacejackspace
16

multi-repository-orchestrator

Orchestrate synchronized branching and batch commits across multiple Git repositories.

Community
Advanced
MinhHoangDonoMinhHoangDono

ck:worktree

Create isolated git worktrees with prefixed branches for parallel development.

Community
Advanced