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.jsonmoments/refined-moments.jsonили<stem>-moments.jsonoutput/clips/<stem>/manifest.json
Действия
- Прочитай клипы, hook, payoff, transcript_excerpt.
- Для каждого клипа придумай:
- общий
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 |
| caption | 2200 | |
| tiktok | caption | 2200 |
| telegram | caption | 1024 |
- Запиши Write:
output/clips/<stem>/metadata/clip_XX.metadata.jsonoutput/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, но ключ обязателен).
- Проверь:
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
videoshorts-virality-critic
LEGACY — не вызывать в slim P0. Virality пишет videoshorts-editor.
★ 36
videoshorts-transcriber
Транскрипция видео через faster-whisper. JSON + SRT с таймкодами.
★ 36
videoshorts-system-profiler
暂无简介
★ 36
videoshorts-subtitle-writer
暂无简介
★ 36
videoshorts-subtitle-burner
暂无简介
★ 36
videoshorts-scorekeeper
LEGACY — не вызывать в slim P0. Оценки пишет videoshorts-editor (опционально через Jev).
★ 36