Communitygithub.com

training-video

Shows an agent how to plan, build, or cut "training video" so the concrete output is usable copy or a script. The procedure moves through Обучително видео, Четири одобрения — без тях не харчиш пари и време, Ход. Use it when a new assignment calls for this craft.

Was ist training-video?

training-video is a Claude Code agent skill that shows an agent how to plan, build, or cut "training video" so the concrete output is usable copy or a script. The procedure moves through Обучително видео, Четири одобрения — без тях не харчиш пари и време, Ход. Use it when a new assignment calls for this craft.

Funktioniert mit✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/erida-ai/training-video/tree/HEAD/skills/training-video

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Обучително видео

Гласът води, картината го следва: първо сценарий и звук, после слайдове или запис, синхронизирани по дължината на всяка реплика.

С кого говориш. Човекът може да не е технически: говори на български (или на езика, на който ти пише), с прости думи, без команди и пътища, освен ако не попита. Техническите стъпки ги правиш ти. Питай само за решенията, които са негови: съдържание, аудитория, език, визия, одобрения.

Скриптовете са в ${CLAUDE_SKILL_DIR}/scripts/ и се пускат с python3 -B ${CLAUDE_SKILL_DIR}/scripts/<скрипт>.py … — на Windows вместо python3 е командата, която doctor.py казва на реда „Python команда“ (python или py -3); слайдовете и рендерът — node ${CLAUDE_SKILL_DIR}/deck/render.cjs …; записът на приложение — ${CLAUDE_SKILL_DIR}/screencast/. Темите са в ${CLAUDE_PLUGIN_ROOT}/themes/. Работи на macOS и Windows (в Bash и в PowerShell): командите остават прости — без пайпове, && и пренасочвания.

Проектът е папката, в която работиш (repo на продукт или папка с документи). Всеки проект има свой Gemini ключ, който стои само на компютъра на човека (Keychain / Credential Manager); белегът на проекта е .training-video/project.json (id и име, без тайни).

Четири одобрения — без тях не харчиш пари и време

  1. Сценарий (текстът на репликите и планът на слайдовете/екраните).
  2. Цена — таблицата от cost.py. Малки проби (до 3–4 реплики) не искат одобрение, пълното озвучаване — да.
  3. Проба на гласа — първите 3 реплики (narrate.py --sample 3); човекът ги слуша.
  4. Визия — 1–2 готови слайда или кадъра от записа, преди целия рендер.

