Communitygithub.com

Conz-Wilts/ai-editor

Para os mantenedores do editor. Transforma as correções dos usuários em correções duradouras neste repositório, para todos os usuários, impostas por código e testes, não por anotações.

O que é ai-editor?

Esta skill foi criada para os mantenedores do AI Video Editor. Ela lê sugestões dos usuários marcadas como "ajudaria todo mundo", regras relatadas duas vezes pelo sistema de taste, correções de preview, anotações de revisão e issues do GitHub marcadas como feedback. A skill agrupa repetições e, para cada item aceito pelo mantenedor, escreve a regra geral no PRINCIPLES.md e na skill responsável, adiciona ou aperta a verificação que a impõe, adiciona um teste que falha antes e passa depois, e executa a suíte completa de testes. Use quando o mantenedor disser "melhore o editor", "transforme feedback em correções", "processe sugestões", "do que os usuários estão reclamando" ou "revise as issues de feedback". Não use para preferências pessoais de um único usuário (isso é taste) nem para editar um vídeo.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Conz-Wilts/ai-editor/tree/HEAD/.claude/skills/improve

Perguntar na sua IA favorita

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

Documentação

Melhorar

Caminhos: ${CLAUDE_SKILL_DIR} significa a pasta que contém este SKILL.md, e ${CLAUDE_SKILL_DIR}/../.. é a pasta .claude/ do editor dois níveis acima.

Toda pergunta ao usuário vai na caixa de perguntas: chame a ferramenta AskUserQuestion (2-4 opções, a recomendada primeiro). Apenas em um agente sem essa ferramenta, faça perguntas numeradas em texto.

Isso é executado em um checkout do repositório, para a pessoa que o mantém. Uma correção aqui alcança todos os usuários na próxima atualização. S="${CLAUDE_SKILL_DIR}/scripts". Execute os scripts com python3 no Mac e Linux, py no Windows.

0. Quem está executando isso

python3 "$S/improve.py" mode

maintainer apenas em um checkout git do repositório com AI_EDITOR_MAINTAINER=1: vá para o passo 1.

user: os arquivos do próprio editor são substituídos a cada atualização, então nunca os edite (nenhum SKILL.md, referência, script ou PRINCIPLES.md). Colete e selecione como abaixo, depois salve cada item aceito na camada do próprio usuário, que as atualizações nunca tocam (docs/customise.md no repositório): uma configuração com taste.py add ... --set; uma regra de palavra com python3 "${CLAUDE_SKILL_DIR}/../../lib/ai_editor/custom.py" rule "<rule>"; uma aparência de legenda como custom/captions/<name>.json mais taste.py set captions.preset <name>; padrões de template como custom/templates/<type>.json. Depois ofereça taste.py suggest para que os mantenedores possam corrigir para todos. Pare por aí.

1. Coletar

python3 "$S/improve.py" collect [--edits D] [--no-gh]

Uma regra por linha, as mais repetidas primeiro: vezes que apareceu, de onde (sugestão, regressão de taste, correção de preview, nota de revisão, issue do GitHub), o dono nomeado e até três exemplos. Uma regra dita por vários usuários, ou dita novamente depois de aplicada, vem primeiro.

2. Escolher

Mostre o topo da fila e pergunte na caixa de perguntas qual corrigir agora (seleção múltipla, a mais repetida primeiro, recomendada). Para cada uma, também pergunte quando não estiver claro: Todo usuário (Recomendado) / Apenas alguns estilos de criadores (pertence a um campo em style.json, não a uma regra) / Não é uma correção (feche-a).

3. Corrigir cada uma, nesta ordem

  1. A regra. Uma linha em ${CLAUDE_SKILL_DIR}/../../PRINCIPLES.md sob o cabeçalho correto, nomeando onde é imposta, e a mesma regra no SKILL.md ou referência dona. Geral, nunca sobre um único vídeo: "Zooms suavizam por pelo menos 0,5 s", não "o zoom em 0:12 estalou".
  2. A imposição. O menor código que faz a regra valer sem que ninguém precise lembrar dela: uma FALHA em uma verificação (check.py, quality.py, product.py check, ai_tells.py), uma recusa no script que a quebraria (gates.py), um padrão que não pode produzi-la, ou uma linha em tests/check_plugins.py para uma regra do repositório. Prefira apertar uma verificação existente a adicionar uma nova.
  3. O teste. Um assert no demo() desse script (ou em tests/), construído a partir de um pequeno exemplo sintético da falha. Execute-o antes da correção e veja falhar, depois e veja passar. Uma regra que apenas um agente pode seguir (perguntando, explicando) ganha um caso de eval em evals/ em vez disso: prompt.md mais um avaliador tool_used ou llm.
  4. O registro. docs/feedback-matrix.md: a regra, onde está escrita, o que a impõe, quais testes a verificam.

