Communitygithub.com

Document design

Um sistema de design reutilizável para documentos HTML — tokens de design, layout, tipografia, regras de impressão para PDF e acessibilidade. Use ao gerar ou reestilizar um documento HTML autocontido, destinado à leitura em tela ou à impressão em PDF.

O que é Document design?

Este skill fornece um sistema de design completo para documentos HTML autocontidos, como CVs, panfletos e relatórios curtos. Ele é útil porque elimina a necessidade de etapas de build e dependências externas, garantindo que o documento tenha boa aparência tanto na tela quanto ao ser impresso em PDF. O sistema é compatível com qualquer plataforma que renderize HTML, incluindo navegadores e ferramentas de linha de comando. Ele funciona definindo tokens de design como variáveis CSS, um layout centrado com largura máxima de 820px, tipografia baseada em fontes do sistema e regras de impressão que forçam quebras de página e ocultam elementos interativos. Também inclui práticas de acessibilidade, como uso de contraste adequado, elementos de título semânticos e estrutura de listas, além de evitar anti-padrões como layouts multicoluna e ícones de fonte.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/SongGithub/personal-skills/tree/HEAD/document-design/skills/document-design

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Design de documento

Um sistema de design para documentos HTML autocontidos. O objetivo: correto na tela, limpo ao imprimir em PDF e sem etapa de build — um único arquivo que pode ser aberto em qualquer lugar.

Copie references/cv-template.html como ponto de partida; ele já conecta tudo o que está descrito abaixo.

Tokens de design

Coloque cada cor e superfície em propriedades personalizadas em :root, com uma substituição para tema escuro. Nunca codifique um valor hexadecimal em uma regra; é isso que torna o documento temável e imprimível.

:root {
  --doc-background: #ffffff;
  --doc-background-mid: #eef0ee;   /* entorno da página */
  --doc-border-light: #e3e3e0;
  --doc-text-primary: #1d1f22;
  --doc-text-secondary: #5f6368;
  --doc-accent: #1f6f5c;           /* um acento, usado com moderação */
  --doc-accent-soft: #e7f1ee;      /* fundo de chip/tom */
}
html[data-theme='dark'] {
  --doc-accent: #4fbfa3;
  --doc-accent-soft: #16332b;
}

Regras:

  • Uma cor de acento. Ela marca cabeçalhos de seção, o nome do cargo/empresa, marcadores de lista e nada mais. Acento em todo lugar parece decoração.
  • Duas cores de texto. Primária para conteúdo, secundária para metadados (datas, locais, notas).
  • Tonalize, não preencha. Use --doc-accent-soft para chips em vez de blocos sólidos de acento.

Layout

  • Largura máxima da página 820px, centralizada, com margem superior de 24px. Mais larga que isso e o comprimento da linha prejudica a legibilidade.
  • Padding da página de 38–42px. O padding carrega o peso visual, então nenhuma borda externa é necessária.
  • Entorno da página é --doc-background-mid para que a página branca pareça uma folha.
  • As seções se empilham com um espaçamento de 15px. A estrutura vem do espaçamento e de uma linha fina abaixo de cada cabeçalho de seção, não de caixas ou painéis.

Tipografia

  • Pilha de fontes do sistema, sem fontes web: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif. Nada para carregar, nada para falhar offline.
  • Base é pequena: 12,8px na tela com altura de linha de 1,38. Isto é um documento, não uma postagem de blog — densidade é uma característica.
  • Escala: nome 28px/700, cabeçalho de seção 11,5px/700 maiúsculo com espaçamento entre letras de 1,3px, título do cargo 13,5px/700, corpo 12–12,5px, metadados 11px.
  • Cabeçalhos de seção são maiúsculos e com cor de acento com uma linha fina abaixo. Esse é o único tratamento de cabeçalho; não adicione outro nível de hierarquia visual.
  • Hifenização e justificação: deixe o texto alinhado à esquerda, nunca justificado.

Regras de impressão

