Communitygithub.com

muyunxue/dance-mmd-subtitle-kit

Projete e entregue maquetes de estilo de legenda e amostras de comparação animadas para vídeos de dança MMD/K-pop — catálogo de estilos S1–S6 (Y2K cromado, cinético minimalista, glitch, editorial mix&match, ênfase gráfica, marcador manual), receitas de efeitos PIL/numpy, lista de fontes, convenções de vídeo de contato/comparação e o fluxo de trabalho de subagente paralelo usado para S4 vs S6. Carregue isto ao ser solicitado "出几个静态帧方案/参考女团PV字幕/做个小样/对比几个风格" ou ao escolher uma direção visual antes de criar uma faixa de legenda completa.

O que é dance-mmd-subtitle-kit?

Esta skill é um kit completo de design e prototipagem de legendas focado em vídeos de dança MMD/K-pop, oferecendo seis estilos distintos (S1–S6) que vão desde o Y2K cromado e stickers até o minimalismo cinético, glitch futurista, editorial mix&match, ênfase gráfica e marcador manual. Ela permite gerar quadros estáticos e amostras animadas (clipes de 5s e 30s) usando apenas PIL e numpy (sem bibliotecas de IA), com funções de efeitos como texto cromado, deslocamento RGB (glitch), hachuras, estrelas/corações e ruído granuloso. A skill também define um fluxo de trabalho eficiente de subagentes paralelos: o agente principal prepara o vídeo base e a folha de dicas, enquanto subagentes independentes geram cada versão de estilo simultaneamente, sem conflitos, e o agente principal combina os resultados em vídeos de comparação e tabelas de quadros-chave. Ideal para desenvolvedores que usam agentes de IA como Claude Code, Cursor ou Codex, esta skill padroniza a entrega de legendas com qualidade profissional, garantindo conformidade com convenções de saída (resolução 2560×1080, 30fps, codec H.264) e evitando estilos rejeitados como o gótico.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/muyunxue/dance-mmd-subtitle-kit/tree/HEAD/skills/style-frames-compare

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Esquema de Estilo de Legenda / Quadro Estático / Amostra de Comparação

0. Pesquise primeiro, depois produza

Materiais públicos de legenda de PV de girl groups (tese KCI 2024 + guia de estilo K-pop Y2K Seoul):

  • Ênfase Gráfica: letras grandes com contraste grosso-fino, traços decorativos irregulares (pôsteres Blackpink / XG);
  • Mix & Match: mistura de serifa + sem serifa + condensada + itálico, sensação editorial de revista;
  • Minimalismo: sem serifa limpo, sem decoração, espaços em branco, aparecendo no ritmo (NewJeans/aespa kinetic typography);
  • Futurismo: sem serifa digital + glitch / deslocamento RGB / linhas de varredura;
  • Y2K Cromado + Stickers: chrome bubble lettering, doces (hot pink + aqua), colagem de stickers, brilhos;
  • Diário Escrito à Mão: marcador/caneta fluorescente + post-its + rabiscos (estilo juvenil NewJeans).

1. Seis estilos adaptados para o vídeo (S1–S6)

CódigoEstiloElementos-chaveAdequado para
S1Y2K Cromado + StickersGradiente cromado Bungee + emblema rosa + brilhosMais “girl group”, rosa/água pode ser trocado por roxo-rosa
S2Cinético MinimalistaAnton letras brancas grandes, deslocamento, linhas finas, Silkscreen letras pequenasVersão de letras oficial, mais estável, não sobrecarrega o fundo
S3Glitch FuturistaRubikGlitch + Anton, deslocamento RGB, linhas de varredura, cantos HUDBreak / transição
S4Mix&Match EditorialGeorgia Itálico × Bebas Neue × Archivo Black, fita adesiva, bloco de cor GO!, post-itsSensação juvenil/editorial, transição de parágrafos
S5Ênfase GráficaAnton letras enormes + contorno de sticker branco + deslocamento rosa + listrasPalavras curtas no refrão explosivo
S6Marcador/Caneta FluorescentePermanent Marker + bloco fluorescente rosa + post-its + ♥★ setasPonte / close-up decorativo

