# v0.5.0 — Phase E packaging, graduation prep

> Phase E packaging — graduation prep.

This release contains no new commands and no behavioral changes to the CLI. It consolidates everything the fork needs to ship as a self-contained product on its way to `1.0.0`: a single bundled Claude Code skill (replacing five legacy `cut-*` skills), an in-repo reference for CapCut's `draft_content.json` schema, a rewritten README, and the per-version release-notes scaffolding you are reading right now.

The CLI surface is **feature-frozen** for the rest of the `1.0.0-rc.x` cycle.

## What's new

- **Unified Claude Code skill** — `skills/capcut-david/SKILL.md` replaces the five legacy skills (`cut-draft`, `cut-storyboard`, `cut-motion`, `cut-audio`, `cut-tiktok`). Recipes are preserved under `skills/capcut-david/references/recipes-{motion,audio,tiktok,storyboard}.md`, normalised against the `capcut-david` command surface. The skill ships with the npm package, so `npm i -g capcut-cli-david` plus a copy into `~/.claude/skills/` is all it takes to wire up Claude Code.
- **CapCut draft-schema reference** — `docs/draft-schema/` adds 7 files (~3000 lines) of reverse-engineered reference for `draft_content.json`: overview, tracks/segments, materials, keyframes & animations, effects/filters/stickers, and version differences across CapCut releases. This is the same material the agent uses internally; it is now versioned with the code.
- **README rewrite** — new tagline, comparison table (vs upstream `cutcli` and `capcut-cli`), Quickstart, command index, and pointers to the bundled skill + draft-schema docs.
- **Release-notes directory** — `release-notes/*.md` carries the GitHub-release body for each tag. The published release on GitHub uses the matching file verbatim.
- **Wider npm tarball** — `package.json:files` now includes `skills/` and `docs/` alongside `dist/`, `templates/`, `README.md`, `LICENSE`, and `NOTICE`. The skill bundle and draft-schema reference are part of the install.

## No new commands

This is a deliberate freeze. The CLI command surface is identical to `0.4.0`:

- creation primitives — `init`, `add-video`, `add-audio`, `add-text`, `add-keyframe`, `ken-burns`
- editing — `set-text`, `shift`, `shift-all`, `speed`, `volume`, `opacity`, `trim`
- inspection — `info`, `tracks`, `materials`, `segments`, `texts`, `export-srt`, `segment`, `material`
- templates and orchestration — `save-template`, `apply-template`, `cut`, `batch`
- pipeline — `psycho-build`

If you have automation pinned to `0.4.0`, it will run unchanged on `0.5.0`.

## Compatibility

Unchanged from `0.4.0`:

- **CapCut** — ≥ 5.x desktop / JianYing 移动剪辑 ≥ 12.x
- **Node** — `engines.node >= 18`
- **Runtime deps** — zero

JianYing 6+ remains unsupported (encrypted `draft_content.json` — see `COMPATIBILITY.md` §5).

## What's next

`1.0.0-rc.1` ships once `0.5.0` soaks clean in real use. Promotion to stable `1.0.0` happens after the RC soak window closes with zero blocking issues. Full SemVer 2.0.0 guarantees go into effect at `1.0.0` per [`RELEASE.md`](../RELEASE.md) §1.

The five legacy `cut-*` Claude skills are deprecated as of `0.5.0` and will be flagged with `deprecated: true` frontmatter at `1.0.0`. Migrate to the bundled `capcut-david` skill at your convenience.

## Install

```bash
npm install -g capcut-cli-david@0.5.0
```

To wire up the bundled Claude Code skill:

```bash
mkdir -p ~/.claude/skills
cp -r "$(npm root -g)/capcut-cli-david/skills/capcut-david" ~/.claude/skills/
```

## Links

- [`CHANGELOG.md`](../CHANGELOG.md) — full prose changelog
- [`README.md`](../README.md) — tagline, Quickstart, comparison table, command index
- [`skills/capcut-david/SKILL.md`](../skills/capcut-david/SKILL.md) — unified Claude Code skill
- [`docs/draft-schema/`](../docs/draft-schema/) — `draft_content.json` reference
- [`RELEASE.md`](../RELEASE.md) — release process and SemVer policy
- [`UPSTREAM.md`](../UPSTREAM.md) — upstream sync policy
- [`COMPATIBILITY.md`](../COMPATIBILITY.md) — CapCut / JianYing version matrix

## Thanks

- [renezander030](https://github.com/renezander030) — `cutcli` and `capcut-cli` upstream authors.
- ByteDance — the CapCut product itself.
- Everyone who tested the `0.x` series and filed issues.