Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
bytedance avatar

Report Generator

  • 2 installs
  • 411 repo stars
  • Updated August 4, 2026
  • bytedance/agentkit-samples

Report Generator is a Claude skill (ByteDance AgentKit sample) that merges video breakdown and hook-analysis data into a Markdown video-analysis report.

About

Report Generator is a ByteDance AgentKit skill that merges video breakdown data and optional hook-analysis results into a professional Markdown video-analysis report. Running generate_report.py outputs sections for basic info, first-three-seconds hook scoring, a shot overview table, BGM analysis, scene analysis and platform recommendations. Developers use it to deliver a structured video analysis document to clients or teams.

  • Merges video breakdown and hook analysis into a Markdown report
  • Report covers hook score, shot overview, BGM and scene analysis
  • Runs a bundled generate_report.py script

Report Generator by the numbers

  • 2 all-time installs (skills.sh)
  • Ranked #1,166 of 1,335 Generative Media skills by installs in the Skillselion catalog
  • Data as of Aug 5, 2026 (Skillselion catalog sync)
At a glance

report-generator capabilities & compatibility

Capabilities
report generator · video analysis · document generation
Use cases
documentation · data analysis · marketing
Pricing
Free
From the docs

What report-generator says it does

视频分析报告生成技能将分镜拆解数据和(可选的)钩子分析结果整合为一份专业的 Markdown 格式分析报告。
SKILL.md
分镜概览最多展示前 10 个分镜
SKILL.md
画面内容描述超过 40 字符会自动截断
SKILL.md
npx skills add https://github.com/bytedance/agentkit-samples --skill report-generator

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs2
repo stars411
Last updatedAugust 4, 2026
Repositorybytedance/agentkit-samples

What it does

Merge video breakdown and hook-analysis data into a Markdown video-analysis report.

Who is it for?

Delivering a structured Markdown video-analysis report from breakdown and hook data.

Skip if: Doing the breakdown or hook scoring itself; it only formats supplied JSON into a report.

When should I use this skill?

You have video breakdown JSON (and optionally hook analysis) and need a formatted report.

What you get

A complete Markdown video-analysis report with hook score, shot overview, BGM and scene sections.

  • Markdown video-analysis report

By the numbers

  • shot overview shows up to 10 shots
  • content descriptions auto-truncate past 40 characters

Files

SKILL.mdMarkdownGitHub ↗

视频分析报告生成 (Report Generator)

概述

视频分析报告生成技能将分镜拆解数据和(可选的)钩子分析结果整合为一份专业的 Markdown 格式分析报告。报告包含视频基本信息、前三秒钩子评分、分镜概览表格、BGM 分析、场景分析和平台推荐等章节。

适用场景

1. 视频分析交付:为客户或团队生成完整的视频分析文档 2. 创意复盘:生成结构化的视频内容复盘报告 3. 竞品报告:批量生成竞品视频分析报告

使用步骤

完整报告(分镜 + 钩子分析)

# 1. 准备分镜拆解数据和钩子分析数据(JSON 文件)
# 2. 生成报告
python scripts/generate_report.py breakdown.json hook_analysis.json

# 3. 保存到文件
python scripts/generate_report.py breakdown.json hook_analysis.json > report.md

仅分镜报告(无钩子分析)

python scripts/generate_report.py breakdown.json

报告结构

生成的报告包含以下章节:

# 视频分析报告

## 基本信息
- 视频时长、分镜数量、分辨率

## 前三秒钩子分析(核心)
- 综合评分
- 5维度评分表格
- 钩子类型
- 优势/不足/优化建议
- 留存预测

## 分镜概览
- 前10个分镜的概览表格

## BGM 分析
- 音乐风格、情绪基调、节拍

## 场景分析
- 主要场景、视频风格、目标受众
- 平台推荐

报告生成时间

输入格式

breakdown.json(必需)

{
  "duration": 30.5,
  "segment_count": 12,
  "resolution": "1920x1080",
  "segments": [...],
  "bgm_analysis": {
    "music_style": {"primary": "流行"},
    "emotion": {"primary": "欢快"},
    "tempo": {"bpm_estimate": 120, "pace": "中速"}
  },
  "scene_analysis": {
    "primary_scene": "室内",
    "video_style": {"overall": "生活方式", "target_audience": ["年轻人"]},
    "platform_recommendations": [...]
  }
}

hook_analysis.json(可选)

{
  "overall_score": 7.5,
  "visual_impact": 8.0,
  "visual_comment": "评价...",
  "language_hook": 7.0,
  "language_comment": "评价...",
  "emotion_trigger": 7.5,
  "emotion_comment": "评价...",
  "information_density": 7.0,
  "info_comment": "评价...",
  "rhythm_control": 8.0,
  "rhythm_comment": "评价...",
  "hook_type": "好奇型",
  "strengths": ["优点1", "优点2"],
  "weaknesses": ["不足1"],
  "suggestions": ["建议1", "建议2"],
  "retention_prediction": "中:50-70%,因为..."
}

输出格式

Markdown 格式的完整报告文本,直接输出到 stdout。

示例

# 完整流程
python ../video-breakdown-skill/scripts/process_video.py "https://example.com/video.mp4" > breakdown.json
cat breakdown.json | python ../hook-analyzer-skill/scripts/analyze_hook_segments.py - > hooks.json
# (hooks.json 需经 LLM 评分后得到 hook_analysis.json)
python scripts/generate_report.py breakdown.json hook_analysis.json > report.md

注意事项

1. 如果缺少 hook_analysis 数据,报告中钩子分析章节将显示"暂无数据" 2. 分镜概览最多展示前 10 个分镜 3. 报告自动添加生成时间戳 4. 画面内容描述超过 40 字符会自动截断

故障排除

问题解决方案
钩子分析为空确认传入了 hook_analysis.json 文件
分镜表格为空确认 breakdown.json 包含 segments 字段
BGM/场景显示 N/A分镜拆解服务可能未返回此数据

Related skills

FAQ

Is hook analysis required?

No. The docs note that if hook_analysis data is missing, the hook section shows 'no data' and only the breakdown report is produced.

How many shots appear in the overview?

The shot overview shows at most the first 10 shots.

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.