Share agent skills

Shared agent skills let you install skills from Git repositories or import skills from supported agents on your host for use in local sandboxes. sbx keeps installed skills in a persistent store that survives sandbox deletion and is shared by default with new sandboxes that run a supported agent.

Note

Shared agent skills are experimental.

Add skills from a repository

Add every skill from a Git repository:

$ sbx skills add anthropics/skills

The repository must contain one or more valid SKILL.md files. You can use GitHub owner/repository shorthand or a Git URL, including HTTPS and SSH URLs.

To add specific skills, use --skill with each name or pass a comma-separated list:

$ sbx skills add https://github.com/anthropics/skills --skill frontend-design --skill pdf

When a skill with the same name is already installed, sbx prompts before replacing it. Use --force to replace existing skills without prompts.

Manage installed skills

List the skills in the shared store:

$ sbx skills ls

Update every skill installed from a repository:

$ sbx skills update

To update specific skills, pass one or more names:

$ sbx skills update frontend-design pdf

sbx skills update only refreshes skills installed with sbx skills add. To refresh a skill imported from the host, run sbx skills import again. To manage it with sbx skills update, install it from a repository instead.

Remove one or more installed skills:

$ sbx skills rm frontend-design pdf

sbx asks for confirmation before removing skills that running agents may be using. Use --force to skip confirmation in scripts.

Import skills from the host

Preview the skills that sbx finds without copying them:

$ sbx skills import --dry-run

The command scans the following directories in order and copies each skill subdirectory into the shared store. When the sandbox starts, sbx mounts the store at the path the agent reads inside the sandbox.

All imported skills go into the same store, regardless of their source. If more than one source contains a skill with the same directory name, the skill from the first source in the table wins and sbx warns about the others.

Import the skills:

$ sbx skills import

The final output reports the shared store path. The default locations are:

On Linux, sbx uses $XDG_STATE_HOME/sandboxes/sandboxes/agent-skills when XDG_STATE_HOME is set.

When a skill already exists in the store, sbx prompts before replacing it. Use --force to replace existing skills without prompts. Importing replaces the complete skill directory rather than merging files. Run the import command again when you want to copy updates from the host. If an import replaces a repository-installed skill, sbx no longer associates that skill with its repository, so sbx skills update won't refresh it.

Shared store behavior

Running sbx reset clears the shared store.

Sandboxes created with sbx version 0.37.0 or later for a supported agent are configured to mount the store read-write by default. These sandboxes mount the current contents of the store each time they start, so you can install skills before or after creating them. To create a sandbox without the shared store, use --no-share-skills:

$ sbx run --no-share-skills claude

Upgrading sbx does not enable shared skills for sandboxes created with an earlier version. Remove and recreate those sandboxes after upgrading. The --no-share-skills option also only applies when the sandbox is created. To turn off shared skills for an existing sandbox, remove it and recreate it with the option.

Warning

The shared skills store is mounted read-write. A sandbox can modify any skill in the store, and another sandbox can later load the modified instructions or run the modified scripts. The store is dedicated sandbox state, so this does not by itself execute the modified skill on your host. It does put every sandbox that shares the store in the same trust boundary. Use --no-share-skills to keep a sandbox outside that boundary.

Some agents scan for skills when a session starts. If installed skills don't appear in an existing session, start another agent session.