Communitygithub.com

Biznomad/agent-skills

Esta habilidade deve ser usada ao comparar dois vídeos para analisar resultados de compressão ou diferenças de qualidade. Gera relatórios HTML interativos com métricas de qualidade (PSNR, SSIM) e comparações visuais quadro a quadro. É acionada quando os usuários mencionam 'comparar vídeos', 'qualidade de vídeo', 'análise de compressão', 'antes/depois da compressão' ou solicitam avaliação de qualidade de vídeos comprimidos.

O que é agent-skills?

O Biznomad/agent-skills é uma habilidade especializada para agentes de IA (como Claude Code ou Cursor) que automatiza a comparação de vídeos e a análise de qualidade de compressão. Ela gera relatórios HTML interativos e autocontidos, extraindo metadados dos vídeos e calculando métricas padronizadas de qualidade (PSNR e SSIM). A ferramenta também cria uma comparação visual quadro a quadro com três modos de visualização: controle deslizante, lado a lado e grade, facilitando a inspeção detalhada dos resultados da compressão. Suporta os formatos de vídeo mais comuns (MP4, MOV, AVI, MKV, WEBM) e exige que FFmpeg/FFprobe e Python 3.8+ estejam instalados. Seu principal caso de uso é permitir que agentes de IA analisem rapidamente o impacto de diferentes codecs, taxas de bits ou configurações de compressão na qualidade final do vídeo, auxiliando engenheiros e profissionais de mídia a tomar decisões informadas.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Biznomad/agent-skills/tree/HEAD/video-comparer

Perguntar na sua IA favorita

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

Documentação

Video Comparer

Visão Geral

Compara dois vídeos e gera um relatório HTML interativo para analisar resultados de compressão. O script extrai metadados dos vídeos, calcula métricas de qualidade (PSNR, SSIM) e cria comparações visuais quadro a quadro com três modos de visualização: controle deslizante, lado a lado e grade.

Quando Usar Esta Habilidade

Use esta habilidade quando:

  • Comparar vídeos original e comprimido
  • Analisar a qualidade e eficiência da compressão de vídeo
  • Avaliar o desempenho de codecs ou o impacto da redução de taxa de bits
  • Usuários mencionarem "comparar vídeos", "qualidade de vídeo", "análise de compressão" ou "antes/depois da compressão"

Uso Principal

Comando Básico

python3 scripts/compare.py original.mp4 compressed.mp4

Gera comparison.html com:

  • Parâmetros do vídeo (codec, resolução, taxa de bits, duração, tamanho do arquivo)
  • Métricas de qualidade (PSNR, SSIM, porcentagens de redução de tamanho/taxa de bits)
  • Comparação quadro a quadro (padrão: quadros em intervalos de 5s)

Opções de Comando

# Arquivo de saída personalizado
python3 scripts/compare.py original.mp4 compressed.mp4 -o report.html

# Intervalo de quadros personalizado (maior = menos quadros, processamento mais rápido)
python3 scripts/compare.py original.mp4 compressed.mp4 --interval 10

