Communitygithub.com

Document Design (Système de conception de documents)

Un système de conception réutilisable pour documents HTML autonomes : CV, fiches synthétiques et rapports courts — avec tokens de design, mise en page, typographie, règles d'impression vers PDF et accessibilité. À utiliser pour générer ou restyler un document HTML autonome destiné à être lu à l'écran ou imprimé en PDF.

Qu'est-ce que Document Design (Système de conception de documents) ?

Ce skill met en place un système de conception complet pour des documents HTML autonomes, sans étape de build, à partir d'un seul fichier. Il fournit des tokens de design CSS (couleurs, surfaces) via des propriétés personnalisées avec un thème sombre en option, une mise en page centrée de 820px de large avec un padding de 38–42px, une typographie basée sur une pile de polices système (taille de base 12,8px) et des règles d'impression robustes avec `@page`, `break-inside: avoid` et `print-color-adjust: exact`. Ce skill est idéal pour les CV, les fiches de présentation ou les rapports courts : il garantit un rendu cohérent à l'écran et une impression PDF nette, tout en respectant l'accessibilité (contraste, structure sémantique, liens descriptifs). Il est compatible avec tout environnement HTML simple (CLI, éditeur, générateur de documents) et peut être utilisé directement depuis la CLI en copiant le fichier `references/cv-template.html`.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Conception de documents

Un système de conception pour documents HTML autonomes. L'objectif : correct à l'écran, propre une fois imprimé en PDF, et sans étape de build — un seul fichier que vous pouvez ouvrir n'importe où.

Copiez references/cv-template.html comme point de départ ; il intègre déjà tout ce qui suit.

Tokens de design

Placez toutes les couleurs et surfaces dans des propriétés personnalisées à :root, avec une surcharge pour le thème sombre. Ne codez jamais une valeur hexadécimale en dur dans une règle ; c'est ce qui rend le document adaptable et imprimable.

:root {
  --doc-background: #ffffff;
  --doc-background-mid: #eef0ee;   /* fond de page */
  --doc-border-light: #e3e3e0;
  --doc-text-primary: #1d1f22;
  --doc-text-secondary: #5f6368;
  --doc-accent: #1f6f5c;           /* un seul accent, utilisé avec parcimonie */
  --doc-accent-soft: #e7f1ee;      /* fond de puce/tag */
}
html[data-theme='dark'] {
  --doc-accent: #4fbfa3;
  --doc-accent-soft: #16332b;
}

Règles :

  • Une seule couleur d'accent. Elle marque les titres de sections, le nom du poste/de l'entreprise, les puces et rien d'autre. Un accent partout est perçu comme de la décoration.
  • Deux couleurs de texte. Primaire pour le contenu, secondaire pour les métadonnées (dates, lieux, notes).
  • Teintez, ne remplissez pas. Utilisez --doc-accent-soft pour les puces plutôt que des blocs d'accent pleins.

Mise en page

  • Largeur de page maximale 820px, centrée, avec une marge supérieure de 24px. Au-delà, la longueur de ligne nuit à la lisibilité.
  • Padding de page 38–42px. Le padding porte le poids visuel, donc aucune bordure extérieure n'est nécessaire.
  • Le fond de page est --doc-background-mid pour que la page blanche ressemble à une feuille.
  • Les sections s'empilent avec un espacement de 15px. La structure vient de l'espacement et d'un filet fin sous chaque titre de section, pas de boîtes ou de panneaux.

Typographie

  • Pile de polices système, pas de polices web : -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif. Rien à charger, rien qui échoue hors ligne.
  • Taille de base petite : 12,8 px à l'écran avec un interlignage de 1,38. C'est un document, pas un article de blog — la densité est une fonctionnalité.
  • Échelle : nom 28 px/700, titre de section 11,5 px/700 en majuscules avec un espacement de 1,3 px, titre de poste 13,5 px/700, corps de texte 12–12,5 px, métadonnées 11 px.
  • Les titres de section sont en majuscules et de la couleur de l'accent avec un filet fin en dessous. C'est le seul traitement des titres ; n'ajoutez pas un autre niveau de hiérarchie visuelle.
  • Césure et justification : laissez le texte aligné à gauche, jamais justifié.

Règles d'impression

L'impression vers PDF est l'utilisation principale, donc le bloc d'impression est aussi important que celui de l'écran.

  • @page { size: letter; margin: 0 } avec le padding déplacé dans le conteneur de page, ce qui donne le contrôle des marges.
  • Forcez les fonds blancs et définissez print-color-adjust: exact pour que les puces teintées survivent.
  • Réduisez à environ 10 pt avec un interlignage de 1,3. Les tailles à l'écran sont trop grandes sur papier.
  • break-inside: avoid sur chaque poste, sous-poste et l'en-tête, de sorte qu'aucune entrée d'emploi ne soit coupée entre deux pages.
  • Masquez les éléments interactifs — boutons, liens stylisés en contrôles — à l'impression.

Accessibilité

  • Maintenez le contraste : texte principal sur fond blanc, accent pour les titres et les puces uniquement. N'utilisez jamais l'accent pour un long texte de corps.
  • Utilisez de véritables éléments de titre (h1, h2) dans un ordre logique ; stylisez en majuscules via CSS plutôt que de les taper en capitales.
  • Donnez aux liens un texte descriptif ; ne vous fiez pas uniquement à la couleur pour les distinguer.
  • Conservez la structure de liste sémantique pour les puces — les lecteurs d'écran annoncent la longueur de la liste, ce qui est utile sur un long CV.

Anti-patrons

  • Dispositions multi-colonnes — elles cassent à l'impression et les lecteurs d'écran les lisent dans le mauvais ordre.
  • Tableaux pour la mise en page.
  • Images ou polices d'icônes à la place du texte ; elles ne survivent pas à l'extraction de texte PDF ni à l'analyse ATS.
  • En-têtes avec accent plein, dégradés, ombres portées sur le contenu ou règles décoratives entre chaque section.
  • En-têtes et pieds de page injectés par le navigateur (date, URL, nombre de pages) — désactivez-les dans la boîte de dialogue d'impression.

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.

Skills associés