---
type: reference
title: Skills CLI Installation Scope
description: Project vs global installation, symlink vs copy methods.
tags:
  - unverified
  - skills
  - installation
  - scope
timestamp: 2026-07-18
verified: 2026-08-28
---

# Installation Scope

## Project vs Global

| Scope | Flag | Location | Use Case |
|-------|------|----------|----------|
| **Project** | _(default)_ | `./<agent>/skills/` | Committed with your project, shared with team |
| **Global** | `-g` | `~/<agent>/skills/` | Available across all projects |

## Symlink vs Copy

When installing interactively, you can choose:

| Method | Description |
|--------|-------------|
| **Symlink** _(Recommended)_ | Creates symlinks from each agent to a canonical copy. Single source of truth, easy updates. |
| **Copy** | Creates independent copies for each agent. Use when symlinks are not supported. |

Use `--copy` to force copy mode.

## Related

* [Commands](/tools/vercel-labs-skills/commands.md) — add, use, list, remove commands