# Titles And Description

用户要为准备发布的视频起标题、要几个标题候选、再来一批或照某个再来几个，或要写视频简介（视频页标题下的说明文字、章节列表、标签）时用。写给发布视频的人：吸引人，并且每句都由视频...

- Repository: https://github.com/JimLiu/baocut (1645 stars)
- Category: Engineering
- License: see repository
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add JimLiu/baocut --skill titles-and-description -g -a claude-code -y`
Codex: `npx skills add JimLiu/baocut --skill titles-and-description -g -a codex -y`
Cursor: `npx skills add JimLiu/baocut --skill titles-and-description -g -a cursor -y`
Gemini CLI: `npx skills add JimLiu/baocut --skill titles-and-description -g -a gemini-cli -y`

## Description

用户要为准备发布的视频起标题、要几个标题候选、再来一批或照某个再来几个，或要写视频简介（视频页标题下的说明文字、章节列表、标签）时用。写给发布视频的人：吸引人，并且每句都由视频兑现。需要视频的转写。不用于给文章起标题等与视频无关的写作。

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

# 起标题与写简介

用户的视频做好了，准备发。标题决定列表里有没有人点，简介决定点进来的人看不看、看完的人找不找得到视频里提到的东西。两者都写给发布视频的人：吸引人，并且每一句视频都兑现。标题和简介配合着用：先出标题候选、让用户挑一个，写简介时就用它。

最容易写坏的样子：从句式出发。「震惊！」「你绝对想不到」「一个视频讲清楚 X」，换个视频也能用，说明它没用上这个视频独有的东西；或者反过来，标题是视频名的复述，简介是视频的流水账，谁看了都不想点。

动笔前先用 `skills_read` 读本 skill 的 `references/writing-baseline.md`（材料、基线、两类读者与视角、篇幅与风格、默认值）。起标题再读 `references/titles.md`，写简介再读 `references/description.md`。

## 1. 取材料

1. 用 videos_inspect 看视频：名字、章节（chapters 的 atSeconds 与 title）、文档。没有转写（kind 为 speech 的文档）时先转写，告诉用户转写在进行。转写没润色过时人名、术语可能有错字，对照视频信息核对。
2. 读文稿：先用 speech_sentences 取按句编号的文稿（简介里依据文稿的段落末尾回引编号，见写作基线「句子编号与出处」；标题不回引）；它说没有可编号的句子时再用 export（kind `transcript`、format `md`、timestamps `true`；有几份文稿时按它列出的候选用 documentId 指定），jobs_inspect 等到 completed，读 outputs 里的文件。没有视频、只有从链接下载并转写的结果时，读 jobs_inspect 的 outputs 里的 TXT 或 SRT。
3. 视频信息：来源标题、作者、原视频链接、发布平台只用视频信息里有的和用户提供的。
4. 系列与前作：用户要在简介里推荐相关视频，或要和以前的标题区分开时，用 space_related_videos 列出讲相近内容的几部（名字与最接近的一段原话）；只列它给出的，不编，不把相关视频的内容写成这部视频讲过的。
5. 用户这次的要求：语言、篇幅、风格、候选个数、发布平台、视角；已选定的标题；之前给过的候选与用户想跟随的那一个，都在这段对话里找。用户说了标题和简介发在同一个平台时，两者按同一个平台写。

## 2. 动笔之前

先想清楚这两件事，它们不进成品：

1. **这个视频最值得看的是什么**。用一句话写下来：一个出人意料的结论、一个具体的结果、一个大家关心却答不上来的问题、一段不常见的经历、一个马上能用的方法。标题从它出发，简介的开头从它出发。一个视频往往有好几个值得看的点，它们就是不同候选的起点。
2. **观众为什么会点**。他本来在找什么、好奇什么、以为是怎样的？这个视频能让他省下什么、避开什么、得到什么？把这个连接点说具体。

## 3. 交付

- 标题：直接在回复里给出候选，每条带角度与一句理由，标出推荐的那一个；请用户挑一个，或说要再来一批、照哪个再来几个。
- 简介：直接在回复里给出全文（标签单列一行）。用户要文件时写成工作目录里的 Markdown 文件（如 `<视频名>.description.md`；多种语言时在扩展名前加语言标签）；会话不属于项目时再用 downloads_save 放进下载目录，把它返回的 path 告诉用户。
- 一并说明：用的是哪种视角、依据是什么；用户已经挑定的标题（或还待用户挑）；哪些信息没有核实、哪些链接要用户补；说了平台的，提醒用户对照平台现行的规则核对。

## 4. 要避免的

- 不要从句式出发；把视频名和人名换掉还能用的标题，重写。
- 不要许诺视频没给的东西：数字、「最」「第一」、留下的问题，视频里都要有。
- 不要用同一句话的改写充当不同的候选。
- 不要编链接、编章节时间、编平台规则。
- 简介不要以链接、标签、署名开头，不要写成流水账。