Files
2026-07-13 12:28:53 +08:00

48 lines
1.6 KiB
Plaintext

---
title: open-slide sync:skills
description: Refresh the bundled agent skills inside an existing workspace.
---
```npm
open-slide sync:skills
# or
npm run sync:skills
```
Copies the latest skill definitions from your installed `@open-slide/core`
into the workspace under `.agents/skills/`, and refreshes the
`.claude/skills/` symlinks so Claude Code picks them up too.
Run this after upgrading `@open-slide/core` — that's how you pull in skill
fixes and new skills (`/create-slide`, `/slide-authoring`,
`/apply-comments`, `/create-theme`, …) without re-scaffolding.
## What it touches
```text
.agents/
└── skills/
└── <name>/ # canonical copy from @open-slide/core
.claude/
└── skills/
└── <name> # symlink to ../../.agents/skills/<name>
```
Each skill is hashed before copy, so unchanged skills are left alone and
the symlink is the only thing refreshed. On platforms where symlinks fail
(e.g. some Windows configurations), the command falls back to a recursive
copy.
## Flags
| Flag | Default | Description |
| ------------ | ------- | ---------------------------------------------------------- |
| `--dry-run` | off | Print the add / update / unchanged plan without writing. |
## Drift detection on `dev`
`open-slide dev` runs the same drift check at startup. If any skill is out
of date it offers to sync interactively, or prints a one-line warning if
stdin isn't a TTY. Skip the check with `--no-skills-check` (or
`OPEN_SLIDE_SKIP_SKILLS_CHECK=1`) — see [open-slide dev](/docs/cli/dev).