Imprimir em PDF é o uso principal, então o bloco de impressão é tão importante quanto o da tela.

  • @page { size: letter; margin: 0 } com o padding movido para o contêiner da página, dando controle sobre as margens.
  • Forçar fundos brancos e definir print-color-adjust: exact para que chips tonalizados sobrevivam.
  • Reduzir para ~10pt com altura de linha de 1,3. Os tamanhos de tela são grandes demais no papel.
  • break-inside: avoid em cada cargo, subcargo e no cabeçalho, para que nenhuma entrada de trabalho seja dividida entre páginas.
  • Ocultar cromo interativo — botões, links estilizados como controles — na impressão.

Acessibilidade

  • Manter contraste: texto primário sobre branco, acento apenas para cabeçalhos e marcadores. Nunca use o acento para texto longo do corpo.
  • Usar elementos de título reais (h1, h2) em uma ordem sensata; estilizar maiúsculas com CSS em vez de digitá-las em CAIXA ALTA.
  • Dar texto descritivo aos links; não confiar apenas na cor para distingui-los.
  • Manter a estrutura de lista semântica para marcadores — leitores de tela anunciam o comprimento da lista, o que ajuda em um CV longo.

Anti-padrões

  • Layouts multicoluna — eles quebram na impressão e leitores de tela os leem na ordem errada.
  • Tabelas para layout.
  • Imagens ou fontes de ícones no lugar de texto; eles não sobrevivem à extração de texto de PDF ou à análise de ATS.
  • Cabeçalhos com preenchimento sólido de acento, gradientes, sombras projetadas no conteúdo ou réguas decorativas entre cada seção.
  • Cabeçalhos e rodapés injetados pelo navegador (data, URL, número de página) — desabilite-os no diálogo de impressão.

Individual skills in this repo

This repo contains 10 individual skills — each has its own dedicated page.

SongGithub/personal-skills

Applies a direct, plain-spoken, Australian-English communication style to any text drafted — chat replies, emails, Slack/Teams messages, tickets, PR and commit descriptions, docs. Use whenever drafting prose, not just visual or code artifacts. Skip when the user explicitly asks for a different tone or voice.

SongGithub/personal-skills

End-to-end job application workflow. Screen a posting, tailor the HTML CV from the master template, print it to PDF, archive the artifact, and file the result against the configured tracker. Triggers on apply, apply to jobs, submit application, tailor and send CV.

SongGithub/personal-skills

CV attach workflow. Generate a tailored HTML CV for a tracked role, attach the rendered artifact back to its tracker item, then verify the attachment actually landed. Covers template selection, tailoring order, upload headers, and read-back verification.

SongGithub/personal-skills

First-principles reasoning for a startup or a job search, in the spirit of Elon Musk's "zero restart" framing: survival cashflow, the idiot index, and the physical first step. 第一性原理创业与求职法 — 从马斯克「归零重启」思维出发,用生存现金流、白痴指数、长期物理第一步三个步骤,指导创业和求职

SongGithub/personal-skills

How to file a job opportunity as a Jira issue — summary format, required fields, duplicate check, description formatting and attachments. Applies when tracker_backend is jira. Use when a job posting becomes a tracker record, and when creating or updating job records on a Jira board.

SongGithub/personal-skills

Assistant for job applications: evaluating job postings, tailoring CVs, writing cover letters, and preparing for interviews. Triggers on keywords like: job posting, job application, CV, cover letter, resume, interview prep, job fit, career, application, apply, SEEK

SongGithub/personal-skills

Job scraper. Searches job boards for new positions matching the candidate profile, deduplicates against previously seen jobs and the tracker file, then presents new matches with a quick fit assessment. Triggers on: job scrape, find jobs, search jobs, new jobs, /scrape.

SongGithub/personal-skills

Screen job opportunities, prepare job records and tailored CVs, and verify the result against current salary, title, source, and document-quality preferences. Applies to job boards and scheduled searches.

SongGithub/personal-skills

Trello card rules for the job-search tracker. Enforces case-insensitive and fuzzy duplicate detection before any card is created, title formatting, lane placement from config, and logging each card to the tracker database. Applies whenever a job posting becomes a card.

SongGithub/personal-skills

Compares tracked job postings against the candidate profile to find skill gaps, then builds a prioritised gap heatmap and a learning plan with searched study resources and a study order. Triggers on: upskill, skill gaps, what should I learn, learning plan, upskill report.

Habilidades Relacionadas