submodule-bump
Bumps submodule SHAs to latest branch heads within a parent repository.
Install
mkdir -p .claude/skills/submodule-bump && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/18238" && unzip -o skill.zip -d .claude/skills/submodule-bump && rm skill.zipInstalls to .claude/skills/submodule-bump
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Use when bumping one or all submodule SHAs in the allcodex-aio parent repo after work is merged to a submodule's dev branch. Invoke with a submodule name or "all".Key capabilities
- →Bump a single submodule's SHA to latest dev
- →Bump all submodules' SHAs to latest dev
- →Commit submodule updates in the parent repo
- →Push submodule updates to remote
- →Verify submodule status
How it works
The skill ensures the submodule's dev branch is current and pushed, then pulls the latest dev SHA into the parent repository, commits the change, and pushes it.
Inputs & outputs
When to use submodule-bump
- →Bump submodule version
- →Update all submodules
- →Synchronize submodule HEADs
About this skill
Submodule Bump
Bumps submodule refs in the parent repo to the latest dev HEAD. Always: submodule first, parent second.
Rule
Confirm the submodule's dev is pushed to remote before bumping parent. A bump pointing at an unpushed SHA will break anyone who clones.
Single Submodule
# 1. Ensure submodule dev is current and pushed
git -C <name> checkout dev
git -C <name> push
# 2. Pull latest dev SHA into parent
git submodule update --remote <name>
# 3. Commit
git add <name>
git commit -m "chore: bump <name> to latest dev"
git push
All Submodules
git submodule update --remote
git add allcodex-core allknower allcodex-portal docs/shared
git commit -m "chore: bump all submodules to latest dev"
git push
Submodule Reference
| Name | Path | Remote |
|---|---|---|
allcodex-core | allcodex-core/ | ThunderRonin/allcodex-core |
allknower | allknower/ | ThunderRonin/allknower |
allcodex-portal | allcodex-portal/ | ThunderRonin/allcodex-portal |
docs/shared | docs/shared/ | ThunderRonin/allcodex-docs |
Verification
git submodule status — no + prefix means all SHAs match what's checked out.
When not to use it
- →When the submodule's dev branch is not pushed to remote
- →When the goal is not to update submodule references in the parent repo
Limitations
- →Requires the submodule's dev branch to be pushed to remote before bumping
- →Limited to updating submodules in the allcodex-aio parent repo
- →Only updates to the latest `dev` HEAD
How it compares
This skill automates the process of updating submodule references in the parent repository to their latest dev HEADs, ensuring consistency across linked repositories, unlike manual git commands.
Compared to similar skills
submodule-bump side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| submodule-bump (this skill) | 0 | 3mo | Review | Beginner |
| resolve-conflicts | 81 | 8mo | Review | Intermediate |
| openspec-onboard | 10 | 5mo | Review | Beginner |
| codex-cli-bridge | 9 | 9mo | Review | Intermediate |
Try saying
Example prompts that trigger this skill in your AI assistant.
You might also like
resolve-conflicts
antinomyhq
Use this skill immediately when the user mentions merge conflicts that need to be resolved. Do not attempt to resolve conflicts directly - invoke this skill first. This skill specializes in providing a structured framework for merging imports, tests, lock files (regeneration), configuration files, and handling deleted-but-modified files with backup and analysis.
openspec-onboard
studyzy
Guided onboarding for OpenSpec - walk through a complete workflow cycle with narration and real codebase work.
codex-cli-bridge
alirezarezvani
Bridge between Claude Code and OpenAI Codex CLI - generates AGENTS.md from CLAUDE.md, provides Codex CLI execution helpers, and enables seamless interoperability between both tools
skill-sync
KyleKing
Syncs Claude Skills with other AI coding tools like Cursor, Copilot, and Codeium by creating cross-references and shared knowledge bases. Invoke when user wants to leverage skills across multiple tools or create unified AI context.
github-workflow-automation
ruvnet
Advanced GitHub Actions workflow automation with AI swarm coordination, intelligent CI/CD pipelines, and comprehensive repository management
git-advanced-workflows
wshobson
Master advanced Git workflows including rebasing, cherry-picking, bisect, worktrees, and reflog to maintain clean history and recover from any situation. Use when managing complex Git histories, collaborating on feature branches, or troubleshooting repository issues.