Come usare
- Copia il comando e controlla il pacchetto prima di installarlo nel tuo ambiente agente.
- Controlla strumenti, credenziali e ambienti richiesti nel documento originale.
- Descrivi input e risultato desiderato; confronta l’output con le fonti.
npx skills add https://github.com/promovaweb/brandfy --skill brandfy-guia-pdfPrima di iniziare
- L’installazione non include abbonamenti, quote API o accesso ai file.
- Stelle e installazioni indicano attività, non un test indipendente di qualità o sicurezza.
Contenuto dal repository con titoli, esempi, codice, tabelle, link e immagini preservati.
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.
