Skills

simply gemini skills deregister

Stop scanning a registered skill source.

Flags

• -i, --id <value> — Id the source was registered under. (required)

Global

• --json — the raw API payload, for scripts and agents.

Removes the source from ~/.gemini/skills-registry.json. Its skills stop appearing as available to install. Skills already installed from it stay installed — uninstall them first if you want them gone, because a linked skill keeps reading from the source directory. Naming an id that is not registered is an error.

Examples

simply gemini skills deregister --id my-team

simply gemini skills install

Install skills from your registered skill sources.

Flags

• -s, --skill <value> — Name of a skill to install. Repeat the flag for more than one. (repeatable)

Runs gemini skills link for each skill, so Gemini reads it from its source directory rather than from a copy: a git pull in the source updates the installed skill. The Gemini CLI must be on your PATH.

With no —skill, lists every skill that is not yet installed, grouped by category, and asks which to install. Naming a skill that is already installed is not an error; it is reported and skipped. Naming one no registered source provides fails before anything is installed.

Examples

Pick from a list of every skill not yet installed:

simply gemini skills install

Install two skills without being asked:

simply gemini skills install --skill apex-test-generator --skill lwc-reviewer

simply gemini skills list

List skills from your registered sources, and what is installed.

Flags

• --installed — List only installed skills.
• --available — List only skills that are not yet installed.

Global

• --json — the raw API payload, for scripts and agents.

Shows every skill the registered sources provide, and every skill installed under ~/.gemini/skills — including one installed some other way, which is listed with no source. When two sources provide a skill with the same name, the source registered first wins, because Gemini installs a skill under its name and can hold only one of them.

Examples

simply gemini skills list

simply gemini skills list --available

simply gemini skills list --installed --json

simply gemini skills register

Register a directory of skills as a skill source.

Flags

• -i, --id <value> — Unique id for the source. Used to deregister it, and shown as SOURCE in list. (required)
• -p, --path <value> — Directory holding the skills. A relative path is resolved against the current directory. (required)
• -d, --description <value> — Short description of the source.
• --install-defaults — Install the skills the source lists as defaults.

Global

• --json — the raw API payload, for scripts and agents.

A skill source is any directory whose subdirectories hold a SKILL.md, either directly (source/my-skill/SKILL.md) or one level down in a category folder (source/apex/my-skill/SKILL.md). Once registered, its skills appear in list and can be installed with install.

Sources are recorded in ~/.gemini/skills-registry.json, the same file the Salesforce sf gemini skills plugin uses, so a source registered with either tool is visible to both. Registering an id or a directory that is already registered replaces the earlier entry.

A source can list skills everyone should have in a gemini-source.json at its root ({“defaults”: [“skill-name”, …]}). Those are installed straight after registering, which needs the Gemini CLI on your PATH; without it they are left uninstalled with a warning. Pass —no-install-defaults to skip them.

Examples

simply gemini skills register --id my-team --path ./skills

simply gemini skills register --id @my-org/gemini-skills --path ~/src/gemini-skills --description "Shared team skills"

Register a source without installing the skills it lists as defaults:

simply gemini skills register --id my-team --path ./skills --no-install-defaults

simply gemini skills uninstall

Uninstall Gemini skills.

Flags

• -s, --skill <value> — Name of a skill to uninstall. Repeat the flag for more than one. (repeatable)

Runs gemini skills uninstall for each skill. The Gemini CLI must be on your PATH.

Any skill under ~/.gemini/skills can be uninstalled, including one no registered source provides. With no —skill, lists every installed skill and asks which to remove. Naming a skill a registered source provides but that is not installed is reported and skipped; naming one that is neither installed nor available fails before anything is removed.

Examples

Pick from a list of every installed skill:

simply gemini skills uninstall

Uninstall one skill without being asked:

simply gemini skills uninstall --skill apex-test-generator