# How to add Subclip agent skills to Gemini CLI

Install the Subclip agent skills into the portable ~/.agents/skills folder that Gemini CLI reads, connect the Subclip MCP server and reload the skill list.

Canonical URL: https://www.subclip.app/agent-skills/install/gemini-cli

Support: One command. The Subclip skills installer writes straight into the folder this agent reads.

Gemini CLI reads the portable ~/.agents/skills folder, which is one of the installer's targets, so no copy step is needed.

## Steps

1. Run npx @subclip/skills install --target agents.
2. Open the Subclip app, go to Desktop settings > Connect AI client and add the Subclip MCP server to Gemini CLI. The skills call tools that the running app serves.
3. Run /skills reload, then /skills list, to check that the Subclip skills are listed.

## Commands

macOS and Linux:

```sh
npx @subclip/skills install --target agents
```

## Skill folders

- Personal (--target agents): `~/.agents/skills/<skill-name>/SKILL.md`
- Workspace: `.gemini/skills/<skill-name>/SKILL.md`

## Check that it works

- Ask Gemini to use subclip-video-editor and approve the activation prompt.

## Limits

- Gemini asks before a skill is activated and before it reads the skill's files.

Official Gemini CLI docs: https://geminicli.com/docs/cli/using-agent-skills/