# Skill Cover

Create or revise Chinese social-media covers through the registered Skill-封面 asset...

- Repository: https://github.com/Pluviobyte/rnskill (1706 stars)
- Category: Engineering
- License: see repository
- Last updated: 2026-09-21
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add Pluviobyte/rnskill --skill skill-cover -g -a claude-code -y`
Codex: `npx skills add Pluviobyte/rnskill --skill skill-cover -g -a codex -y`
Cursor: `npx skills add Pluviobyte/rnskill --skill skill-cover -g -a cursor -y`
Gemini CLI: `npx skills add Pluviobyte/rnskill --skill skill-cover -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add Pluviobyte/rnskill`

## Description

Create or revise Chinese social-media covers through the registered Skill-封面 asset system, reusable styles, presenter identities, ratio-specific layouts, and exact replacement prompts. Use only when the user explicitly says“skill-cover”“Skill-封面”“实战风格”, requests the registered style/gesture assets, asks for simultaneous 3:4 and 4:3 registered-layout output, replaces a reference cover's person with the current digital-human frame, or extends this registered cover system. Do not use for a generic“制作封面/生成封面”request; generic cover requests belong to dog-skill.

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

# Skill-封面

统一管理多种封面风格。每种风格拥有独立的双比例基底和视觉合同；人物身份与动作作为共享资产复用。目前已注册 `实战风格`。

## 输入契约

必须取得主标题。接受以下可选参数：

- `style`：风格名称或别名；未指定时使用注册表的 `default_style`。
- `subtitle`：副标题；缺省时保留副标题区域留白，不擅自编造结论。
- `tag`：左上角标签，默认 `AI 实测`。
- `highlight`：需要强调的词组，可重复传入。
- `gesture`：动作预设，默认 `zhengzuo`（正坐）。
- `reference_cover`：任意参考封面；提供时进入“参考封面换人换字”模式。
- `identity_image`：项目数字人/真人身份帧；参考封面模式必填。
- `avatar_video`：原始数字人 master；需要现场截取身份帧时使用。
- `output_dir`：用户指定路径优先。

默认同时输出 3:4 和 4:3。只有用户明确只要一种比例时才减少输出。

## 风格与动作路由

1. 读取 `references/style-registry.json`。
2. 将用户说出的风格名称与 `display_name`、slug 和 `aliases` 匹配。
3. 用户未指定风格时使用 `default_style`。如果参考图明显要求另一种已注册风格，则优先尊重参考图。
4. 读取注册项的 `reference_doc`，只加载所选风格的详细视觉合同。
5. 读取 `assets/shared/gestures/registry.json` 和对应动作的 `manifest.json`；风格只用 `default_gesture` 与 `allowed_gestures` 引用动作，不重复保存动作定义。
6. 未注册的新风格或动作不得假装已存在；分别按“新增风格”和“新增动作”流程建立资产包。

## 制作工作流

1. 判断使用“注册风格”还是“参考封面换人换字”；选择标题、副标题、标签和强调词。
2. 使用内置 `view_image` 查看脚本返回的基底、身份图、动作图和风格参考图。
3. 运行 `scripts/build_prompt.py` 生成每个比例的提示词与绝对参考图路径。例如：

   ```bash
   python3 scripts/build_prompt.py \
     --style shizhan \
     --title '史上最强国产开源模型，Kimi K3完全实测！' \
     --subtitle '真实项目全流程挑战｜综合能力超过 Opus' \
     --highlight 'Kimi K3' \
     --highlight '完全实测'
   ```

4. 使用内置 `imagegen` 能力，每个比例单独调用一次 `image_gen`。禁止将一种比例机械裁剪成另一种比例。
5. 严格按脚本返回的顺序传入参考图：比例基底负责整体构图，共享身份图负责脸、发型和黑 T，共享动作图只负责姿态；动作 manifest 若提供比例构图参考，则下一张图负责人物位置、尺寸和露出范围；最后一张风格参考图负责视觉校准。动作 manifest 的精确构图规则优先于风格中的通用人物范围。
6. 输出后逐张检查。文字错误时只做一次“仅修正文字”的定向编辑，并重新声明身份、动作、构图、背景和色彩不变。
7. 用户指定目录时保存到该目录。属于现有视频项目时保存到项目的 `封面/`，工程中间产物不得进入 `成片/`。
8. 运行 `scripts/validate_cover.py` 检查双比例与基础清晰度，再完成人工视觉质检。

## 参考封面换人换字

当用户要求“截取我的数字人替换图中人物”“照这张封面改成当前项目”或同义动作时：

1. 优先从项目的原始 HeyGen/avatar master 截帧，不从带圆形遮罩、字幕或其他 UI 的最终成片截取。找不到原始 master 时才使用最终成片，并记录降级。
2. 运行候选帧脚本并用 `view_image` 查看 contact sheet：

   ```bash
   python3 scripts/extract_avatar_frames.py <avatar-master.mp4> \
     --out-dir <项目>/封面/avatar-reference
   ```

The rest: https://github.com/Pluviobyte/rnskill/blob/HEAD/skills/skill-cover/SKILL.md