cursor-skills-submodules

Cursor Skills as Git Submodules

Version: 1.0
Date: March 3, 2026
Owner: AI Team

---

1. Purpose

External Cursor/Codex agent skills (e.g. visual-explainer) are included in this repo as git submodules under .cursor/skills/. This keeps skills versioned with the repo and allows the team to pull upstream updates in one place.

---

2. Current Skills (Submodules)

Path	Repo	Purpose
.cursor/skills/visual-explainer	nicobailon/visual-explainer	Rich HTML pages for diagrams, diff reviews, plan audits, data tables, slide decks

---

3. Clone Repo With Skills

When cloning the platform repo for the first time, init submodules in one step:

git clone --recurse-submodules https://github.com/brainforge-ai/brainforge-platform.git
cd brainforge-platform

If you already cloned without submodules:

git submodule update --init --recursive

---

4. Update Skills to Latest Upstream

To pull the latest changes for all skill submodules:

git submodule update --remote --merge

To update only one skill (e.g. visual-explainer):

git submodule update --remote --merge .cursor/skills/visual-explainer

Then commit the updated submodule reference if you want to pin the new version:

git add .cursor/skills/visual-explainer
git commit -m "chore: update visual-explainer skill"

---

5. Adding a New Skill as a Submodule

1. From repo root:

   git submodule add https://github.com/owner/repo-name.git .cursor/skills/repo-name

2. Commit .gitmodules and the new path:

   git add .gitmodules .cursor/skills/repo-name
   git commit -m "chore: add repo-name as Cursor skill submodule"

3. Document the new skill in this file (table in Section 2).

---

6. References

• visual-explainer README — install options for Pi/Claude; we use submodule for Cursor.
• Git submodules — official docs.

---

7. Version History

• v1.0 (2026-03-03) — Initial doc; visual-explainer added as submodule.