sk-style — скилл для Claude Code: правка сценария и установка
Скилл sk-style для Claude Code правит формулировки в устном сценарии короткого видео, сохраняя смысл. Запускается по просьбе сделать текст короче, живее или убрать фразы, похожие на машинные.
MIT ★ 204 обновлён 2026-11-09
npx skills add howznguyen/shorts-kit --skill sk-style -a claude-codeЧто делает sk-style
Скилл редактирует слова в сценарии, не меняя его факты и смысл. Он разбивает длинные предложения, убирает словесный мусор, называет предмет сцены в первой строке и заменяет избитые обороты. Также проверяет финальный поворот и пары контрастных утверждений.
Сначала он запускает bun run lint <id>, затем проходит по каждому типу проблемы отдельно. После правки текста обязательны bun run tts <id>, прослушивание и повторный запуск линтера: предупреждений §3b должно стать меньше, а новых предупреждений появиться не должно. Числа, оговорки и даты остаются на месте.
Скилл не меняет порядок сцен и не добавляет или удаляет утверждения: для этого в наборе есть sk-brief и sk-facts. Цитату реального человека оставляют дословной, даже если она длиннее заданного лимита.
Какие задачи решает
- разбить длинные предложения, сохранив все факты
- убрать словесный мусор и нагромождение усилителей
- назвать предмет в начале сцены вместо местоимения
- заменить оборот, уже использованный в других видео
- сократить предупреждения §3b из
bun run lint <id>
Примеры запросов агенту
- Сделай формулировки сценария короче, не меняя факты:
video-id. - Убери машинные обороты и проверь, не перегружены ли предложения в
video-id. - Исправь предупреждения §3b после
bun run lint video-id, сохранив числа и даты.
Как установить sk-style
1Через Skills CLI (Vercel)
npx skills add howznguyen/shorts-kit --skill sk-style -a claude-code2Вручную: положить файлы
~/.claude/skills/sk-style/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/sk-style/
1Через Skills CLI (Vercel)
npx skills add howznguyen/shorts-kit --skill sk-style -a codex2Вручную: положить файлы
.agents/skills/sk-style/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add howznguyen/shorts-kit --skill sk-style -a cursor2Вручную: положить файлы
.cursor/skills/sk-style/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install howznguyen/shorts-kit .claude/skills/sk-style2Вручную: положить файлы
.github/skills/sk-style/SKILL.md1Через Skills CLI (Vercel)
npx skills add howznguyen/shorts-kit --skill sk-style -a gemini-cli2Командой платформы
gemini skills install https://github.com/howznguyen/shorts-kit --path .claude/skills/sk-styleВручную: положить файлы
.devin/skills/sk-style/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о sk-style
Как установить sk-style в Claude Code?
Выполни npx skills add howznguyen/shorts-kit --skill sk-style -a claude-code. Файл скилла находится по пути ~/.claude/skills/sk-style/SKILL.md.
Что делает sk-style?
Правит подачу устного сценария короткого видео, сохраняя факты и смысл: сокращает длинные предложения, убирает лишние слова и обновляет затёртые формулировки.
Какие команды нужны для работы sk-style?
В процессе используются bun run lint <id> и bun run tts <id>. После правки скрипт нужно озвучить, прослушать и снова проверить линтером.
Исходный текст
SKILL.md · MIT
---
name: sk-style
description: Polishes the wording of a short's spoken script without changing what it says, by splitting long sentences, cutting filler and AI-slop phrases, naming the subject at the start of each scene, and replacing worn phrases. Use when the user says "tighten the script", "this sounds like AI", "this sentence is clunky", "make it punchier", "rewrite for flow", "too many adjectives", or when bun run lint reports §3b sentence-style warnings.
---
# sk-style: fix the words, not the meaning
**Announce:** "Using sk-style for <id>."
Rules: §3b (`docs/soul/01-voice-and-structure.md`); numbers and phrase lists in
`docs/soul/thresholds.json` (`maxWordsPerSentence`, `medianWordsPerSentence`,
`shortSentenceMaxShare`, `bannedPhrases`, `intensifiersMax`, `strongWords`). To
measure top channels in your niche instead of guessing: `docs/lessons/style-measurement.md`.
## Boundary
| Fix here | Go elsewhere |
|---|---|
| split a long sentence, cut filler, swap a connective | change or drop a **number** → `sk-facts` |
| reorder clauses inside a sentence | reorder **scenes** or change flow → `sk-brief` |
| name the subject in a scene's first line | add or remove a **claim** → `sk-facts`, then `sk-narration` |
| replace a worn phrase | the phrase is prescribed by a § → `sk-improve` |
If a polish pass loses a number, a caveat or a date, it is no longer a polish.
Stop and go back to the brief and the ledger.
## Steps
1. **Snapshot.** `bun run lint <id>` and keep the output. It is the baseline for
step 6 and the to-do list for step 3.
2. **Read the whole script once without editing.** Editing on first read rewrites
things that were already right.
3. **One pass per fault**, across the whole script, before the next fault. Mixing
faults in one pass is how things get missed and meaning gets broken.
1. *Long sentences* over `maxWordsPerSentence`: split at a clause; keep every fact.
2. *Filler*: phrases in `bannedPhrases` and stacked intensifiers. Delete, or
replace with the number from the ledger that the adjective was standing in for.
3. *Scene openers*: a scene whose first word is a pronoun. Name the subject; the
viewer may have just arrived.
4. *Worn phrases*: a phrase used in earlier videos. Write a new one for this video.
5. *The closing turn*: negate what the viewer believes, then give the real reason.
Avoid parallel negation ("not X, not Y, not Z").
6. *Read aloud*: where you run out of breath mid-sentence, it is still too long,
even if lint passed.
7. *Contrast pairs* ("one does X, the other Y"): has the viewer heard both names,
and which ledger record states the contrast? The ledger holds single claims;
a relation between two numbers is the easiest thing to invent and no check
catches it.
4. **Re-run TTS:** `bun run tts <id>`. Mandatory, because `text` changed.
5. **Listen.** Does a split sentence sound clipped? Does a removed connective leave
a gap?
6. **Lint again and diff against step 1.** §3b warnings must go down and **nothing
else may appear**. A new fact or flow warning means you edited content, not words.
7. **A fault repeated across videos is a rule, not this video's bug.** Note it and
use `sk-improve`; do not quietly fix it by hand in every script.
## Do not
- Drop a number to make a sentence shorter.
- Invent a relation between two facts to make a sentence balance.
- Add phrases to `bannedPhrases` mid-video. Changing a rule is `sk-improve`,
and it edits the § too.
- Polish a video that is already posted. Posted videos are history.
## Exception
A verbatim quote from a real person keeps their words even if it breaks
`maxWordsPerSentence`. Say so in the brief so the next pass does not "fix" it.
Next: `sk-scene` if scene lengths changed, otherwise `sk-render`.
© howznguyen · MIT · howznguyen/shorts-kit