4. Executar tudo

python3 tests/check_plugins.py
python3 .claude/lib/ai_editor/okf.py check

Depois tests/demos.sh (demo de cada script), node tests/test_record.mjs, e quando o renderizador estiver configurado tests/smoke.py e tests/golden.py. Tudo verde antes de entregar. Não faça commit; o mantenedor revisa o diff e faz o commit.

Em uma issue do GitHub que agora está corrigida, ofereça comentar um resumo de uma linha da correção e fechá-la (gh issue close <n> --comment "..."), apenas depois de perguntar.

Nunca

  • Nunca edite o taste.md, taste.json, rules.json ou suggestions.jsonl de um usuário: são dele.
  • Nunca coloque dados pessoais no repositório: nenhum nome, usuário, email, nome de arquivo ou filmagem do feedback. Escreva a regra geral e um exemplo sintético. tests/check_plugins.py falha em nomes privados conhecidos; leia cada exemplo antes de inseri-lo.
  • Nunca feche o ciclo com apenas uma anotação. Uma regra sem imposição e sem teste não está pronta.

Arquivos

  • scripts/improve.py: mode, collect, demo. Apenas leitura.
  • ${CLAUDE_SKILL_DIR}/../../lib/ai_editor/custom.py: a pasta <library>/custom/ do usuário (modo usuário escreve lá).
  • ${CLAUDE_SKILL_DIR}/../../skills/taste/scripts/taste.py: onde suggest e issue escrevem o lado do usuário.

Individual skills in this repo

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

Conz-Wilts/ai-editor

Turns one long video or podcast (a local file or a YouTube link) into the best 3-5 short vertical clips, each cut and styled in the user's profile style. Transcribes once, splits the talk into candidate clips at sentence boundaries inside the chosen length, scores every candidate in code (speech rate, loudness, laughter, numbers and names said), shows the shortlist on one page with a preview of each, then trims, cuts and style-edits each pick as its own edit. Use when the user says "clip this video", "make shorts from my podcast", "find the best clips", "cut this into TikToks", "turn this YouTube video into reels", "repurpose this long video", or drops a long video (over about 3 minutes) or a YouTube link and wants short clips. Not for editing one short take (that is start or cut), and not for measuring someone else's style (that is creator-teardown).

Conz-Wilts/ai-editor

Reverse-engineers a short-form creator's video format from their real numbers. Pulls a TikTok or YouTube Shorts profile (or pasted links, Instagram reels too) with view, like and save counts, transcribes the top videos word for word, measures pace, pauses and fillers, maps each video into timed beats, and writes a teardown.md someone can film from, a teardown.html page of their graphics, motion and sound, and the style.json the style-edit skill edits from (on its own it can write an edit plan as a table and .srt). Use when the user wants to analyse, break down or study a creator ("analyse @handle", "tear down @handle", "teardown of @handle", "break down this creator", "what makes this creator's videos work"), pastes TikTok, YouTube or Instagram links and asks what the pattern is, or asks to set up creator-teardown. Not for editing the user's own video like a creator (that is start), not for researching a topic, and not for cutting raw footage.

Conz-Wilts/ai-editor

Cuts raw talking-head footage into a clean jump cut. Takes one take or several joined (mp4 or mov, any aspect, 4K phone footage is fine), transcribes it word by word, removes retakes, false starts, fillers and dead pauses, and renders cut.mp4 at the source resolution plus words.json timed to the cut. The user approves the cut on a page with the whole transcript and every removed word struck through. Use when the user says "cut my video", "just cut it", "remove my mistakes", "cut out the retakes", "remove the pauses", "clean up this take", "jump cut this", "tighten this clip", or asks only for the cut of a raw take; start calls it for a full edit. Runs before style-edit. Not for a general request to edit a video or to make it look like a creator (that is start), not for adding captions, zooms or cards (style-edit), and not for analysing someone else's videos (creator-teardown).

Conz-Wilts/ai-editor

Generates new footage with Higgsfield and puts it on the edit's timeline. Prices every generation first, asks the user with the dollar amount (and, for their own footage, whether it may be uploaded to Higgsfield), then submits, waits, downloads into the edit's generated/ folder and adds the result to the timeline's Generated track. Covers motion transfer on a clip of the user's video (their moves onto a character or styled look), b-roll from a sentence (text to video), a still brought to life (image to video) and stills for cards (text to image). Use when the user says "generate b-roll", "make a shot of", "AI b-roll", "generate a clip", "use Higgsfield", "motion transfer", "put my moves on", "restyle this part with AI", or asks for footage they did not film. Not for animated diagrams or motion graphics (motion), not for real screenshots and logos (overlays, logo-pack), and not for the cut (cut).

Habilidades Relacionadas