Como usar
- Copie o comando e verifique o pacote antes de instalar no seu ambiente de agente.
- Consulte no original as ferramentas, credenciais e ambientes necessários.
- Descreva os dados de entrada e a entrega esperada; confira a saída com as fontes.
npx skills add https://github.com/promovaweb/brandfy --skill brandfy-guia-pdfAntes de começar
- A instalação não inclui assinatura de modelo, franquia API ou acesso aos seus arquivos.
- Estrelas e instalações indicam atividade, não um teste independente de qualidade ou segurança.
Renderizado do repositório de origem, preservando títulos, exemplos, código, tabelas, links e imagens.
Compilar o guia da marca em PDF
Protocolo operacional
- Plano e progresso: planejar fonte, tema, compilação e inspeção.
- Fontes de verdade: ler
BRAND.md,brand/README.mdcomo índice, os ativos vinculados e
- Escopo e idempotência: copiar o design system para
brand/pdf/e gerar
o PDF sem modificar a fonte editável nem substituir personalizações.
- Validação: recompilar, conferir links, páginas, imagens, fontes, sumário e
metadados.
- Resumo final: informar fonte, PDF, ferramentas usadas e avisos.
Fluxo
- Confirmar que
BRAND.mdé a versão aprovada e que os links relativos
existem.
- Instalar ou conferir os ativos locais:
node <caminho-da-skill>/scripts/build-brand-guide.mjs \
--project . \
--install-assetsO comando copia CSS, template, Inter, Manrope e licenças para brand/pdf/. Arquivos existentes são preservados. Use --force-assets somente depois de revisar as diferenças da versão instalada.
- Compilar:
node <caminho-da-skill>/scripts/build-brand-guide.mjs \
--project . \
--input BRAND.md \
--output brand/brand-guide.pdf \
--brand-name "Nome da marca"- O compilador usa Pandoc para gerar HTML semântico e WeasyPrint para produzir
o PDF. Instalar essas ferramentas quando a verificação inicial apontar ausência.
- Preservar o contrato
pdf-design-system: 1.0.0: A4, capa clara, Manrope,
Inter, sumário, componentes editoriais e paginação. Nome, logo, descrição, tagline e cor de link podem ser personalizados sem duplicar o tema.
- Abrir o PDF e conferir capa, sumário, quebras, tabelas, SVGs, PNGs, URLs,
cabeçalhos, rodapés e propriedades do documento.
- Recompilar sempre que o Markdown, o CSS, uma fonte ou um ativo vinculado
mudar.
Quando uma imagem, uma tabela ou um texto aparecer errado no PDF, corrija brand/README.md, o CSS ou o ativo vinculado. Recompile e abra a página afetada para confirmar o ajuste sem editar o PDF diretamente.
Raciocínio do especialista
Tratar o PDF como uma representação da fonte canônica, não como documento independente. Avaliar legibilidade, navegação, sequência pedagógica, reprodução, acessibilidade e rastreabilidade dos ativos. Uma compilação sem erro técnico ainda falha quando oculta exemplos, separa regra do contexto ou torna tabelas ilegíveis.
