Communitygithub.com

luo173176/ppt-design-skill

Projete, construa, anime e revise apresentações profissionais (PPT/PPTX). Use ao criar ou redesenhar um conjunto de slides onde a estrutura de conteúdo, estilo visual, variedade de layout, gráficos, imagens, animação, transições Morph, narrativa de movimento ou polimento geral são importantes; ao transformar material bruto em um argumento projetado; ao adicionar ou corrigir animação e transições de slides; ou ao auditar o estado estático e dinâmico de um deck existente.

O que é ppt-design-skill?

Esta skill capacita o agente a atuar como um designer profissional de apresentações, transformando tópicos e material bruto em argumentos visuais coesos, indo além da mera decoração de slides. Ela abrange tanto o design estático quanto a animação, tratando o movimento como parte integrante da narrativa. A skill organiza seu conhecimento em uma hierarquia de referências detalhadas e workflows executáveis, permitindo que o agente planeje um deck, projete páginas individuais, adicione animações complexas, ou realize auditorias completas. Suporta a criação de slides para PowerPoint (PPT/PPTX), com ênfase em elementos nativos como gráficos editáveis, animações programadas e transições Morph. Inclui capacidades de replicação de decks existentes e uma biblioteca de ativos local (modelos, componentes, receitas de animação) que o agente pode consultar para acelerar o design, garantindo consistência e qualidade profissional.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/luo173176/ppt-design-skill/tree/HEAD

Perguntar na sua IA favorita

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

Documentação

Skill de Design de Apresentações (PPT)

Transforme um tópico e material bruto em um argumento projetado — não um documento decorado. Design estático e design de movimento são cidadãos iguais: um deck deve ser lido bem página por página e mover-se bem quando executado.

Este arquivo é o ponto de entrada único. Ele contém as decisões que devem permanecer consistentes; os arquivos em references/ contêm o conhecimento detalhado, os arquivos em workflows/ contêm procedimentos executáveis e examples/ contém padrões de design abstraídos. Leia apenas as referências que uma tarefa realmente precisa.

Quando ler o quê

TarefaCarregar
Planejar o conteúdo e a história de um novo deckworkflows/create-presentation.md + references/content-strategy.md
Projetar uma página bemworkflows/design-slide.md + references/slide-patterns.md
Diagnosticar/corrigir uma página feia ou bagunçadaworkflows/improve-slide.md
Adicionar animação a um slideworkflows/create-slide-animation.md
Construir um deck inteiro animadoworkflows/create-animated-presentation.md
Revisar um deck finalizado (estático + dinâmico)workflows/review-presentation.md + references/quality-control.md
Escolher cores / fontes / gridreferences/color-system.md, references/typography.md, references/layout-system.md
Gráficos e storytelling de dadosreferences/data-visualization.md
Imagens, ícones, texturasreferences/visual-assets.md
Estilização específica de cenárioreferences/presentation-scenarios.md
Movimento: princípios, linha do tempo, Morph, padrões, códigoreferences/animation-fundamentals.md → animation-timeline.md → slide-transitions.md → advanced-animation.md → motion-design.md → animation-patterns.md → animation-implementation.md
Entender/gerar internos PPTXreferences/pptx-technical-guide.md
Replicar um deck de referência inteiroworkflows/replicate-deck.md + references/replica-modes.md
Replicar / reutilizar uma páginaworkflows/replicate-slide.md
Extrair um template ou mestreworkflows/extract-template.md
Identificar, corresponder ou licenciar fontesworkflows/extract-fonts.md
Minerar layouts, componentes, receitas de animaçãoworkflows/extract-assets.md
Pesquisar ou compor a partir da biblioteca pessoalworkflows/asset-library.md + references/asset-library-schema.md

Aliases de nome de tarefa (mesmos workflows, mantidos para compatibilidade do chamador): create-deck → create-presentation, improve-slide → improve-slide, animate-slide → create-slide-animation, review-deck → review-presentation, extract-assets → extract-assets.

Réplica e biblioteca pessoal de ativos

Duas capacidades ficam ao lado de "projetar do zero":

  1. Réplica (replicate-deck, replicate-slide) tem três contratos: A reutilização nativa (exata; mestres/gráficos/animações preservados), B reconstrução estruturada (editável; fontes/efeitos aproximados), C imitação visual (baseada em imagem; apenas texto). Sempre indique o modo; nunca apresente C como editável e nunca afirme fidelidade 100% após substituições.
  2. A biblioteca (E:\PPT-Design-Assets\) contém 50 templates, 50 mestres independentes, 24 padrões de página, 680 componentes, 64 receitas de animação e o registro de fontes. Pesquise-a antes de projetar (scripts/asset_search.py, --compose) e registre quais IDs de ativos foram usados.