2. Produzir quadros estáticos (PIL + numpy, sem bibliotecas de IA)

Scripts:

  • 字幕\build\kpop_styles.py — seis quadros estáticos S1–S6 2560×1080 (versão 2025)
  • 字幕\build\art_frames.py — 6 esquemas de letras artísticas iniciais (fatia glitch/neon quebrado/letras 3D enormes/colagem/eco contorno/vertical)
  • 字幕\build\gothic_art.py — Gótico tela cheia (já rejeitado pelo usuário, arquivado) Diretório de fontes: 字幕\build\fonts\ (Anton, ArchivoBlack, BebasNeue, Bungee, Monoton, PermanentMarker, RubikGlitch, Silkscreen, PirataOne, UnifrakturCook) + C:\Windows\Fonts (Georgia / Georgia Itálico / Microsoft YaHei / Impact / Arial Black). Baixar fontes (Google Fonts GitHub raw disponível):
https://raw.githubusercontent.com/google/fonts/main/ofl/<family>/<File>.ttf

Funções de efeitos comuns (PIL/numpy)

  • Camada de texto: desenho letra por letra + tracking (text_img), stroke_width/stroke_fill para contorno;
  • Letras cromadas: gradiente vertical multissegmento sobre máscara alfa (gradient_fill) + faixa de realce diagonal;
  • Contorno de sticker: expandir alfa com MaxFilter(3) N vezes e depois colorir;
  • Deslocamento/glitch: deslocar canais RGB separadamente (chroma), faixas horizontais com deslocamento aleatório (glitch_slices), linhas de varredura;
  • Letras 3D: sobreposição com deslocamento múltiplo da mesma palavra, gradiente de roxo escuro a lavanda;
  • Meio-tom: grade de pontos redondos sobreposta (halftone);
  • Marcador fluorescente: retângulo arredondado semitransparente atrás do texto + GaussianBlur;
  • Post-it/fita adesiva: retângulo semitransparente + textura de linhas finas + rotação;
  • Brilhos/corações: polígono de estrela de 4 pontas, círculo duplo + coração triangular;
  • Grão: np.random.normal sobreposto com 1–3 níveis de antidithering.

3. Amostras animadas (ASS animation)

  • 5s três estilos: 字幕\build\styles_anim.py → 公众号/输出/字幕风格参考/小样_S2_5s.mp4 etc.;
  • S4/S6 30s: 字幕\输出\S4S6_30s\ (dois subagentes cada um faz uma versão, veja abaixo);
  • EXPLOSÃO FLARE: flare.py + flare_video.py; neon: neon_wide.py;
  • Evitar neon completamente: avoid_side2.py.
  • Truques de animação: impacto (\fscx118→100 + \t + \blur), rotação de letras que caem (\frz + \t), deslizar (\move), fade-in, bloco de cor escala/varredura (\p1 + \fscx), post-it sobe, pulso na batida (a cada 0.447s um pulso de 134 BPM).

4. Especificações de entrega de comparação

  • Amostra única: 2560×1080 / 30fps / H.264 crf16 / faststart; 30s = 900 quadros, 5s = 150 quadros.
  • Vídeo de comparação: empilhamento vertical vstack, cada faixa reduzida para 1280×540, saída 1280×1080 (ou 3 faixas → 1280×1620), sobrepor etiquetas com ASS.
  • Tabela de quadros-chave: mosaico 2×2 / 2×3 / 3×3, cada célula 853×360 ou 1280×540, com nome do estilo e rótulo de tempo.
  • MD de descrição: descrição do estilo + tabela de arquivos + linha do tempo + limitações conhecidas.
  • Exemplo: 字幕\输出\字幕风格参考\ (6 estilos estáticos + comparação S2/S4/S6 5s), 字幕\输出\S4S6_30s\ (duas versões 30s + comparação).

