skill-improver

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Skill improver

Skill 改进器

Paths:

${CLAUDE_SKILL_DIR}

means the folder containing this SKILL.md, and

${CLAUDE_PLUGIN_ROOT}

the plugin folder two levels above it.

Every question to the user goes in the question box: call the AskUserQuestion tool (2-4 options, the recommended one first). Only in an agent without that tool, ask numbered questions in text.

taste saves one correction the moment the user says it. This skill works on a whole finished video: it reads every note, keeps the lasting ones and writes them into the style or skill that made the video.

K="${CLAUDE_PLUGIN_ROOT}/lib/ai_editor/skillrules.py"

R="${CLAUDE_PLUGIN_ROOT}/lib/ai_editor/review.py"

T="${CLAUDE_PLUGIN_ROOT}/skills/taste/scripts/taste.py"

. Run them with

python3

on Mac and Linux,

py

on Windows.

Copy this checklist and tick it off:

- [ ] 1. Notes collected
- [ ] 2. One-offs left with the video
- [ ] 3. Target found
- [ ] 4. Each rule checked for a twin or a conflict
- [ ] 5. Lines shown, user said yes
- [ ] 6. Saved, log written

路径：

${CLAUDE_SKILL_DIR}

表示包含此 SKILL.md 的文件夹，

${CLAUDE_PLUGIN_ROOT}

表示其上方两级的插件文件夹。

所有向用户提出的问题都应放入问题框：调用 AskUserQuestion 工具（提供 2–4 个选项，推荐项放在首位）。只有在没有该工具的 agent 中，才以文本形式提出编号问题。

taste 会在用户说出某项纠正时立即保存一次纠正。本 skill 处理的是整个已完成的视频：它会读取所有备注，保留可长期适用的备注，并将其写入制作该视频的 style 或 skill 中。

K="${CLAUDE_PLUGIN_ROOT}/lib/ai_editor/skillrules.py"

R="${CLAUDE_PLUGIN_ROOT}/lib/ai_editor/review.py"

T="${CLAUDE_PLUGIN_ROOT}/skills/taste/scripts/taste.py"

。在 Mac 和 Linux 上使用

python3

运行，在 Windows 上使用

py

运行。

复制此检查清单并逐项勾选：

- [ ] 1. Notes collected
- [ ] 2. One-offs left with the video
- [ ] 3. Target found
- [ ] 4. Each rule checked for a twin or a conflict
- [ ] 5. Lines shown, user said yes
- [ ] 6. Saved, log written

1. Collect the notes

1. 收集备注

Review-page notes and your replies:
```
edits/<name>/review.json
```
(
```
comments
```
). After the final approve,
```
wait
```
's
```
LEARN:
```
block already lists them.
Preview fixes:
```
edits/<name>/corrections.jsonl
```
.
Corrections the user typed in this chat about this video.

Review 页面备注及你的回复：
```
edits/<name>/review.json
```
（
```
comments
```
）。最终 approve 后，
```
wait
```
的
```
LEARN:
```
块中已经列出了这些内容。
预览修正：
```
edits/<name>/corrections.jsonl
```
。
用户在聊天中针对该视频输入的纠正。

2. Keep only notes for every future video

2. 仅保留适用于未来每个视频的备注

A note about one moment stays with the video. A note about how edits should look becomes a rule.

note	rule?
"cut the um at 0:12"	no: one moment
"the Notion card covers my chin" (said twice)	yes: "Cards sit above the chin, never over the face"
"captions are tiny again"	yes: "Captions one size bigger" (with `set` captions.size_pct when the settings table in taste maps)
"wrong logo for Jev"	no: one asset (the logo-pack skill fixes it)

Write the behaviour, not the instance: "Cards fill the space they have", not "make the router card bigger".

关于某个瞬间的备注应留在该视频中。关于剪辑应呈现何种效果的备注则会成为规则。

备注	是规则吗？
"在 0:12 处删掉语气词"	否：某一个时间点
"Notion 卡片遮住了我的下巴"（说了两次）	是："卡片位于下巴上方，绝不覆盖面部"
"字幕又太小了"	是："字幕调大一号"（当 taste 中的 settings 表有映射时，使用 `set captions.size_pct` ）
"Jev 的 logo 用错了"	否：单个素材（由 logo-pack skill 修复）

