submodule-ops

Automate coordinated submodule edits across multi-repo workspaces.

6|Updated Mar 11, 2026
One-click install
npx skills add https://github.com/open-hax/opencode-skills --skill submodule-ops
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: submodule-ops
Source: https://github.com/open-hax/opencode-skills/tree/main/.opencode/skills/submodule-ops
Command: npx skills add https://github.com/open-hax/opencode-skills --skill submodule-ops

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Make safe, consistent changes in a workspace that uses git submodules across orgs/** to keep submodule pointers and states aligned.

Core Features & Use Cases

  • Atomic, localized edits to submodules to avoid cross-repo drift.
  • Tools and guidance for syncing .gitmodules, updating submodule pointers, and validating status.
  • Use case: when modifying files under orgs/** or .gitmodules across multiple submodules, or when coordinating pointer updates across repos.

Quick Start

Identify the exact submodule path(s) impacted and perform the recommended submodule operations inside each path.

Frequently Asked Questions about submodule-ops

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

FAQPage Schema
How do I update git submodule pointers across multiple repos safely?

Atomic commits prevent cross-repo drift when updating git submodule pointers across multi-repo workspaces by enforcing strict locality of changes. Guardrails ensure edits remain isolated to the targeted submodule paths, keeping submodule states and pointers aligned.

What is the best way to sync .gitmodules across nested repositories?

The best way to sync .gitmodules across nested repositories is using automated syncing tools that validate status and apply localized edits. This ensures submodule pointers and configuration states remain aligned across the multi-repo workspace without unintended side effects.

Why does editing submodules cause cross-repo drift in multi-repo workspaces?

Editing submodules causes cross-repo drift in multi-repo workspaces when changes are not committed atomically. Without coordinated edits and strict locality guardrails, submodule pointers can become misaligned, leading to inconsistent repository states across the nested structure.

How do I perform atomic commits for multiple submodule edits?

Perform atomic commits for multiple submodule edits by identifying the exact impacted paths and executing coordinated operations within each. This process validates the workspace status and applies localized changes to keep nested repository pointers consistently aligned.

Can I use coordinated submodule edits for files under orgs directories?

Yes, you can use coordinated submodule edits for files under orgs directories. The process applies atomic operations to modify files across multiple submodules while enforcing strict guardrails to prevent cross-submodule edits and maintain workspace consistency.

When should I avoid automated submodule operations in a multi-repo workspace?

You should avoid automated submodule operations when changes need to cross submodule boundaries, as the guardrails enforce strict locality. If an edit requires modifying multiple submodules simultaneously without isolated paths, manual coordination may be necessary.