# Comparação em lote
for original in originals/*.mp4; do
    compressed="compressed/$(basename "$original")"
    output="reports/$(basename "$original" .mp4).html"
    python3 scripts/compare.py "$original" "$compressed" -o "$output"
done

Requisitos

Dependências do Sistema

FFmpeg e FFprobe (necessários para análise de vídeo e extração de quadros):

# macOS
brew install ffmpeg

# Ubuntu/Debian
sudo apt update && sudo apt install ffmpeg

# Windows
# Baixe de https://ffmpeg.org/download.html
# Ou use: winget install ffmpeg

Python 3.8+ (usa type hints, f-strings, pathlib)

Especificações de Vídeo

  • Formatos suportados: .mp4 (recomendado), .mov, .avi, .mkv, .webm
  • Limite de tamanho de arquivo: 500MB por vídeo (configurável)
  • Tempo de processamento: ~1-2 minutos para vídeos típicos; varia conforme duração e intervalo de quadros

Comportamento do Script

Validação Automática

O script valida automaticamente:

  • Instalação e disponibilidade do FFmpeg/FFprobe
  • Existência dos arquivos, extensões e limites de tamanho
  • Segurança de caminhos (impede traversal de diretórios)

Mensagens de erro claras com orientações de resolução são exibidas quando a validação falha.

Métricas de Qualidade

O script calcula duas métricas de qualidade padrão:

PSNR (Peak Signal-to-Noise Ratio): Medição de similaridade em nível de pixel (escala de 20-50 dB, quanto maior melhor)

SSIM (Structural Similarity Index): Medição de similaridade perceptual (escala de 0,0 a 1,0, quanto maior melhor)

Para escalas de interpretação detalhadas e limites de qualidade, consulte references/video_metrics.md.

Extração de Quadros

O script extrai quadros em intervalos especificados (padrão: 5 segundos), redimensiona-os para uma altura consistente (800px) para comparação e os incorpora como URLs de dados base64 no HTML autocontido. Arquivos temporários são automaticamente limpos após o processamento.

Relatório de Saída

O relatório HTML gerado inclui:

  • Modo Controle Deslizante: Arraste para revelar original vs comprimido (padrão)
  • Modo Lado a Lado: Exibição simultânea para comparação direta
  • Modo Grade: Layout compacto de 2 colunas
  • Controles de Zoom: Ampliação de 50% a 200%
  • Formato autocontido (não requer servidor, funciona offline)

Detalhes Importantes de Implementação

Segurança

O script implementa:

  • Validação de caminhos (caminhos absolutos, impede traversal de diretórios)
  • Prevenção de injeção de comandos (sem shell=True, argumentos validados)
  • Limites de recursos (tamanho de arquivo, timeouts)
  • Exceções personalizadas: ValidationError, FFmpegError, VideoComparisonError

Cenários de Erro Comuns

"FFmpeg não encontrado": Instale o FFmpeg via gerenciador de pacotes da plataforma (consulte a seção Requisitos)

"Arquivo muito grande": Comprima os vídeos antes da comparação, ou ajuste MAX_FILE_SIZE_MB em scripts/compare.py

"Operação excedeu o tempo limite": Aumente a constante FFMPEG_TIMEOUT ou use um valor maior para --interval (processa menos quadros)

"Incompatibilidade na contagem de quadros": Os vídeos têm durações/taxas de quadros diferentes; o script trunca automaticamente para o número mínimo de quadros e exibe um aviso

Configuração

O script inclui constantes ajustáveis para limites de tamanho de arquivo, timeouts, dimensões de quadros e intervalos de extração. Para personalizar o comportamento, edite as constantes no início de scripts/compare.py. Para opções de configuração detalhadas e seus impactos, consulte references/configuration.md.

Materiais de Referência

Consulte estes arquivos para informações detalhadas:

  • references/video_metrics.md: Interpretação de métricas de qualidade (escalas PSNR/SSIM, alvos de compressão, diretrizes de taxa de bits)
  • references/ffmpeg_commands.md: Referência de comandos FFmpeg (extração de metadados, extração de quadros, solução de problemas)
  • references/configuration.md: Opções de configuração do script e constantes ajustáveis
  • assets/template.html: Template do relatório HTML para personalizar modos de visualização e estilo

Individual skills in this repo

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

Biznomad/agent-skills

Landing page quality assessment for paid advertising campaigns. Evaluates message match, page speed, mobile experience, trust signals, form optimization, and conversion rate potential. Use when user says "landing page", "post-click experience", "landing page audit", "conversion rate", or "landing page optimization".

Biznomad/agent-skills

TikTok Ads deep analysis covering creative quality, tracking, bidding, campaign structure, and TikTok Shop. Evaluates 25 checks with emphasis on creative-first strategy, safe zone compliance, and Smart+ campaigns. Use when user says "TikTok Ads", "TikTok marketing", "TikTok Shop", "Spark Ads", "Smart+", or "TikTok campaign".

Biznomad/agent-skills

YouTube Ads specific analysis covering campaign types, creative quality, audience targeting, and measurement. Evaluates video ad performance across skippable, non-skippable, bumper, Shorts, and Demand Gen formats. Use when user says "YouTube Ads", "video ads", "pre-roll", "bumper ads", "YouTube campaign", or "Shorts ads".

Biznomad/agent-skills

Help users get promoted at work. Use when someone is preparing for a promotion conversation, building their case for advancement, trying to understand what's blocking their promotion, or figuring out how to get to the next level in their career.

Biznomad/agent-skills

CSS animation adapter patterns for HyperFrames. Use when authoring CSS keyframes, animation-delay based timing, animation-fill-mode, animation-play-state, or CSS-only motion that HyperFrames must seek deterministically during preview and rendering.

Biznomad/agent-skills

Video and audio processing with FFmpeg. Use for format conversion, resizing, compression, audio extraction, and preparing assets for Remotion. Triggers include converting GIF to MP4, resizing video, extracting audio, compressing files, or any media transformation task.

Biznomad/agent-skills

Read-only queue dashboard for workspace-aware ship. Shows which VERSION slots are currently claimed by open PRs, which sibling Conductor workspaces have WIP work likely to ship soon, and what slot /ship would pick next. No mutations — just a snapshot. Use when asked to "landing report", "what's in the queue", "show me open PRs", or "which version do I claim next". (gstack)

Biznomad/agent-skills

HyperFrames CLI dev loop — `npx hyperframes` for scaffolding (init), validation (lint, inspect), preview, render, and environment troubleshooting (doctor, browser, info, upgrade). Use when running any of these commands or troubleshooting the HyperFrames build/render environment. For asset preprocessing commands (`tts`, `transcribe`, `remove-background`), invoke the `hyperframes-media` skill instead.

Biznomad/agent-skills

Asset preprocessing for HyperFrames compositions — text-to-speech narration (Kokoro), audio/video transcription (Whisper), and background removal for transparent overlays (u2net). Use when generating voiceover from text, transcribing speech for captions, removing the background from a video or image to use as a transparent overlay, choosing a TTS voice or whisper model, or chaining these (TTS → transcribe → captions). Each command downloads its own model on first run.

Biznomad/agent-skills

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, and registry discovery.

Biznomad/agent-skills

Create video compositions, animations, title cards, overlays, captions, voiceovers, audio-reactive visuals, and scene transitions in HyperFrames HTML. Use when asked to build any HTML-based video content, add captions or subtitles synced to audio, generate text-to-speech narration, create audio-reactive animation (beat sync, glow, pulse driven by music), add animated text highlighting (marker sweeps, hand-drawn circles, burst lines, scribble, sketchout), or add transitions between scenes (crossfades, wipes, reveals, shader transitions). Covers composition authoring, timing, media, and the full video production workflow. For dev-loop CLI commands (init, lint, inspect, preview, render) see the hyperframes-cli skill; for asset preprocessing commands (tts, transcribe, remove-background) see the hyperframes-media skill.

Biznomad/agent-skills

Still-to-video conversion guide: model selection, motion prompting, and camera movement. Covers Wan 2.5 i2v, Seedance, Fabric, Grok Video with when to use each. Use for: animating images, creating video from stills, adding motion, product animations. Triggers: image to video, i2v, animate image, still to video, add motion to image, image animation, photo to video, animate still, wan i2v, image2video, bring image to life, animate photo, motion from image

Biznomad/agent-skills

>- The Landing Page Audit skill performs comprehensive evaluations of post-click experiences, combining technical performance analysis with conversion rate optimization (CRO) assessment.

Biznomad/agent-skills

Write high-converting landing page copy using proven frameworks like PAS (Problem-Agitate-Solution), AIDA, and StoryBrand. Creates headlines, value propositions, CTAs, and full page sections optimized for conversion. Use when users need landing page copy, sales page content, or marketing website text.

Biznomad/agent-skills

Optimize landing pages for higher conversion rates using proven frameworks and design patterns. Use when designing, reviewing, or improving landing pages, hero sections, pricing pages, CTAs, or when the user asks about conversion optimization.

Biznomad/agent-skills

Read-only queue dashboard for workspace-aware ship. (gstack)

Biznomad/agent-skills

Building promotion cases, brag documents, tracking wins, and self-advocacy for career advancement. Use when preparing for promotions, documenting accomplishments, or building your case for advancement.

Biznomad/agent-skills

Best practices for Remotion - Video creation in React

Biznomad/agent-skills

Translate an existing Remotion (React-based) video composition into a HyperFrames HTML composition. Use ONLY when the user explicitly asks to port, convert, migrate, translate, or rewrite a Remotion composition as HyperFrames (e.g. "port my Remotion project to HyperFrames"). Do NOT use when (a) authoring a NEW HyperFrames composition (even if A/B-testing a Remotion video); (b) Remotion is mentioned in passing; (c) Remotion code is shared as reference, not for translation; (d) the user wants "the same video as my Remotion one" without explicitly asking to migrate the source — treat as a fresh HyperFrames build. When in doubt, default to the `hyperframes` skill. Detects unsupported patterns (useState, useEffect side effects, async calculateMetadata, third-party React component libraries, `@remotion/lambda`) and recommends the runtime interop escape hatch instead of a lossy translation.

Biznomad/agent-skills

Produce programmable videos with Remotion using scene planning, asset orchestration, and validation gates for automated, brand-consistent video content.

Habilidades Relacionadas