videoshorts-metadata-writer

Files (1)

• SKILL.md

SKILL.md (first lines)

# 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 |

3. Запиши **Write**:
   - `output/clips/<stem>/metadata/clip_XX.metadata.json`
   - `output/clips/<stem>/metadata/clip_XX.metadata.md` (для человека; **обязателен**)
   - `output/clips/<stem>/metadata-manifest.json`

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

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

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

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

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

4. Проверь:

```bash
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

From Horosheff/hyperion-reels, MIT.

More from Horosheff/hyperion-reels