Agent skill

Av Sync Workflow

by aAAaqwq in aAAaqwq/AGI-Super-Team

Audio-to-video synchronization workflow: analyze audio (beats, tempo, emotion, mood), find/match video clips to match scene and feeling, sync cuts to music beats, generate beat-marked videos.

MITAuto-check passedMedia & Creative

Install Av Sync Workflow

skills CLI
$ npx skills add aAAaqwq/AGI-Super-Team --skill av-sync-workflow -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install aAAaqwq/AGI-Super-Team av-sync-workflow --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/aAAaqwq/AGI-Super-Team.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/av-sync-workflow .claude/skills/av-sync-workflow && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
av-sync-workflow
GitHub stars
105
Token cost
~1.4k tokens
SKILL.md length
443 words
Files
4 (incl. scripts, references)
Skills in repo
152
Repo updated
First seen
Licence
MIT

At a glance

Audio-to-video synchronization workflow: analyze audio (beats, tempo, emotion, mood), find/match video clips to match scene and feeling, sync cuts to music beats, generate beat-marked videos.

  • Works in 5 steps: Analyze Audio → Gather Video Clips → Analyze Each Clip → …
  • Turn a song into a music video
  • SKILL.md covers Workflow Overview, Step 1: Analyze Audio, Step 2: Gather Video Clips and Step 3: Analyze Each Clip, plus 8 more sections
  • Runs Python scripts from its folder; calls python3, yt-dlp and ffmpeg; reaches pexels.com and pixabay.com

What it does

Av Sync Workflow is an agent skill from aAAaqwq/AGI-Super-Team. Audio-to-video synchronization workflow: analyze audio (beats, tempo, emotion, mood), find/match video clips to match scene and feeling, sync cuts to music beats, generate beat-marked videos. Use when user wants to: (1) turn a song into a music video, (2) sync video clips to music beats, (3) create a video that matches audio mood/scene/rhythm, (4) do beat-matching video editing. Triggers: "制作音乐视频", "音频转视频", "beat matching", "卡点视频", "音视频同步", "视频踩点", "music video creation", "sync video to audio"

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including scripts and reference files (for example `references/beat_sync_principles.md`, `scripts/audio_analysis.py` and `scripts/simple_sync.py`).

It sits in Media & Creative, covering Video production. The repository describes itself as: An installable, cross-framework AI organization: C-suite agents, expert subagents, curated skills, independent review, and one-command setup across 18 AI client/runtime adapters. The licence is MIT.

When your agent uses it

  • Turn a song into a music video
  • Sync video clips to music beats
  • Create a video that matches audio mood/scene/rhythm
  • Do beat-matching video editing

Example prompts

  • “制作音乐视频”
  • “beat matching”
  • “music video creation”
  • “/av-sync-workflow”

Requirements

  • Python 3

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Analyze Audio
  2. Gather Video Clips
  3. Analyze Each Clip
  4. Match Clips to Audio Sections
  5. Generate Beat-Synced Video

What it can do on your machine

Read from SKILL.md and the folder at commit 331ecd3. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 2 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3
    • yt-dlp
    • ffmpeg

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • pexels.com
    • pixabay.com
    • coverr.co

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Av Sync Workflow loads about 1.4k tokens when it runs, and up to ~2.2k if it reads all its reference files. Until then it costs about 129 tokens; SKILL.md has 443 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~129
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from aAAaqwq/AGI-Super-Team at commit 331ecd3, republished under its MIT licence (© aAAaqwq). 443 words, ~1,435 tokens.

Download SKILL.mdSave it as .claude/skills/av-sync-workflow/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
av-sync-workflow
description
Audio-to-video synchronization workflow: analyze audio (beats, tempo, emotion, mood), find/match video clips to match scene and feeling, sync cuts to music beats, generate beat-marked videos. Use when user wants to: (1) turn a song into a music video, (2) sync video clips to music beats, (3) create a video that matches audio mood/scene/rhythm, (4) do beat-matching video editing. Triggers: "制作音乐视频", "音频转视频", "beat matching", "卡点视频", "音视频同步", "视频踩点", "music video creation", "sync video to audio"

AV-Sync Workflow

Transform audio into a professionally edited video synchronized to beats, mood, and scene.

Workflow Overview

Audio → Analysis → Clip Matching → Beat Sync → Video Assembly → Export

Step 1: Analyze Audio

