Mode d’emploi
- Copiez la commande et examinez le paquet avant de l’installer dans votre environnement agent.
- Consultez le document original pour les outils, identifiants et environnements requis.
- Décrivez les entrées et le livrable souhaité ; comparez la sortie aux sources.
npx skills add https://github.com/promovaweb/brandfy --skill brandfy-guia-pdfAvant de commencer
- L’installation n’inclut ni abonnement au modèle, ni quota API, ni accès aux fichiers.
- Étoiles et installations reflètent l’activité, pas un test indépendant de qualité ou de sécurité.
Rendu depuis le dépôt source en conservant titres, exemples, code, tableaux, liens et images.
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.
