git-submodules-ignore
Installation
SKILL.md
Ignore Submodules
Directive
Do NOT edit, modify, create, or delete any files inside Git submodules. This applies to all current and future submodules in this repository, as defined in .gitmodules.
Before any write operation
- Check
.gitmodulesat the repo root to get the current list of submodule paths. - Check whether the target path falls under one of those submodule paths. If it does, treat it as read-only.
- If uncertain whether a path is inside a submodule (e.g. nested or ambiguous paths), run
git submodule statusto confirm before writing.
Rules
- Read/inspect freely: viewing, searching, or reading files inside a submodule for reference or context is always fine.
- Never write inside a submodule: no edits, creations, deletions, renames, or shell commands that modify files under a submodule path — this includes tools like
replace_file_content,multi_replace_file_content,write_to_file, and shell commands such asrm,mv,sed -i,git apply, etc. - Scope all modifications to the root repository (
orbit) only. - If a task requires a change inside a submodule: stop, do not make the edit, and tell the user which submodule and file(s) need the change so they can make it directly in that submodule's own codebase (its own repo/remote).