# How to add Subclip agent skills to Goose

Install the Subclip agent skills for Goose, copy them into its skills folder, connect the Subclip MCP server and check that Goose can use them.

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

Support: Install, then copy. Install to the portable ~/.agents/skills folder, then copy the skill folders where this agent looks for them.

Goose reads skills through its built-in skills extension. Keep each Subclip skill in its own folder under ~/.config/goose/skills.

## Steps

1. Make sure the built-in skills extension is turned on in Goose.
2. Run the installer with --target agents. It copies every public Subclip skill into ~/.agents/skills and records what it installed.
3. Copy the subclip-* folders into ~/.config/goose/skills. Keep each folder whole: SKILL.md loads its references from the same folder.
4. Open the Subclip app, go to Desktop settings > Connect AI client and add the Subclip MCP server to Goose. The skills call tools that the running app serves.
5. Restart Goose or start a new session so it picks up the new skill folders.

## Commands

macOS and Linux:

```sh
npx @subclip/skills install --target agents
mkdir -p ~/.config/goose/skills
cp -R ~/.agents/skills/subclip-* ~/.config/goose/skills/
```

Windows (PowerShell):

```powershell
npx @subclip/skills install --target agents
New-Item -ItemType Directory -Force "$HOME\.config\goose\skills" | Out-Null
Copy-Item -Recurse -Force "$HOME\.agents\skills\subclip-*" "$HOME\.config\goose\skills"
```

## Skill folders

- Personal: `~/.config/goose/skills/<skill-name>/SKILL.md`
- Project: `.goose/skills/<skill-name>/SKILL.md`

## Check that it works

- Ask Goose to use subclip-video-editor for your project.
- Ask Goose which skills it has when a skill is not picked automatically.

## Limits

- Copied folders are not tracked by the installer. Run the install and copy commands again after an update.
- Skill discovery needs the skills extension to be turned on.

Official Goose docs: https://github.com/block/agent-skills