Ход

  1. Среда и ключ — при всяко пускане, преди всичко останало.
    • doctor.py <проект>. Каквото липсва, го оправи с разрешение на човека с командата, която doctor.py дава за тази система (brew / winget); за рендера npm ci в ${CLAUDE_PLUGIN_ROOT}, ако Claude Code не го е направил, и npx playwright install chromium.
    • Ключът на проекта: key.py check <проект>.
      • OK → продължаваш.
      • НЯМА ПРОЕКТ → кажи на човека, че папката ще получи малък файл .training-video/project.json (име и номер на проекта, без тайни — може да влезе в git) и попитай за името на проекта (предложи името на папката). После wizard-а.
      • НЯМА КЛЮЧ → ако пише, че има стар общ ключ, попитай „Да ползвам ли досегашния ви Gemini ключ и за този проект?“ (да → key.py setup <проект> --use-legacy). Иначе wizard-а.
      • ОТХВЪРЛЕН → wizard-а с --replace.
    • Wizard-ът: първо кажи с прости думи какво следва: „Ще се отвори страницата на Google AI Studio — създайте ключ (Create API key) в акаунта, от който ще се плаща гласът за този проект, и го копирайте. После ще се появи прозорец, в който да го поставите; ключът остава само на този компютър.“ Пусни key.py setup <проект> [--name „<име>“] — той отваря страницата и прозореца, проверява ключа в Gemini и го записва. Никога не искай ключа в чата и не го пиши никъде; ако човекът го постави в чата, кажи му да го изтрие от Google AI Studio и да направи нов.
    • Технически хора могат да ползват Vertex (gcloud auth application-default login и GOOGLE_CLOUD_PROJECT); GEMINI_API_KEY в средата важи за всички проекти — само за CI.
  2. Прием — ориентирай се сам, питай само каквото не личи.
    • Какво има: файлове/папка в чата или на диска, Google Drive линк (през свързания Google Drive конектор, ако има такъв), уеб линкове, git repo на продукт (.training-video/profile.md в него означава, че продуктът е подготвен за видео).
    • Има PDF, а doctor.py казва „poppler (PDF): няма“ → попитай с един въпрос: „За да извадя текста и снимките от PDF-ите, трябва малка програма (poppler, около 35 MB). Да я инсталирам ли?“ При „да“ — командата от doctor.py (brew / winget); при „не“ — чети PDF-ите директно, без снимки от тях.
    • Режим: по материали → reference/materials.md; по код (запис на приложението) → reference/code.md. Ако има и двете, попитай кое е видеото.
    • По код — за коя роля. Видеото е за една роля на приложението (оператор, мениджър, администратор…): записът влиза като нея и показва само нейните екрани. Ролите вземи от профила на продукта или от кода (reference/code.md, „Ролите — от кода“) и питай с готови отговори — етикетите, както ги казва приложението. Не пиши сценарий, преди огледът като ролята (survey.cjs) да е минал.
    • Питай накуп (с въпроси с готови отговори): за кого е видеото и какво трябва да могат след него; език на гласа (по подразбиране български); езици на субтитрите; дължина (по подразбиране 3–8 мин.); тема (themes/, по подразбиране „Неутрална“; ако материалите имат свой бранд — предложи тема от тях); къде да се запише готовото (папка на Drive или на компютъра).
  3. Папка на видеото — извън плъгина и извън repo-то на продукта, по подразбиране в „Документи“ на човека: <Документи>/Обучителни видеа/<кратко-име>-<дата>/ (~/Documents на Mac; на Windows %USERPROFILE%\Documents, може да е в OneDrive):
    • video.json — {"name": "<файлово име на изхода>", "project": "<абсолютен път до проекта>", "lang": "bg", "voice": "Charon", "subtitles": ["bg", "en"], "theme": "neutral", "mode": "materials|code"} — project казва чий ключ плаща гласа; за „по код“ още "product": "<repo>" и "role": "<роля>";
    • script.json — сценарият (формат в scripts/lines.py); audio/, timeline.json, final/ се правят от скриптовете;
    • sources/ — копие или извадки от материалите, от които е писано (extract.py ги разглобява), и sources/facts.md — фактите с източник.
  4. Сценарий. Правилата за текста са в reference/script.md (тон, дължина, say, факти). Покажи го на човека като четим текст (по глави), не като JSON. Поправките — докато не каже „добре“. → одобрение 1.
  5. Цена. lines.py <папка>, после cost.py <папка>; покажи таблицата. → одобрение 2.
  6. Проба на гласа. narrate.py <папка> --sample 3; дай на човека пътищата до трите .wav (или ги пусни: Mac open <файл>, Windows start "" "<файл>"). Ако тонът не е добър — смени voice в video.json (пробите на гласове: tts.py --probe --voice <име>) и повтори. → одобрение 3.
  7. Визия. Според режима: 1–2 слайда (reference/materials.md) или кадър от записа (reference/code.md). → одобрение 4.
  8. Пълен глас. narrate.py <папка>. Накрая печата отчет; всеки ред REDO <id>: … → narrate.py <папка> --only <id> …, докато няма REDO (вж. reference/voice.md за изключенията).
  9. Картина. Според режима — рендер на слайдовете или запис на екраните; пише timeline.json и final/<name>.mp4.
  10. Субтитри. Преведи сам text на всяка реплика за всеки допълнителен език в subs/<език>.json ({"<id>": "превод"}): същият корпоративен тон, числа с цифри, имената както са в материалите. После srt.py <папка> <name>.
  11. Проверка — reference/voice.md, „Финална проверка“. Не казвай „готово“, преди да минат всички точки; каквото не е минало, го кажи прямо.
  12. Предаване. Ако човекът е посочил папка в Google Drive и има свързан Drive конектор — качи там с него; иначе — пътят до final/. Кажи накратко: дължина, езици, цена, какво остава непроверено.

Тон — винаги

Професионален, корпоративен, за възрастни колеги — дори когато продуктът е за деца. Не детско, не рекламно, не „обяснение за начинаещи“. Подробно: reference/script.md. Гласът не се сменя между репликите: един voice, един стил, една температура за цялото видео (reference/voice.md).

Verwandte Skills