# Yichen X Slicer

将公开 X 推文、Quote 或同作者 Thread 转为 1080×1440 图片切片和 MP4；也支持显式 source-only...

- Repository: https://github.com/mcncarl/yichen-skills (5140 stars)
- Category: Engineering
- License: see repository
- Last updated: 2026-11-01
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add mcncarl/yichen-skills --skill yichen-x-slicer -g -a claude-code -y`
Codex: `npx skills add mcncarl/yichen-skills --skill yichen-x-slicer -g -a codex -y`
Cursor: `npx skills add mcncarl/yichen-skills --skill yichen-x-slicer -g -a cursor -y`
Gemini CLI: `npx skills add mcncarl/yichen-skills --skill yichen-x-slicer -g -a gemini-cli -y`

## Description

将公开 X 推文、Quote 或同作者 Thread 转为 1080×1440 图片切片和 MP4；也支持显式 source-only 素材桥接。保留所选原生视频及对应音频，不发布。

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Yichen X Slicer（逸尘 X 切片）

Turn one public X status URL into a complete 3:4 image sequence. Use `sunset`（落日琥珀版）unless the user explicitly chooses another template.

## Run

1. Resolve the directory containing this `SKILL.md` as `SKILL_DIR`.
2. Choose a new output directory under the current task's user-facing `outputs/` directory. Never overwrite or delete an earlier run.
3. Run. This default command generates the image sequence, image ZIP, and MP4:

```bash
"<node-bin>" "$SKILL_DIR/scripts/yichen_x_slicer.mjs" \
  --url "<x-status-url>" \
  --output "<absolute-output-directory>"
```

Use the bundled Codex Node.js executable when available. The script locates bundled Playwright automatically; if discovery fails, set `YICHEN_X_SLICER_PLAYWRIGHT_MODULE` to `<workspace-node-packages>/playwright/index.mjs` after loading workspace dependencies.

The default template is `sunset`. To override it:

```bash
"<node-bin>" "$SKILL_DIR/scripts/yichen_x_slicer.mjs" \
  --url "<x-status-url>" \
  --template editorial \
  --output "<absolute-output-directory>"
```

Use `--template all` only when the user asks to compare every style. Use `--list-templates` to print the registry. Read [templates.md](references/templates.md) only when choosing or explaining a non-default template.

Generate images without a video only when the user explicitly asks for images only:

```bash
"<node-bin>" "$SKILL_DIR/scripts/yichen_x_slicer.mjs" \
  --url "<x-status-url>" \
  --images-only \
  --output "<absolute-output-directory>"
```

The normal workflow appends one verified MP4 per selected template after PNG and ZIP verification. With `--template all`, generate 11 separate videos; never mix templates into one timeline. `--images-only` is an explicit opt-out. Read [video.md](references/video.md) for the fixed timing, source-audio, and verification contract.

When another workflow needs a faithful local Markdown source rather than visual slices, use the isolated source bridge:

The rest: https://github.com/mcncarl/yichen-skills/blob/HEAD/yichen-x-slicer/SKILL.md
