Communitygithub.com

daymade/claude-code-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 o usuário menciona "comparar vídeos", "qualidade de vídeo", "análise de compressão", "antes/depois da compressão" ou solicita avaliação de qualidade de vídeos comprimidos.

O que é claude-code-skills?

Esta habilidade, intitulada 'Video Comparer', permite comparar dois vídeos (original e comprimido) e gerar um relatório HTML interativo que analisa os resultados da compressão. Ela extrai metadados dos vídeos, calcula métricas de qualidade padrão como PSNR e SSIM, e cria uma comparação visual quadro a quadro com três modos de visualização: controle deslizante, lado a lado e grade. A habilidade é útil para desenvolvedores e analistas de qualidade de vídeo que precisam avaliar o impacto de codecs, redução de bitrate ou parâmetros de compressão. Ela é suportada em plataformas como Claude Code, Cursor e Codex, e depende do FFmpeg/FFprobe para análise de vídeo. Seu funcionamento é baseado em um script Python que extrai quadros em intervalos configuráveis, calcula métricas e incorpora tudo em um relatório HTML autocontido, incluindo validações de segurança e tratamento de erros.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/daymade/claude-code-skills/tree/HEAD/video-comparer

Perguntar na sua IA favorita

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

Documentação

Comparador de Vídeos

Visão Geral

Compare dois vídeos e gere um relatório HTML interativo analisando os resultados da 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 bitrate
  • 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, bitrate, duração, tamanho do arquivo)
  • Métricas de qualidade (PSNR, SSIM, porcentagens de redução de tamanho/bitrate)
  • Comparação quadro a quadro (padrão: quadros a cada 5 segundos)

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 do arquivo, extensões e limites de tamanho
  • Segurança do caminho (previne directory traversal)

Mensagens de erro claras com orientações de resolução aparecem 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-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 altura consistente (800px) para comparação e incorpora-os como URLs de dados base64 em 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: Magnificação de 50%-200%
  • Formato autocontido (não requer servidor, funciona offline)

Detalhes de Implementação Importantes

Segurança

O script implementa:

  • Validação de caminho (caminhos absolutos, previne directory traversal)
  • 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 expirou": 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 truncará automaticamente para a contagem mínima de quadros e exibirá 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 topo 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 de PSNR/SSIM, alvos de compressão, diretrizes de bitrate)
  • 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: Modelo de relatório HTML para personalizar modos de visualização e estilo

Individual skills in this repo

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

daymade/claude-code-skills

>- Generates Chinese/Japanese speech with StepFun's Contextual TTS — default stepaudio-2.5-tts, stepaudio-3-tts for whisper/inline-() prosody. Replaces step-tts-2's voice_label with natural-language instruction. Use for emotional/prosody-controlled synthesis, batch voice lines, migrating from step-tts-2, or cloned voices (2.5/step-tts-2, not v3). Triggers on 阶跃 TTS, 语音合成, 配音. Not for transcription (use stepfun-asr).

daymade/claude-code-skills

Download YouTube videos and HLS streams (m3u8) from platforms like Mux, Vimeo, etc. using yt-dlp and ffmpeg. Use this skill when users request downloading videos, extracting audio, handling protected streams with authentication headers, or troubleshooting download issues like nsig extraction failures, 403 errors, or cookie extraction problems.

daymade/local-conversation-history

Entry point for local AI conversation history across providers. Routes a request to the one skill that owns it, by platform (Claude Code, OpenAI Codex, Kimi CLI) and action (read evidence vs continue interrupted work), and owns the one job none of them own alone: a single inventory spanning all three providers. Use when the provider is unknown or plural ("our history", "what have I been working on", "which chats did I have"), when the user wants Kimi CLI history at all, when it is unclear whether they need evidence or resumption, or when they ask for this skill by name. Vague recall that names no platform ("we discussed this once, when was it?") belongs here rather than to a single-provider reader, because a Claude-only answer to an unscoped question cannot support an absence claim. When the platform and the action are both already clear, load that executor skill directly instead — except Kimi CLI, which has no reader or continuation skill of its own and always routes through here.

daymade/ppt-creator

Create professional slide decks from topics or documents. Generates structured content with data-driven charts, speaker notes, and complete PPTX files. Applies persuasive storytelling principles (Pyramid Principle, assertion-evidence). Supports multiple formats (Marp, PowerPoint). Use for presentations, pitches, slide decks, or keynotes.

daymade/prompt-optimizer

Transform vague prompts into precise, well-structured specifications using EARS (Easy Approach to Requirements Syntax) methodology. This skill should be used when users provide loose requirements, ambiguous feature descriptions, or need to enhance prompts for AI-generated code, products, or documents. Triggers include requests to "optimize my prompt", "improve this requirement", "make this more specific", or when raw requirements lack detail and structure.

daymade/qa-expert

This skill should be used when establishing comprehensive QA testing processes for any software project. Use when creating test strategies, writing test cases following Google Testing Standards, executing test plans, tracking bugs with P0-P4 classification, calculating quality metrics, or generating progress reports. Includes autonomous execution capability via master prompts and complete documentation templates for third-party QA team handoffs. Implements OWASP security testing and achieves 90% coverage targets.

daymade/read-claude-code-history

Reads, searches, and exports local Claude Code history without resuming work. Covers recent session inventory, exact session timelines, verbatim human input including queued mid-turn prompts, full-event keyword search, hybrid recall when wording changed, end-state triage, and deleted-file recovery across active Claude homes plus registered archives. Use whenever the user asks what they or Claude said, wants a Claude Code session ID or original context, remembers prior work vaguely, needs an old file from a transcript, or must prove what a Claude session contained before continuing it. Also owns the only Kimi CLI surface, via its Kimi inventory and search flags. For Codex history use read-codex-history; when the request names no platform at all or spans providers, start at local-conversation-history.

daymade/read-codex-history

Reads, searches, and exports local OpenAI Codex history without continuing the old task. Lists recent Codex sessions, extracts exact prompt-ledger inputs by Session, locates a rollout by verified session_meta identity, reconstructs one chronological user/assistant timeline with fork and compaction lineage, and performs bounded keyword search across live and archived rollouts. Use whenever the user asks what they told Codex, wants recent original inputs, a Codex Session ID, full prior context, fork ancestry, or evidence of what a Codex run did. For Claude Code history use read-claude-code-history.

daymade/twitter-reader

Fetch Twitter/X post content including long-form Articles with full images and metadata. Use when Claude needs to retrieve tweet/article content, author info, engagement metrics, and embedded media. Supports individual posts and X Articles (long-form content). Automatically downloads all images to local attachments folder and generates complete Markdown with proper image references. Preferred over Jina for X Articles with images.

Habilidades Relacionadas