5. Fluxo de trabalho de subagentes paralelos ("Subagentes trabalharem separadamente")

  1. Agente principal prepara vídeo base compartilhado (cortado + levemente escurecido) → _base_30s.mp4; copia fonts/ para o diretório de saída; escreve a folha de dicas (tempo relativo).
  2. Cada estilo um subagente, prompt deve incluir:
    • Caminho absoluto do vídeo base, diretório de saída, nome do arquivo de saída (S4_30s.mp4 / S6_30s.mp4);
    • Diretório de fontes, caminho do ffmpeg, regras rígidas do ASS (formato de tempo, valor de cor do Style sem & no final, fontsdir relativo, nome de arquivo ASCII);
    • Linha do tempo frase por frase (8 frases) + descrição de estilo + restrição "sem chinês / não cobrir rosto";
    • Requisitos de auto-verificação (ffprobe 30s, extrair quadros para ver letras, sem chinês, rosto limpo).
  3. Subagentes escrevem apenas arquivos com seu próprio prefixo, sem sobrescrever; ao terminar, relatam layout/efeitos/dificuldades.
  4. Agente principal, ao receber tudo: s4s6_compare.py sintetiza vídeo de comparação + tabela de quadros-chave + MD de descrição unificado; depois extrai quadros e verifica novamente.

6. Recomendações de seleção (palco roxo-rosa neon + personagem com asas)

  • Mais estável: S2 Cinético Minimalista;
  • Mais girl group: S1 Y2K Cromado (trocar cor para tema roxo-rosa);
  • Transição de parágrafos: S4 Mix&Match; explosão: S5; ponte/close-up: S6; break: S3.
  • Usuário já rejeitou explicitamente: gótico tela cheia, esquema de cores vermelho-sangue. Não faça mais direção gótica.

7. Lista de verificação de entrega

  • Quadros estáticos são 2560×1080, sem erros de chinês
  • Duração da amostra animada correta no ffprobe (5.000/30.000)
  • Extrair quadros confirma legenda aparece, não cobre rosto, sem chinês
  • Vídeo de comparação + tabela de quadros-chave + MD de descrição completos
  • Nome do estilo/nome do arquivo uniforme (S4_30s.mp4, 对比_S4S6_30s.mp4)

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

muyunxue/dance-mmd-subtitle-kit

Hard rules, templates, ffmpeg commands and failure diagnosis for authoring ASS/SSA subtitles and burning them with libass on this machine. Load this before writing any ASS file, when a burn "succeeds" but no text appears, when text is misplaced/too big, when \p1 drawings are offset, or when you need the transparent-overlay export recipe. Contains the exact pitfalls hit in this project (timestamp format, style colour trailing ampersand, fontsdir, drawing anchor, chained \t, Permanent Marker sizing).

muyunxue/dance-mmd-subtitle-kit

Character-avoiding subtitle layout for the MMD dance videos — measure the dancer's per-frame bounding box, compute a per-cue union, place text in safe side/top columns, and verify zero overlap on every frame. Load this when asked 字幕不要挡住人物/完全不挡/避让, or when text overlaps wings/body and you need a verified-free layout with measured overlap counts.

muyunxue/dance-mmd-subtitle-kit

End-to-end recipe for making subtitles for the MMD dance videos in this workspace (字幕/ project) — probe the source, pick a segment, map LRC cues, choose a style, build ASS, burn, verify, and deliver. Load this when starting or resuming any subtitle task (静态稿/5s小样/30s小样/全片/透明叠加层), when a render "succeeded" but the video has no text, or when you need this project's paths, font list, cue sheet and acceptance criteria.

muyunxue/dance-mmd-subtitle-kit

Subject-aware colour grading for the MMD dance videos in this workspace — make the dancer stand out (background dim/cool/desat, subject lift/warm/sharpen/bloom) using either a soft stage-light ellipse or a hard character matte, with ffmpeg recipes, measured parameter sets and known failure modes (cast-shadow matte contamination, banding, truncated sources). Load this when asked to 调色/突出人物/压背景/统一色调, or when a graded clip shows weird bright blobs around the dancer.

Habilidades Relacionadas