写行为，不写个案：应写"卡片填满其可用空间"，而不是"把 router 卡片放大"。

3. Find the target

3. 查找目标

bash

python3 "$K" target edits/<name>

```
"kind": "skill"
```
with a
```
path
```
: a skill style. Rules go into that SKILL.md under
```
## Learned rules
```
. No
```
path
```
: the skill is not in the user's skill folders; say so and stop. A skill inside a plugin is never written (an update replaces it); save those rules with taste instead.
```
"kind": "settings"
```
: rules go to that style (
```
style
```
path) or, with
```
style
```
null, to My style, through
```
styleskill.learn
```
(rules.json,
```
style.overrides.json
```
, and the style's own skill rebuilt).

bash

python3 "$K" target edits/<name>

```
"kind": "skill"
```
且有
```
path
```
：skill 风格。规则写入该 SKILL.md 的
```
## Learned rules
```
下。如果没有
```
path
```
：该 skill 不在用户的 skill 文件夹中；告知用户并停止。绝不写入 plugin 内的 skill（更新会将其替换）；这类规则应改用 taste 保存。
```
"kind": "settings"
```
：规则写入该 style（
```
style
```
路径）；如果
```
style
```
为 null，则通过
```
styleskill.learn
```
写入 My style（rules.json、style.overrides.json，并重建该 style 自身的 skill）。

4. Check for a twin or a conflict

4. 检查重复项或冲突

Skill style:

python3 "$K" similar <SKILL.md> "<rule>"

lists the learned rules that look alike. Settings style:

python3 "$T" report

lists the rules saved so far.

Same meaning, vaguer: sharpen the old line (
```
replace
```
), never add a second one.
Opposite meaning ("logos bigger" vs a saved "logos small"): ask in the question box which wins, quoting both:
```
The new note (Recommended)
```
/
```
The saved rule
```
. Keep only the winner (
```
replace
```
). Never keep both.
Nothing alike: a new line.

skill 风格：运行

python3 "$K" similar <SKILL.md> "<rule>"

，列出看起来相似的已学习规则。 settings 风格：运行

python3 "$T" report

，列出目前已保存的规则。

含义相同但其中一条更笼统：优化旧的那一行（
```
replace
```
），绝不新增第二条。
含义相反（"logo 放大"与已保存的"logo 变小"）：在问题框中询问采用哪一条，并引用两者：
```
The new note (Recommended)
```
/
```
The saved rule
```
。只保留胜出的规则（
```
replace
```
）。绝不同时保留两条。
没有相似规则：新增一行。

5. Show the lines, then ask

5. 展示文本行，然后询问

Each rule is one line: the rule,

Why:

the reason, and the date. Example, note to line:

note:  "the logo is on my face again" (rounds 1 and 2)
line:  - Logos sit beside the head, never over the face. Why: two notes said a logo covered the chin. (2026-10-13)
file:  ~/.claude/skills/my-edit/SKILL.md, ## Learned rules

Show every line exactly as it will be saved and the file it goes in. Then ask in the question box:

Save these (Recommended)

Change one

Don't save

. Save nothing before the yes.

每条规则占一行：规则、

Why:

原因以及日期。下面的示例展示了如何将备注转换为规则行：

note:  "the logo is on my face again" (rounds 1 and 2)
line:  - Logos sit beside the head, never over the face. Why: two notes said a logo covered the chin. (2026-10-13)
file:  ~/.claude/skills/my-edit/SKILL.md, ## Learned rules

准确展示每一条将要保存的文本行及其目标文件。然后在问题框中询问：

Save these (Recommended)

Change one

Don't save

。在用户明确同意前不要保存任何内容。

6. Save

6. 保存

From the review page (the final approve's "Teach <style> from this video" panel): post the rules, and the boxes the user ticks are the yes:

bash

python3 "$R" edits/<name> learn --propose '[{"rule": "Logos sit beside the head, never over the face", "section": "visuals", "why": "two notes said a logo covered the chin", "replace": "Logos beside the head"}]'
python3 "$R" edits/<name> learn --done      # after `wait` prints the ticked rules

why

and

replace

are optional;

set

(a taste setting) only for a settings style.

--done

writes a skill style's rules into its SKILL.md and a settings style's through

styleskill.learn

. A round's

learn --scope this-style

does the same for a skill style (the note is the reason).

Each saved rule shows on the review page as a receipt, "Saved to <style>: <rule>. Undo", and on the style's page under "Learned rules" with its day and the video it came from, where the user can Remove it. Undo and Remove take the line out again (

taste.py forget

skillrules.py remove

); never put it back by hand.

From the Skills page ("Improve with feedback",

JOB skill-change

): no video, only the user's words. Steps 3-6 the same; the target is the

path=

the job names.

start/references/home.md

has the status lines.

From the chat, after the yes:

bash

python3 "$K" add <SKILL.md> "<rule>" --why "<reason>" [--replace "<old rule>"] --edit edits/<name>   # skill style
python3 "$T" add <section> "<rule>" [--set key=value] --style <style.json> --edit edits/<name>       # settings style
python3 "$T" add <section> "<rule>" [--set key=value] --edit edits/<name>                           # My style

add

prints

duplicate

when the same rule is already there (nothing written),

sharpened

when it replaced one,

added

otherwise. It also appends one line to

## Log

at the end of the SKILL.md (the last 20 kept). A settings style's log is rules.json:

taste.py report

shows each rule's count and dates.

Tell the user in one line what was saved and where.

从 review 页面（最终 approve 中的 "Teach <style> from this video" 面板）：提交规则，用户勾选的框即表示同意：

bash

python3 "$R" edits/<name> learn --propose '[{"rule": "Logos sit beside the head, never over the face", "section": "visuals", "why": "two notes said a logo covered the chin", "replace": "Logos beside the head"}]'
python3 "$R" edits/<name> learn --done      # after `wait` prints the ticked rules

why

和

replace

为可选参数；

set

（taste setting）仅用于 settings 风格。

--done

会将 skill 风格的规则写入其 SKILL.md，并通过

styleskill.learn

将 settings 风格的规则写入对应位置。某一轮次的

learn --scope this-style

对 skill 风格也执行相同操作（备注就是原因）。

每条已保存规则都会显示在 review 页面中，形成一条回执："Saved to <style>: <rule>. Undo"；同时显示在该 style 的页面中 "Learned rules" 下，并附有保存日期及来源视频，用户可在那里点击 Remove 移除规则。Undo 和 Remove 会再次移除该规则行（

taste.py forget

、

skillrules.py remove

）；切勿手动将其加回。

从 Skills 页面（"Improve with feedback"、

JOB skill-change

）：没有视频，只有用户的话。步骤 3–6 相同；目标为 job 指定的

path=

。

start/references/home.md

中包含状态行。

从聊天发起，在用户同意后：

bash

python3 "$K" add <SKILL.md> "<rule>" --why "<reason>" [--replace "<old rule>"] --edit edits/<name>   # skill style
python3 "$T" add <section> "<rule>" [--set key=value] --style <style.json> --edit edits/<name>       # settings style
python3 "$T" add <section> "<rule>" [--set key=value] --edit edits/<name>                           # My style

add

会在同一规则已存在时输出

duplicate

（不写入任何内容），在替换了一条规则时输出

sharpened

，其他情况下输出

added

。它还会在 SKILL.md 末尾的

## Log

中追加一行（仅保留最后 20 条）。settings 风格的日志是 rules.json：

taste.py report

会显示每条规则的使用次数和日期。

用一行告诉用户保存了什么以及保存到了哪里。

Files

文件

${CLAUDE_PLUGIN_ROOT}/lib/ai_editor/skillrules.py

target

similar

add

remove

list

demo

${CLAUDE_PLUGIN_ROOT}/lib/ai_editor/review.py

learn --propose

--done

(the Teach panel).

${CLAUDE_PLUGIN_ROOT}/lib/ai_editor/styleskill.py

learn

, a settings style's rules and skill.

${CLAUDE_PLUGIN_ROOT}/lib/ai_editor/skillrules.py

：

target

、

similar

、

add

、

remove

、

list

、

demo

。

${CLAUDE_PLUGIN_ROOT}/lib/ai_editor/review.py

：

learn --propose

learn --done

（Teach 面板）。

${CLAUDE_PLUGIN_ROOT}/lib/ai_editor/styleskill.py

：

learn

，用于 settings 风格的规则和 skill。