mirror of
https://github.com/google-gemini/gemini-cli.git
synced 2026-05-03 00:14:28 -07:00
Jenna Inouye
778da08ee1
Co-authored-by: Sam Roberts <158088236+g-samroberts@users.noreply.github.com> Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
90 lines
3.0 KiB
Markdown
90 lines
3.0 KiB
Markdown
# Managing Agent Skills
|
|
|
|
Agent Skills provide Gemini CLI with specialized expertise on demand. This guide
|
|
covers advanced management techniques, including using slash commands, terminal
|
|
utilities, and understanding discovery tiers.
|
|
|
|
## Discovery tiers
|
|
|
|
Gemini CLI discovers skills from several locations, following a specific order
|
|
of precedence (lowest to highest):
|
|
|
|
1. **Built-in Skills**: Included with Gemini CLI and always available.
|
|
2. **Extension Skills**: Bundled within [extensions](../extensions/index.md).
|
|
3. **User Skills**: Located in `~/.gemini/skills/` or the `~/.agents/skills/`
|
|
alias. These are available across all your projects.
|
|
4. **Workspace Skills**: Located in `.gemini/skills/` or the `.agents/skills/`
|
|
alias within your current directory. These are project-specific.
|
|
|
|
> **Tip:** If multiple skills share the same name, the version from the
|
|
> higher-precedence location is used.
|
|
|
|
## In-session management
|
|
|
|
Use the `/skills` slash command during an interactive session to manage your
|
|
available expertise.
|
|
|
|
- **List skills**: `/skills list` (shows discovered skills).
|
|
- Use `/skills list all` to include internal built-in skills.
|
|
- Use `/skills list nodesc` to hide descriptions.
|
|
- **Reload skills**: `/skills reload` (or `/skills refresh`) to scan for new or
|
|
modified skills without restarting the CLI.
|
|
- **Toggle status**:
|
|
- `/skills disable <name>`: Prevents a skill from being triggered.
|
|
- `/skills enable <name>`: Re-enables a disabled skill.
|
|
- **Link local skills**: `/skills link <path> [--scope user|workspace]` to
|
|
immediately use a skill you are developing.
|
|
|
|
## Terminal utilities
|
|
|
|
The `gemini skills` command provides management utilities directly from your
|
|
system shell.
|
|
|
|
### Install a skill
|
|
|
|
To install a skill from a remote repository or a local `.skill` package:
|
|
|
|
```bash
|
|
gemini skills install https://github.com/user/my-awesome-skill
|
|
```
|
|
|
|
By default, this installs to your **user profile**. Use `--scope workspace` to
|
|
install it only for the current project.
|
|
|
|
### Link for development
|
|
|
|
If you are developing a skill, use the `link` command to create a reference to
|
|
your local directory:
|
|
|
|
```bash
|
|
gemini skills link ./path/to/my-skill
|
|
```
|
|
|
|
### Uninstall a skill
|
|
|
|
To completely remove an installed or linked skill:
|
|
|
|
```bash
|
|
gemini skills uninstall <name>
|
|
```
|
|
|
|
## Security and consent
|
|
|
|
Agent Skills can execute scripts and access your files. To protect your
|
|
environment:
|
|
|
|
1. **Installation consent**: When installing from a remote URL, you will be
|
|
asked to confirm the source.
|
|
2. **Activation consent**: Every time a skill is triggered during a session,
|
|
the agent must ask for permission to activate it and gain access to its
|
|
resources.
|
|
|
|
## Next steps
|
|
|
|
- [Get started with Agent Skills](./tutorials/skills-getting-started.md): A
|
|
walkthrough for creating your first skill.
|
|
- [Creating Agent Skills](./creating-skills.md): Detailed guide on bundling
|
|
scripts and assets.
|
|
- [Skill best practices](./skills-best-practices.md): Strategies for building
|
|
reliable expertise.
|