Ir para o guia de uso
pptx-reference-deck-analysispor Seth Hobson

PPTX Reference Deck Analysis Skill.

Uma skill de Claude Code e Codex para PPT e apresentações: analisa um PPTX de referência quanto a tema, tipografia, ritmo de layout e diagnósticos.

  • Presentations
  • Relatório de revisão
wshobson/agents · plugins/pptx-deck-creation/skills/pptx-reference-deck-analysis/SKILL.mdSKILL.md
--- name: pptx-reference-deck-analysis description: Use when analyzing a reference PPTX for read-only structure, theme, typography, layout rhythm, diagnostics, derived template catalogs, or safe OOXML package inspection. --- ## Contract ## Rules ## OOXML package inspection
Metadados iniciais e títulos de seção lidos do arquivo original em 2026-09-14 · 2.755 caracteres completos

01 O que faz

O Que a Skill pptx-reference-deck-analysis Faz no Claude Code e no Codex

Resumo, fluxo de trabalho e resultados, todos lidos do SKILL.md do skill.

Do SKILL.mdLido em 14/09/2026 · não é uma execução registrada

Nos termos do próprio skill

Inspeciona um PPTX de referência como evidência de design e deliberadamente nunca o copia, clona ou modifica. Um script python-pptx local à tarefa realiza a extração necessária sob demanda, abrangendo contexto compacto de prompt (número e tamanho dos slides, contagens de formas, sinais de marca, ritmo de layout), extração completa com evidência somente leitura de layout_tree, diagnósticos de pasta, análise de style-master e um catálogo de templates derivado com índices de origem baseados em zero.

Utilitários OOXML empacotados tratam temas brutos, relacionamentos, notas, comentários, animações, mídia, masters e layouts, e os scripts inspect.py, validate_package.py e unpack.py fornecem um relatório JSON, validação de pacote e extração opcional de pacote bruto. Cada parte inspecionada e cada exceção de análise são registradas em um manifesto de análise, e os ativos extraídos permanecem fora de novos decks sem evidência de licença.

O que ele produz

  • Contexto compacto de prompt: número e tamanho dos slides, resumos de texto, contagens de formas, estilos, sinais de marca, uso de templates e ritmo de layout.
  • Extração completa do resumo, dos slides e evidência somente leitura de layout_tree.
  • Análise de style-master abrangendo cores, fontes, distribuição de tamanhos, uso de master/layout e padrões de fluxo.
  • Um catálogo de templates derivado com índices de origem baseados em zero, funções de layout, regiões utilizáveis, placeholders, estruturas visuais e restrições.
Veja o exemplo de prompt ↗

Como funciona

  1. 01
    Escreva um Extractor local à tarefa

    A extração necessária é implementada sob demanda com um pequeno script python-pptx, em vez de um pipeline fixo, de modo que apenas as informações necessárias para o novo deck sejam capturadas.

  2. 02
    Execute a Inspeção Compacta

    scripts/inspect.py recebe o caminho do deck e retorna um relatório JSON cobrindo a ordem dos slides, texto, tokens de tema, relacionamentos, notas, comentários, animações e mídia.

  3. 03
    Escale para os Utilitários OOXML

    Os utilitários empacotados são o caminho alternativo para temas brutos, relacionamentos, notas, comentários, animações, mídia, masters e layouts que a extração de alto nível não consegue ver.

  4. 04
    Ancore os Relacionamentos ao Proprietário do .rels

    Os destinos dos relacionamentos são resolvidos em relação à parte que possui o arquivo .rels, e a ordem dos slides nunca é inferida a partir dos nomes dos arquivos.

02 Encontre o ideal para você

Quando Usar o Skill pptx-reference-deck-analysis

Use a skill pptx-reference-deck-analysis no Claude Code ou Codex quando o trabalho for PPT e decks de slides desse tipo. Adequação e limites abaixo são extraídos do próprio arquivo da skill.

Boa Combinação

  • Você quer que um deck de referência seja lido como evidência de design para um novo deck, em vez de duplicado nele.
  • Você está executando diagnósticos em uma pasta de decks e quer um resultado por deck, além de um manifesto.
  • Você precisa dos documentos de referência empacotados sobre formas de saída e padrões somente para documentação.

Conheça os Limites

  • Qualquer coisa que clone ou modifique o deck de origem em vez de apenas lê-lo.

O Que Fornecer

  • O caminho do deck de referênciaOs scripts empacotados recebem o .pptx como primeiro argumento; é a única entrada obrigatória.
  • Um diretório de saída para evidência de pacote brutounpack.py grava as partes extraídas em um diretório fornecido por você, e é executado apenas quando a evidência de pacote bruto é necessária.
  • defusedxml do requirements.txtInstalado antes de usar qualquer utilitário OOXML empacotado.

03 Dentro da skill

Regras Que a Skill pptx-reference-deck-analysis Dá ao Claude Code e ao Codex

6 instruções concretas, padrões e limites que o SKILL.md define para o agente — a parte do arquivo que muda o resultado.

  1. Mantenha a Fonte somente leitura

    O deck de referência nunca é editado, e cada coordenada nos novos slides de destino é criada de forma independente, em vez de herdada.

  2. Registre o Que Foi Inspecionado

    Cada parte inspecionada e cada exceção de parsing devem ser registradas no manifesto de análise.

  3. Sem Reuso Sem Evidência de Licença

    Conteúdo extraído, fontes, imagens e ativos proprietários não podem aparecer em um deck gerado sem permissão explícita e evidência de licença.

  4. Execute a Partir de um Workspace Confiável

    Os scripts rejeitam path traversal, symlinks, membros excessivamente grandes e archive bombs, portanto pressupõem um diretório de trabalho confiável.

  5. Faça o Parsing de XML com Defusedxml

    XML não confiável deve passar pelo defusedxml com expansão de entidades, carregamento de DTD e acesso à rede desativados.

  6. Trate Cores de Tema como Tokens

    Uma cor de tema permanece um token até ser totalmente resolvida em relação ao esquema de cores.

