reference-submodules

Git submodules are managed by automatically pinning external context repositories to the specific version tags matching your project dependencies. This ensures your local documentation and reference material stay accurately tracked and available offline.

To add a reference submodule, ask the agent to add a specific repository by providing the repository URL. The skill automatically handles adding, upgrading, and removing the submodule within the .claude/references/ directory.

Gh CLI is optional but required for private repository tag resolution. The skill needs git 2.13 or higher to operate, and uses gh CLI access to resolve version tags for private dependencies.

Automating submodule documentation is handled by maintaining a synchronized Dependency References table in your CLAUDE.md file. The table updates automatically whenever references are added, upgraded, or removed.

Shallow git submodules ensure offline availability for local documentation while maintaining version alignment with project dependencies. This approach minimizes repository size while keeping reference material accessible without network connectivity.

Yes, removing outdated git submodules is supported alongside adding and upgrading. The skill automatically updates the .gitmodules file and removes the corresponding entries from the Dependency References table in your project documentation.