Use scripts/audio_analysis.py to extract:

  • Beats/BPM: Timestamp of each beat, overall tempo (BPM)
  • Sections: Verse, chorus, bridge, outro markers
  • Emotion/Mood: Energy level, valence (happy/sad), tempo category
  • Key moments: High-impact points (drops, climaxes, transitions)
bash
python3 scripts/audio_analysis.py /path/to/song.mp3 --output /tmp/analysis.json

Output structure:

json
{
  "bpm": 120,
  "duration": 214,
  "beats": [0.0, 0.5, 1.0, ...],
  "sections": [
    {"type": "intro", "start": 0, "end": 15},
    {"type": "verse", "start": 15, "end": 45},
    {"type": "chorus", "start": 45, "end": 75}
  ],
  "mood": {"energy": 0.7, "valence": 0.6, "danceability": 0.8},
  "key_moments": [
    {"time": 45.0, "type": "chorus_drop", "intensity": 1.0}
  ]
}

Step 2: Gather Video Clips

User provides video clips OR search for stock footage:

Stock footage sources:

  • Pexels: https://www.pexels.com/search/videos/{query}/
  • Pixabay: https://pixabay.com/videos/search/{query}/
  • Coverr: https://coverr.co/search/{query}

Download stock video:

bash
# Via yt-dlp (for pexels/pixabay)
yt-dlp -f "best[height<=1080]" -o "/tmp/clip_%(id)s.%(ext)s" "https://pexels.com/video/12345"

# Via direct URL
ffmpeg -i "https://example.com/video.mp4" -c copy /tmp/clip.mp4

Step 3: Analyze Each Clip

For each clip, extract:

  • Scene type (indoor/outdoor, city/nature, close-up/wide)
  • Mood/style (energetic/calm, happy/sad)
  • Duration and cut points
  • Visual elements (faces, motion, colors)
bash
python3 scripts/video_analysis.py /tmp/clip.mp4 --output /tmp/clip_analysis.json

Step 4: Match Clips to Audio Sections

Algorithm: Map clips to audio sections based on:

  1. Emotion matching: High-energy chorus → energetic clips
  2. Scene continuity: Smooth transitions between scenes
  3. Beat alignment: Cut on beats for rhythm
  4. Length fit: Clip duration matches section duration
bash
python3 scripts/match_clips.py \
  --audio-analysis /tmp/analysis.json \
  --clips /tmp/clip1.mp4,/tmp/clip2.mp4 \
  --clip-analyses /tmp/clip1_analysis.json,/tmp/clip2_analysis.json \
  --output /tmp/edit_plan.json

Step 5: Generate Beat-Synced Video

bash
python3 scripts/assemble_video.py \
  --edit-plan /tmp/edit_plan.json \
  --audio /path/to/song.mp3 \
  --output /tmp/final_video.mp4 \
  --format mp4 \
  --codec h264 \
  --quality high

Reference Scripts

scripts/audio_analysis.py

Analyzes audio file using librosa. Extracts:

  • Beat timestamps (per-beat and bar-level)
  • BPM
  • Onset strength envelope
  • Spectral features for mood
  • librosa-beat-grid output option
scripts/video_analysis.py

Analyzes video clip:

  • Dominant colors / color mood
  • Scene type classification (urban, nature, indoor, etc.)
  • Motion level (static, moderate, high)
  • Detected faces / people
  • Suggested cut points (scene changes)
scripts/match_clips.py

Intelligent clip-to-audio matching:

  • Emotion/mood alignment scoring
  • Scene variety ensuring no repetitive cuts
  • Beat-synced cut point optimization
  • Output: detailed edit decision list (EDL)
scripts/assemble_video.py

Final video assembly:

  • Apply cut points from edit plan
  • Add smooth transitions (dissolve, fade)
  • Add slow-motion on climactic beats
  • Mix audio track
  • Export at specified quality
Show full SKILL.md (183 more words)Show less

Beat-Sync Cut Points

For every beat in the audio, consider:

  • Strong beat (bar 1): Major cut or transition
  • Weak beat (bar 2-4): Minor cut or no cut
  • Off-beat: Effect triggers (zoom, flash)

Standard cut cadence:

  • 4-beat bars: Cut every 4 or 8 beats
  • Chorus: Cut every 2 beats for high energy
  • Outro: Gradual slowdown, fade

Quick Start (Minimal)

If user provides just audio + one video:

bash
# 1. Detect beats
python3 scripts/audio_analysis.py song.mp3 -o beats.json

# 2. Simple beat-sync assembly
python3 scripts/simple_sync.py --audio song.mp3 --clip video.mp4 --beats beats.json -o output.mp4

Quality Settings

QualityResolutionBitrateUse Case
draft720p2MbpsQuick preview
standard1080p5MbpsSocial media
high1080p10MbpsYouTube
premium4K20MbpsFinal output

Key Notes

  • FFmpeg required: Most scripts depend on ffmpeg being installed
  • Audio duration vs video clips: If clips shorter than audio, loop or find more clips
  • BPM > 140: Consider half-time editing for drop-songs
  • Transitions: Default is cut-only (beat-sync), add dissolves for chorus sections
  • Mood input: If user specifies mood (e.g., "sad, rainy, nostalgic"), prioritize that over automatic analysis

Troubleshooting

  • No beats detected: Audio may be recorded poorly; try --spectral mode
  • Clip too short: Auto-loop small clips up to 3x original length
  • Aspect ratio mismatch: Automatically crop/pad to 16:9 or 9:16 for reels

© aAAaqwq, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (scripts, references) in skills/av-sync-workflow of aAAaqwq/AGI-Super-Team.

  • SKILL.md
  • references/beat_sync_principles.md
  • scripts/audio_analysis.py
  • scripts/simple_sync.py

Open the folder on GitHubat commit 331ecd3

Compare with similar skills

Av Sync Workflow next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Av Sync Workflow compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Av Sync Workflow this skillaAAaqwq/AGI-Super-Team105—~1.4kAutomated safety check: PassMIT
HyperFrames Animationheygen-com/hyperframes59k3 repos~2.1kAutomated safety check: PassApache-2.0
Stitch to Remotion Walkthrough Videosgoogle-labs-code/stitch-skills8.4k6 repos~3.2kAutomated safety check: NotesApache-2.0
Faceless Explainer Videoheygen-com/hyperframes59k3 repos~7.7kAutomated safety check: NotesApache-2.0
Video Understandcalesthio/OpenMontage65k—~841Automated safety check: PassAGPL-3.0
Video ShotcraftVincentwei1021/video-shotcraft11k—~2.6kAutomated safety check: PassApache-2.0

Similar skills

  • HyperFrames Animation

    heygen-com/hyperframes

    Collects motion rules, scene blueprints, transitions and runtime adapters for HyperFrames video compositions, with GSAP as the default animation runtime.

    59k GitHub starsUsed in 3 repos~2.1k tokens
    Media & CreativeAuto-check passed
  • Stitch to Remotion Walkthrough Videos

    google-labs-code/stitch-skills

    Official

    Builds walkthrough videos from Stitch design projects using Remotion, with transitions, zoom effects and text overlays on each screen.

    8.4k GitHub starsUsed in 6 repos~3.2k tokens
    Media & CreativeAuto-check: notes
  • Faceless Explainer Video

    heygen-com/hyperframes

    Turns an article, notes or a topic brief into an explainer video whose visuals are invented per scene, built frame by frame in HyperFrames with no footage.

    59k GitHub starsUsed in 3 repos~7.7k tokens
    Media & CreativeAuto-check: notes
  • Video Understand

    calesthio/OpenMontage

    Understand video content locally using ffmpeg frame extraction and Whisper transcription.

    65k GitHub stars~841 tokensUpdated 5 days ago
    Media & CreativeAuto-check passed
  • Video Shotcraft

    Vincentwei1021/video-shotcraft

    Makes cinematic product videos with Remotion from shot recipe cards, a ready template, real page screenshots, camera moves and sound design, or builds a single animated shot.

    11k GitHub stars~2.6k tokensUpdated 3 days ago
    Media & CreativeAuto-check passed
  • Figma to HyperFrames

    heygen-com/hyperframes

    Imports Figma assets, brand tokens, components and motion into a HyperFrames video composition, using the Figma REST API with a connector or native export for shaders.

    59k GitHub starsUsed in 3 repos~4.5k tokens
    Media & CreativeAuto-check: notes

More from aAAaqwq/AGI-Super-Team