A evidência medida para ambos está em references/replica-modes.md e references/asset-library-schema.md; os procedimentos estão nos seis workflows acima.

O Padrão

Um deck finalizado passa por cinco testes:

  1. Um deck, um mundo. Remova o logotipo e um estranho ainda consegue dizer a qual deck pertencem quaisquer três slides.
  2. Toda página tem um trabalho. A página avança o argumento, fornece evidências, cria uma pausa ou pede uma decisão. Sem páginas de enchimento.
  3. A hierarquia sobrevive a olhos semicerrados. No tamanho de miniatura (o teste da folha de contato), as leituras pretendidas de 1º/2º/3º nível ainda são visíveis.
  4. Nada é decorativo por acidente. Cada linha, imagem, campo de cor e número ganha seu lugar.
  5. Movimento é significado. A animação revela, guia ou compara. Se remover uma animação não perde informação e não ganha polimento, corte-a.

Não mire em "mais projetado." Mire em um argumento visual claro com um ou dois movimentos memoráveis.

Base de evidências (medida, não adivinhada)

Derivada de uma varredura estrutural + de animação completa do corpus de origem. Trate como faixas para calibrar contra, nunca como lei rígida.

  • Tela: 16:9 a 13,333×7,5 pol em 94/102 decks. 4:3 para impressão/legado (5 decks); ultra-wide 3,5554 usado para decks de relatório público estilo banner. Uma tela por deck.
  • Formas por página: mediana 10, média ~16, p90 24. Páginas densas de dados chegam a 30–55.
  • Escala de tipo (pt): corpo 12–18; rótulos pequenos 8–11; subtítulos 20–28; títulos de página 24–44; seção/afirmação 44–80; capa/meganumeral 88–344. O texto do corpo é tipicamente 12–18 pt, mais comumente 14–18.
  • Paleta: predominantemente 2–3 cores — um campo preto/branco ou quase neutro mais um acento saturado (ex.: FFD23C, C3DF21, 0F6FC6) e um tom de suporte neutro. Exemplos de acentos profissionais: #FFD23C #C3DF21 #FF008E #00EBFF #0F6FC6 #D51C3B #7EAB28 #0535D1.
  • Fontes (CJK): 微软雅黑 / 思源黑体 dominam a família; faces de exibição mais pesadas (思源黑体 Heavy/Bold, 庞门正道标题体) para títulos. Fontes (Latinas): Segoe UI / Segoe UI Light, Lato, Arial, Calibri. Conjunto livre/seguro para uso comercial usado repetidamente: 思源黑体 + Lato.
  • Gráficos: 55 decks carregam gráficos. Distribuição: barra 183, pizza 78, rosca 67, linha 37, bolha 16, barra3D 13, dispersão 12, área 11, radar 8. Gráficos são objetos editáveis nativos com pastas de trabalho incorporadas — use gráficos editáveis, não imagens de gráficos.
  • Cobertura de animação: 1068/4235 slides carregam uma árvore de temporização; 742 têm uma transição; Morph aparece em 183 slides, push 169, fade 149, e outros 128 usam outras predefinições de transição.
  • Mix de efeitos: entrada Fade (701) e Zoom (371) lideram, seguidos por Fly In (248) e Wipe (141); ênfase é dominada por efeitos sutis de "alterar/destacar"; caminhos de movimento estão presentes, mas são raros e deliberados.
  • Gramática de temporização: relação de nó dominante é withEffect (2678) depois afterEffect (652), clickEffect (473). Atrasos se agrupam em 0 / 100 / 300 / 500 ms e durações em 500 / 1000 / 2000 ms, com suavização decel em revelações.
  • Escalas: pulsos de ênfase usam pares 1,25× → 0,80× (animScale 125000/80000).
  • Mídia avançada realmente usada: modelos 3D nativos (am3d:model3d) e vídeo incorporado — não afirme que uma biblioteca suporta o que não pode emitir.
  • Segundo corpus (4314 slides): 105 pacotes analisados, 241 mestres, 1393 layouts, 66 temas únicos, 1099 slides com árvore de temporização, 183 páginas Morph; transições: morph 183, push 173, wipe 16.
  • Amostra de animação (50 decks selecionados): 984 nós de efeito → 64 receitas; entrada Grow & Turn 144, Fade 141, Wipe 102, Fly In 52; ênfase Spin 247.
  • Rendimento de ativos após curadoria: 50 templates, 50 mestres, 24 padrões de página, 680 componentes (52 gráficos nativos, 160 formas, 160 ícones), 64 receitas de animação, 129 registros de fontes / 88 famílias (26 arquivos OFL copiados).
  • Calibração de réplica (viz-01, 3 páginas): A SSIM 1.000; B 0.674 (reconstrução editável); C 0.978 (baseada em imagem). Relate por página, não apenas a média.
  • Calibração visual Modo-B (5 decks × 6 páginas): 0.782 Negócios, 0.660 Tecnologia, 0.915 Dados, 0.865 Editorial, 0.751 Criativo. Mosaicos de layout, cortes a:srcRect e sobreposições <a:alpha> são aplicados; filtros de imagem e sombras ainda são omitidos, portanto uma página baixa deve ser relatada, não calculada como média.

