Gemini CLI reads a user folder and a project folder. The CLI writes the right one.
Gemini CLI looks in ~/.agents/skills for the skills a person always has, and in a project's .agents/skills for the ones a repository brings with it. Which one a skill belongs in is a decision, and it should be made once.
You make that decision on the first install — for you everywhere, or for this project — and the CLI remembers it. Re-running install keeps it current and removes anything you are no longer entitled to.
Everything else is the same as the other file-based clients. Entitlement by group, versions you pick rather than type, rollback by picking one from a list, and an audit entry for every fetch.
Gemini CLI is the client most likely to be running next to something else — a team on Vertex frequently has people in Cursor or Claude Code as well. One catalog covers all of them.
$ npm install -g skill-belt$ skill-belt install --client gemini-cli --scope project Gemini CLI → .agents/skills✓ 4 installed, 1 updated.- Delivery
- CLI writes to disk
- User path
- ~/.agents/skills
- Project path
- .agents/skills
- Credentials
- OS keychain
Known limits
What Gemini CLI does not give us.
Stated up front, because you will find these out on day two anyway.
- No marketplace protocol, so installing is a command rather than a browse.
- Two folders with different lifetimes, which is exactly the kind of thing people get wrong by hand.
- MCP servers and hooks are Claude Code only, for now.
FAQ
Gemini CLI, specifically.
Does this work on Vertex AI?
Yes. Skill Belt does not care which model endpoint you are pointed at — it distributes skills to the client on the machine.
Can one skill go to both folders?
It can — run install once with each --scope — but it usually should not. User scope for the things a person always needs, project scope for the things a repository brings with it.
Also delivers to
The price is on the page. That is the whole idea.
$99 a month for up to 50 people, cancelled from the billing page. If you've got a question first, ask it — a person answers.