04 Coloque em prática

Instale pptx-reference-deck-analysis no Claude Code ou Codex

Um comando npx skills add, depois uma primeira tarefa no seu agente e uma checklist para o resultado.

Adicionar pptx-reference-deck-analysis ao Claude Code, Codex ou Seu Agente

Rode no seu projeto; o instalador pergunta a qual agente adicioná-lo.

Terminal
npx skills add https://github.com/wshobson/agents --skill pptx-reference-deck-analysis

Formato genérico de CLI skills para plugins/pptx-deck-creation/skills/pptx-reference-deck-analysis/SKILL.md; o repositório pode documentar seu próprio caminho.

Dê à skill uma primeira tarefa de PPT e apresentações de slides

Escrito nos próprios termos do skill; substitua as partes entre colchetes pelo seu material.

Starter prompt
I have a reference deck at [path/to/reference.pptx]. Inspect it as design evidence and give me the compact prompt context, a style-master analysis of colors, fonts and flow patterns, and a derived template catalog with layout roles, usable regions and placeholders. Validate the package and record inspected parts and parsing exceptions in the manifest, keeping the source read-only.

Fonte: escrito a partir do SKILL.md nos próprios termos do skill.

Verifique o Primeiro Resultado

O que o próprio SKILL.md diz sobre como é um resultado correto:

  • Execute validate_package.py com --output e leia o relatório em busca de XML malformado, relacionamentos internos quebrados, lacunas de content-type, links de layout duplicados e partes órfãs.

No OpenDesign importe o pptx-reference-deck-analysis pelo link do SKILL.md: Plugins → Add → Skill → Import from link, depois selecione-o na barra superior.

05 Código aberto, rastreável

Fonte, Licença e Verificação

De onde vêm os fatos desta página e quando foram verificados pela última vez.

Repository
github.com/wshobson/agents Branch main
Arquivo da skill
plugins/pptx-deck-creation/skills/pptx-reference-deck-analysis/SKILL.md Checksum do conteúdo registrado na verificação; commit 4236bb9
License
MIT Do LICENSE.
Estrelas do repositório
39.635 Snapshot do GitHub tirado em 14/09/2026 para todo o repositório wshobson/agents, que contém 18 skills neste catálogo. Não é uma classificação ou contagem de uso para pptx-reference-deck-analysis.
Verificado pelo OpenDesign
14/09/2026 Arquivo de origem, caminho, texto da licença e contagem de estrelas foram verificados. Não integrado ao OpenDesign principal (verificado em 28/08/2026); uma execução ao vivo não foi registrada nesta página.

Dentro do SKILL.md

  1. ContratoAs cinco saídas de extração: contexto de prompt, extração completa, diagnósticos de pasta, análise de style-master, catálogo de templates.
  2. RegrasFonte somente leitura, coordenadas criadas de forma independente, registro em manifesto, evidência de licença antes do reuso.
  3. Inspeção de pacote OOXMLInstale o defusedxml, depois execute inspect.py, validate_package.py e unpack.py; resolva os destinos .rels.
  4. SegurançaWorkspace confiável, rejeição de traversal e archive bombs, parsing com defusedxml, cores de tema como tokens.
A Descrição da Própria Skill
"Use ao analisar um PPTX de referência para estrutura somente leitura, tema, tipografia, ritmo de layout, diagnósticos, catálogos de templates derivados ou inspeção segura de pacote OOXML."

Descrição front-matter do SKILL.md. O arquivo completo tem cerca de 2.755 caracteres. Leia o arquivo completo no GitHub.

06 Antes de instalar

Perguntas Sobre o Skill pptx-reference-deck-analysis

As respostas vêm do SKILL.md conforme lido em 2026-09-14, e não de uma execução registrada.

Analisar meu deck de referência vai alterar o arquivo?

Não. O skill nunca modifica um deck fornecido e nunca copia partes do pacote diretamente para um novo deck; a fonte permanece somente leitura e os novos slides são criados de forma independente.

PPTX Reference Deck Analysis

Execute pptx-reference-deck-analysis em uma tarefa real de PPT e Slide Decks.

Baixe o OpenDesign, importe pptx-reference-deck-analysis a partir do link SKILL.md, cole o prompt acima e leia o plano antes do resultado.

Terminal
npx skills add https://github.com/wshobson/agents --skill pptx-reference-deck-analysis

OpenDesign Desktop

Um design system. Sua marca consistente em tudo

No Vibe Design Workspace completo, aplique as mesmas regras de marca a sites, apresentações, protótipos interativos, dashboards, imagens e vídeos HTML. Conecte Codex, Claude Code, Cursor e outros agentes de código locais e crie de graça.

  • Sites, apresentações, protótipos, dashboards, imagens e vídeo
  • Mais de 140 design systems e a biblioteca completa de templates e skills
  • Codex local e mais de 21 agentes de código · Grátis
Baixar grátis

Disponível para macOS e Windows