Inegociáveis

  • Tela: uma por deck, 16:9 13,333×7,5 pol a menos que o briefing seja retrato/ultra-wide.
  • Grid: um grid de colunas (12 colunas padrão) com calhas consistentes; blocos de conteúdo se ajustam a ele. Quebra deliberada de regras usada com moderação (<3 vezes por deck).
  • Margens: margem óptica consistente; o texto respeita uma área segura mesmo sob imagens sangradas. Imagens sangradas são permitidas; o texto ainda respeita uma área segura.
  • Paleta: 1 campo dominante + 1 neutro + 1 acento (+ no máximo 1 secundário opcional). Use ~60/30/10. Não introduza um novo acento após a página 3.
  • Tipo: máximo duas famílias (uma de exibição, uma de corpo) e três pesos. Mantenha uma proporção clara entre os níveis (≈1,3–1,5×); não use quatro tamanhos quase idênticos.
  • Densidade de texto: capas 4–12 palavras; afirmação/seção 10–35; conteúdo 40–110; analítico denso 120–220. Se uma página precisar de mais, divida a página, não encolha abaixo de 12 pt.
  • Tratamento de imagem: escolha UM tratamento (natural / quente-editorial / frio-arquitetônico / duotone / monocromático / sintético) e aplique-o em todo o deck.
  • Um motivo: uma regra, corte, ponto, numeral, colchete ou máscara de imagem repetida, recorre em 4–8 páginas — não em todas as páginas.
  • Um movimento memorável por deck: um numeral gigante, uma parede de manchete, um assunto recortado, um acento elétrico, um corte de tipo de ponta a ponta. Proteja-o mantendo tudo ao redor quieto.
  • Orçamento de animação: prefira revelações a movimento constante; mantenha movimento simultâneo por slide ≤3 objetos; nunca anime para decorar.

Conteúdo

  • references/ — content-strategy, design-principles, layout-system, typography, color-system, visual-assets, data-visualization, slide-patterns, presentation-scenarios, animation-fundamentals, advanced-animation, animation-timeline, motion-design, slide-transitions, animation-patterns, animation-implementation, pptx-technical-guide, quality-control, replica-modes, asset-library-schema.
  • workflows/ — create-presentation, design-slide, improve-slide, create-slide-animation, create-animated-presentation, review-presentation, replicate-deck, replicate-slide, extract-template, extract-fonts, extract-assets, asset-library.
  • examples/design-patterns.md — padrões de página e movimento abstraídos e reutilizáveis.
  • scripts/ — design: build_deck.py (especificação JSON → deck), inspect_pptx.py, contact_sheet.py, add_animation.py. Análise/extração: analyze_deck.py, enrich_themes.py, extract_template.py, curate_templates.py, extract_masters.py, extract_fonts.py + fontlib.py, extract_patterns.py, fix_layout_previews.py, extract_components.py, render_component_previews.py, extract_animations.py, build_asset_index.py, asset_search.py. Réplica/QA: replicate_deck.py, replicate_slide.py, compare_slides.py, validate_replica.py. Manutenção: collect_stats.py, fix_font_library.py, make_reports.py, run_tests.py. Veja scripts/README.md para comandos e saídas exatos.

Autossuficiente

Tudo que é necessário está nesta skill. Ela não lê o corpus fonte em tempo de execução; o corpus apenas forneceu os intervalos medidos citados aqui.

Habilidades Relacionadas