AGENT SKILL

videoshorts-metadata-writer

SEO titles/descriptions per platform — агент пишет JSON сам, скрипт только validate.

License 许可
MIT
最近更新
2026-09-21
Stars
★ 36
Forks
26

01 前言 Front Matter

name
videoshorts-metadata-writer
description
SEO titles/descriptions per platform — агент пишет JSON сам, скрипт только validate.

03 SKILL.md 正文

VideoShorts Metadata Writer

Прочитай shared/agent-decision-contract.md.

Роль

Ты автор SEO-текстов. write_metadata.py не пишет за тебя (без --heuristic падает с exit 3).

Вход

  • transcripts/<stem>/transcript.json
  • moments/refined-moments.json или <stem>-moments.json
  • output/clips/<stem>/manifest.json

Действия

  1. Прочитай клипы, hook, payoff, transcript_excerpt.
  2. Для каждого клипа придумай:
    • общий title, description, hashtags, seo_keywords, pinned_comment, cover_text, cover_prompt
    • пакеты platforms.youtube|instagram|tiktok|telegram (отдельные формулировки под сеть)

Жёсткие лимиты API (не превышать — валидатор отклонит)

Платформа Поле Макс. символов
youtube title 100
youtube description 5000
youtube tags (суммарно) 500
instagram caption 2200
tiktok caption 2200
telegram caption 1024
  1. Запиши Write:
    • output/clips/<stem>/metadata/clip_XX.metadata.json
    • output/clips/<stem>/metadata/clip_XX.metadata.md (для человека; обязателен)
    • output/clips/<stem>/metadata-manifest.json

Обязательная шапка manifest

{
  "schema_version": 2,
  "decision_source": "agent",
  "authored_by": "videoshorts-metadata-writer",
  "platforms": ["youtube", "instagram", "tiktok", "telegram"],
  "clips": []
}

Каждый элемент clips[] — полный metadata-объект + оба пути:

{
  "index": 1,
  "json": "clip_01.metadata.json",
  "markdown": "clip_01.metadata.md"
}

markdown: null / отсутствие ключа — баг: packager не увидит .md в manifest (есть fallback по convention, но ключ обязателен).

  1. Проверь:
cd scripts
python validate_agent_artifacts.py metadata "../videoshorts-memory/output/clips/<stem>"

Критерии

  • Title phrase-aware, без ..., не mid-word
  • YouTube description с ключами; Instagram caption; TikTok короткий блок
  • CTA Telegram-канал обязателен в описании каждой платформы (youtube/instagram/tiktok/telegram/zen): строка Подробно в Telegram: https://t.me/maya_pro (вставляется перед блоком хэштегов, либо в конец, если хэштегов нет). Это требование пользователя — не пропускать и не ставить после хэштегов.
  • Не выдумывать факты вне transcript/moments
  • Fragment: videoshorts-memory/fragments/metadata-writer.md + incident_report

Запрещено

  • python write_metadata.py ... без необходимости validate
  • Считать heuristic draft агентным SEO

04 同仓库更多 Skills