How to use
- Copy the installation command and review the source package before installing it in your own agent environment.
- Check the source document for required tools, credentials and supported hosts.
- Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/promovaweb/brandfy --skill brandfy-guia-pdfBefore you start
- Installation does not include a model subscription, API allowance or permission to access your files.
- Repository stars and installation counts describe activity, not an independent quality or security test.
Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.
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.
