# How to add Subclip agent skills to Windsurf

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

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

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

Windsurf Cascade loads skills from a global folder and from each workspace. The global folder makes the Subclip skills available in every workspace.

## Steps

1. Run the installer with --target agents. It copies every public Subclip skill into ~/.agents/skills and records what it installed.
2. Copy the subclip-* folders into ~/.codeium/windsurf/skills. Keep each folder whole: SKILL.md loads its references from the same folder.
3. Open the Subclip app, go to Desktop settings > Connect AI client and add the Subclip MCP server to Windsurf. The skills call tools that the running app serves.
4. Restart Windsurf 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 ~/.codeium/windsurf/skills
cp -R ~/.agents/skills/subclip-* ~/.codeium/windsurf/skills/
```

Windows (PowerShell):

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

## Skill folders

- Personal: `~/.codeium/windsurf/skills/<skill-name>/SKILL.md`
- Workspace: `.windsurf/skills/<skill-name>/SKILL.md`

## Check that it works

- Mention @subclip-video-editor in Cascade to use it directly.
- Cascade can also pick a skill on its own when your request matches its description.

## Limits

- Copied folders are not tracked by the installer. Run the install and copy commands again after an update.
- Tool calls still need the permissions you give Cascade.

Official Windsurf docs: https://docs.devin.ai/desktop/cascade/skills