convez.ai
SkillAutomaçãoIntermediário
artemnovitckii

Analyze — Breakdown de Vídeos Curtos

artemnovitckii/analyze-skill

Analisa vídeos curtos com transcrição de áudio real e breakdown estruturado

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill para Claude Code que analisa vídeos curtos (TikTok, Reels, Shorts) com um único comando. Faz download via yt-dlp, transcreve áudio com Groq Whisper (mesmo sem legendas) e gera breakdown completo: hook, estrutura de script, fatores virais e ângulos de reescrita.

Instalação

$npx convez-ai artemnovitckii/analyze-skill

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
7
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 4 meses
Versão
—
Issues abertas
0
Contribuidores
2

Casos de uso

  • Descomplicar estratégia de vídeos virais em redes sociais
  • Transcrever e analisar conteúdo mesmo sem legendas disponíveis
  • Estudar estrutura e fatores de sucesso de vídeos alheios

Veredito

Ferramenta sólida e bem documentada para quem trabalha com conteúdo em vídeo. O instalador one-command é eficiente, a transcrição via Groq é confiável, e o breakdown estruturado agrega valor real. Requer apenas ffmpeg + chave Groq gratuita.

README

A tradução para o português deste README ainda está na fila.

analyze — short-form video breakdown for Claude Code

Paste a TikTok / Instagram Reels / YouTube Shorts link and get a full breakdown of why it works: the data panel, the hook, script structure, style tags, viral factors, and rewrite angles. It downloads the video and transcribes the actual audio with Groq Whisper — so it works even on videos with no captions.


Install (one command)

In a terminal:

git clone https://github.com/artemnovitckii/analyze-skill && bash analyze-skill/install.sh

The installer copies the skill + /analyze command into ~/.claude/, vendors a private self-updating yt-dlp into the skill, installs ffmpeg + the groq package, verifies everything runs, and prompts you to paste a free Groq API key (get one at https://console.groq.com/keys). Then restart Claude Code.

Hands-off / non-interactive install

Pass the key as a flag (no prompt) — handy when you ask Claude Code to install it for you:

git clone https://github.com/artemnovitckii/analyze-skill && \
  bash analyze-skill/install.sh --key gsk_yourkey

A GROQ_API_KEY environment variable works the same way. Either is saved to ~/.claude/skills/analyze/.groq_key (chmod 600) — a skill-local file, not ~/.zshrc. This matters: Claude Code runs each command in a non-interactive shell that does not source ~/.zshrc, so a key exported there is invisible to the skill. The local file always works.

Prefer an env var at runtime? Set GROQ_API_KEY in ~/.claude/settings.json under an "env": { ... } block (Claude Code injects that into every command). A GROQ_API_KEY environment variable takes precedence over the .groq_key file.

Use

Either type the command:

/analyze https://www.tiktok.com/@user/video/123...

…or just paste a video URL and ask "why does this work?" — the skill auto-triggers.

Requirements

  • ffmpeg — brew install ffmpeg (macOS) or sudo apt install ffmpeg (Linux). The installer warns you if it's missing.
  • Python 3 with pip (the installer handles the yt-dlp + groq packages).
  • A Groq API key (free).

What got installed

PieceLocation
Skill~/.claude/skills/analyze/
/analyze command~/.claude/commands/analyze.md

To uninstall: delete those two paths.

Ver o original no GitHub

Bom para

Relacionados