All 152 skills in this repo
  • Content Creator

    aAAaqwq/AGI-Super-Team

    Create SEO-optimized marketing content with consistent brand voice.

    105 GitHub starsUsed in 3 repos~1.9k tokens
    Auto-check passed
  • Financial Calculator

    aAAaqwq/AGI-Super-Team

    Advanced financial calculator with future value tables, present value, discount calculations, markup pricing, and compound interest.

    105 GitHub starsUsed in 1 repo~1.5k tokens
    Auto-check passed
  • Frontend Design Ultimate

    aAAaqwq/AGI-Super-Team

    Create distinctive, production-grade static sites with React, Tailwind CSS, and shadcn/ui — no mockups needed.

    105 GitHub starsUsed in 2 repos~2.7k tokens
    Auto-check passed
  • Sysadmin Toolbox

    aAAaqwq/AGI-Super-Team

    Tool discovery and shell one-liner reference for sysadmin, DevOps, and security tasks.

    105 GitHub starsUsed in 2 repos~775 tokens
    Auto-check passed
  • Zsxq Smart Publish

    aAAaqwq/AGI-Super-Team

    Publish and manage content on 知识星球 (zsxq.com). An agent skill from aAAaqwq/AGI-Super-Team.

    105 GitHub stars~1.5k tokensUpdated 11 days ago
    Auto-check passed
  • Content Extract

    aAAaqwq/AGI-Super-Team

    Robust URL-to-Markdown extraction for OpenClaw workflows. An agent skill from aAAaqwq/AGI-Super-Team.

    105 GitHub starsUsed in 1 repo~650 tokens
    Auto-check passed

Questions about Av Sync Workflow

What does Av Sync Workflow do?

Audio-to-video synchronization workflow: analyze audio (beats, tempo, emotion, mood), find/match video clips to match scene and feeling, sync cuts to music beats, generate beat-marked videos. Av Sync Workflow is an agent skill from aAAaqwq/AGI-Super-Team. Audio-to-video synchronization workflow: analyze audio (beats, tempo, emotion, mood), find/match video clips to match scene and feeling, sync cuts to music beats, generate beat-marked videos.

When should I use Av Sync Workflow?

Av Sync Workflow fits situations like: turn a song into a music video; sync video clips to music beats; create a video that matches audio mood/scene/rhythm; do beat-matching video editing.

How do I install Av Sync Workflow in Claude Code?

Run `npx skills add aAAaqwq/AGI-Super-Team --skill av-sync-workflow -a claude-code`. Or copy the skill folder (skills/av-sync-workflow in aAAaqwq/AGI-Super-Team) into .claude/skills/av-sync-workflow in your project. Claude Code loads it when a task matches its description.

How do I install Av Sync Workflow in Codex?

Run `npx skills add aAAaqwq/AGI-Super-Team --skill av-sync-workflow -a codex`. Or copy the skill folder (skills/av-sync-workflow in aAAaqwq/AGI-Super-Team) into .agents/skills/av-sync-workflow in your project. Codex loads it when a task matches its description.

Can I use Av Sync Workflow in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add aAAaqwq/AGI-Super-Team --skill av-sync-workflow -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/av-sync-workflow, .gemini/skills/av-sync-workflow, .github/skills/av-sync-workflow and .opencode/skills/av-sync-workflow in your project.

What does Av Sync Workflow need to run?

Going by SKILL.md and its folder, Av Sync Workflow needs Python for the scripts in its folder and the command-line tools its instructions call (python3, yt-dlp and ffmpeg). Our summary lists: Python 3.

Does Av Sync Workflow access the network?

SKILL.md names 3 domains. In commands or code: pexels.com, pixabay.com and coverr.co; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.

Is Av Sync Workflow safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Av Sync Workflow use?

Av Sync Workflow is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Av Sync Workflow use?

About 1.4k tokens (SKILL.md is roughly 5.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 730 tokens, read only when the agent opens those files.

What are the alternatives to Av Sync Workflow?

Skills that share tags, products or a category with Av Sync Workflow: HyperFrames Animation (heygen-com/hyperframes, 59k stars), Stitch to Remotion Walkthrough Videos (google-labs-code/stitch-skills, 8.4k stars), Faceless Explainer Video (heygen-com/hyperframes, 59k stars) and Video Understand (calesthio/OpenMontage, 65k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Av Sync Workflow?

aAAaqwq (a GitHub user) maintains it in aAAaqwq/AGI-Super-Team, which has 105 GitHub stars. The repository holds 152 skills in this directory. The repository was last updated on September 27, 2026.

Source: aAAaqwq/AGI-Super-Team on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.