Install
python3 "$SKILL_ROOT/scripts/fireworks.py" versionPara quem é
Se você quer descrever uma arquitetura ou um fluxo em linguagem natural e receber um SVG conferido geometricamente mais um PNG de alta resolução, este Agent Skill cabe melhor. O mesmo skill funciona no Codex e no Claude Code sem mudança. Também pode fazer uma animação semântica SVG para GIF validada, e HTML interativo offline.
Você já precisa conseguir chamar este skill nesses assistentes de código, e a máquina precisa de python3 e de achar $SKILL_ROOT/scripts/fireworks.py. Se só quer desenhar à mão e não pretende deixar um Agent gravar arquivos, o ganho é limitado. A página nomeia só Codex e Claude Code, sem outros clientes. Também não deixe uma contagem de estilos possivelmente mais antiga no título do repositório cobrir o corpo: 11 estilos gerador mais 1 estilo de escrita de IA (Dark Luxury).
Primeira tentativa em 3 minutos
A página não dá um comando de instalação de marketplace à parte. Comece com uma checagem somente leitura: quando a raiz do skill já estiver pronta, execute
python3 "$SKILL_ROOT/scripts/fireworks.py" version
O sinal de sucesso é o comando passar e dar informação de versão. Ele não grava arquivos de diagrama. Se $SKILL_ROOT ainda não existir, pare: o texto de página disponível não diz como colocar o skill no Codex ou no Claude Code; não invente um instalador.
Depois da versão passar, faça uma geração controlada. O exemplo oficial é o usuário dizer “Generate a Mem0 memory architecture diagram, dark style”. O skill classifica como Memory Architecture Diagram, Style 2, gera um SVG com raias, cilindros e setas semânticas, exporta um PNG de 1920px e informa mem0-architecture.svg / mem0-architecture.png. Antes de gravar arquivos, faça o Agent repetir esses dois caminhos e só gere depois da sua confirmação. Não comece por GIF ou HTML: o texto de página disponível menciona esses artefatos, mas não dá subcomandos correspondentes.
Casos de uso
Caso 1: Gerar um diagrama de arquitetura a partir de linguagem natural. Use o exemplo Mem0 acima para verificar a cadeia inteira: classificar → SVG → PNG 1920px → informar nomes de arquivo. Ele não documenta todos os parâmetros visuais do Style 2 nem de onde vem o conhecimento de domínio Mem0. A aceitação só olha: a classificação é dita e esses dois nomes aparecem no relatório. Se o Agent começar a mudar seu código de negócio, já saiu da tarefa de diagrama.
Caso 2: Exportar PNG de um SVG existente. O CLI oficial é
python3 "$SKILL_ROOT/scripts/fireworks.py" export-png diagram.svg diagram.png --width 1920
Isso sobrescreve ou cria diagram.png. Confirme primeiro que o SVG de entrada existe e que o caminho de saída pode ser gravado. Para evitar texto cortado, acrescente "text_policy": "strict" à configuração: recusa truncamento visível antes de gravar, mantém os rótulos-fonte completos no relatório e explica como recuperar; descrições em chinês usam a segunda linha disponível. O texto de página disponível não dá um nome de arquivo JSON completo. Você só pode confirmar este campo e a segunda linha em chinês; não invente outros valores de política.
Limites de uso
As contagens de estilo seguem o corpo: 11 estilos gerador, mais Dark Luxury. Há ainda quatro estilos mais de engenharia que dão convenções executáveis para revisão C4, implantação em nuvem, fluxos de eventos e diagnóstico de confiabilidade, mais padrões profundos de domínio AI/Agent e os 14 tipos de diagrama UML. A página não nomeia os 14 UML nem os nomes curtos daqueles quatro estilos de engenharia. Se o nome falta, não o chame.
Os comandos copiáveis são só version e export-png. GIF e HTML interativo estão escritos como capacidades, sem linha de comando. Não coloque um segundo instalador ao lado. Os clientes vão só até Codex e Claude Code.
A primeira parada é version ou um PNG cujo caminho você já confirmou. Qualquer geração em lote, qualquer campo desconhecido além de text_policy ou qualquer geração GIF/HTML deve primeiro fazer o Agent explicar a base e os arquivos que vai gravar; você confirma e só então continua.