Defame1297
2c6ce438b6
Two bundled fixes across the same nine skills, since both touch the same files. Issue #113: skill prose used rtk git and bare git inconsistently for the same operations, with no stated rule for which applied where. Executable instructed commands (a dispatch-table "Run" cell, a fenced code-block procedure, an imperative step) now consistently use rtk git; illustrative or referential mentions -- naming a flag's behavior, quoting a doc heading, warning against an anti-pattern -- stay bare git. Documented in the new plugins/git/README.md, scoped to this plugin only: gitea-* skills talk to the server over MCP tools and carry no git/rtk mentions at all. Also the git-plugin slice of #127: metadata.version added to the eight skills that lacked it. git-commits already had one and is untouched. Fixes: #113 Fixes: #127 Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01EeH8SCbcrCAQrtymkNuhKP
git-submodules
Add, initialize, update, pin, inspect, and remove git submodules in multi-repository projects.
What it does
This skill handles submodule operations within the git workflow suite: cloning a superproject with
its nested repositories, adding a dependency as a submodule, initializing and updating with
pinning or branch tracking, parallel and recursive traversal, rebinding URLs and tracked branches,
and the full removal sequence including the .git/modules/ cleanup git leaves behind. It returns
structured results suitable for agent composition.
It sits alongside the other git skills rather than duplicating them: git-worktrees covers
multiple checkouts of a single repository, and git-remotes covers the superproject's own remotes.
Usage
/git-submodules
Describe the submodule task. The skill applies the shared working rules, dispatches to the
reference for that task, and returns structured results (operation, status, per-submodule details,
conflicts, and a recovery next_step when applicable).
Files
| File | Purpose |
|---|---|
SKILL.md |
Skill instructions for agents — gotchas, shared working rules, and the task dispatch table |
references/README.md |
Describes contents of references/ |
references/setup-and-update.md |
Loaded when cloning a superproject, adding a submodule, initializing, updating, or re-pinning one, or running a command across all of them — includes the full add and update flag tables, the pinning workflows, and the foreach shell-variable table |
references/urls-and-config.md |
Loaded when changing where a submodule points or how it is configured — .gitmodules vs .git/config anatomy, both key tables, sync/set-url/set-branch, local mirror overrides, relative URLs, the custom-update security gate, and absorbgitdirs |
references/removal.md |
Loaded when removing or deinitializing a submodule — why deinit is not removal, and the four-step removal sequence |
references/sources.md |
Research sources and provenance |