Learn git by doing — with every command, why it matters, and how to undo it.
git-coach is a standalone set of Agent Skills for hands-on git learning. The human is the learner; the agent is the coach.
Every git action reveals the literal command, says why, and gives the undo — so the training wheels come off over time.
It is for the moments when you are mid-merge, mid-rebase, on the wrong branch, in detached HEAD, or just staring at git status thinking: what now?
No workflow opinions, no hidden automation, no external services. Just git literacy, transparency, and stuck-state recovery.
git-coach is skills-first. Install it with skills.sh in any agent that supports Agent Skills, or use the Claude Code plugin wrapper if Claude Code is your environment.
Every git action the coach takes shows the real command, a one-line why, and the undo:
$ git switch -c feature/login
✓ created branch feature/login and switched to it
↩ undo: git switch - && git branch -D feature/login
This is a convention enforced across the whole set — not a feature of one skill. The point isn't to run git for you (you and your agent can already do that); it's transparency (you see the real command every time) and recovery (when you're lost, one skill tells you the single best next move).
Each skill maps to a distinct learning mode.
| Skill | When you reach for it | What it does |
|---|---|---|
git-setup |
"teach me git" / "how do I start?" | Onboarding: assesses your level, checks your environment (git + Node.js), and routes you to the right skill. |
git-next |
"I'm lost / stuck / what now?" | Scans your git state, names the situation in plain language, and gives the single best next command plus its undo. Read-only, suggest-only. |
git-guide-me |
"do this and explain it" | Guides you through a real operation: classifies intent, shows the literal command before running, runs safe ops, hands destructive ones to you, then echoes the transparency block. |
git-explain |
"what is a rebase?" | Conceptual answers with no execution, grounded in git help and Pro Git. |
git-drill |
"let me practice" | Spins up a throwaway repo, manufactures a scenario (first commit, merge conflict, detached HEAD, wrong-branch commit), and coaches you through the fix. It can also scaffold new reusable scenario specs. Safe to fail, reset, retry. |
- Suggest, don't surprise. Destructive or history-rewriting ops (
reset --hard,clean,push --force,branch -D,rebase) are never run silently — shown, explained, and either confirmed explicitly or handed to you to run. - Live query, no stored state. Git state is read fresh each time; the reflog is the continuity store.
- Ground in the source. Explanations lean on
git help <cmd>and Pro Git, not memory.
git-coach is a standalone Agent Skills repo. The public GitHub repo is the home; every install channel points back to it.
With skills.sh — works in any agent that supports Agent Skills:
npx skills add smanaton/git-coach
As a Claude Code plugin — if Claude Code is your environment (the wrapper can also carry Claude-specific features like hooks):
/plugin marketplace add smanaton/git-coach
/plugin install git-coach@git-coach
Either way each skill is self-contained — its reference docs are bundled inside it.
Status: beta. The install commands above will work once the repo is pushed public to
github.com/smanaton/git-coach.
Most git helpers hide the command. git-coach does the opposite. The goal isn't to automate git away — you and your agent can already run git. The goal is to help you understand what state you're in, which command moves you forward, and how to recover if it was the wrong move.
git-coach isn't trying to make git disappear. It's trying to make git understandable while an agent helps you move forward.