Communitygithub.com

SongGithub/personal-skills

一份可复用的HTML文档设计系统,适用于简历、单页报告和短文档——包含设计令牌、布局、排版、打印为PDF的规则和无障碍支持。适用于生成或重新设计独立的、可在屏幕上阅读或打印为PDF的HTML文档。

personal-skills 是什么?

该技能旨在为开发者提供一套成熟、可定制的HTML文档设计系统,特别适用于生成简历、单页报告等需要同时优化屏幕显示和PDF打印效果的场景。系统通过CSS自定义属性(设计令牌)集中管理色彩、间距等视觉元素,并内置深色模式支持,确保文档主题统一且易于维护。布局上采用820px最大宽度、系统字体栈和精心调整的排版比例,兼顾可读性与信息密度。打印规则经过专门优化,包括精确的页面尺寸、边距控制和断页处理,使生成的PDF在专业环境中表现良好。此外,系统还强调了无障碍性(语义化标题、高对比度、列表结构)并明确列出了应避免的反模式,如多列布局和表格布局。该设计系统可作为任何需要独立、无构建步骤的HTML文档的起点,兼容Claude Code等AI Agent平台。

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

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

文档设计

一套用于独立HTML文档的设计系统。目标:在屏幕上正确显示,打印为PDF时干净整洁,且无需构建步骤——一个可在任何地方打开的文件。

复制 references/cv-template.html 作为起点;它已预先集成了以下所有内容。

设计令牌

将所有颜色和表面放在 :root 的自定义属性中,并添加深色模式覆盖。切勿在规则中硬编码十六进制值,这是文档可主题化和可打印的关键。

:root {
  --doc-background: #ffffff;
  --doc-background-mid: #eef0ee;   /* 页面环绕 */
  --doc-border-light: #e3e3e0;
  --doc-text-primary: #1d1f22;
  --doc-text-secondary: #5f6368;
  --doc-accent: #1f6f5c;           /* 一个强调色,谨慎使用 */
  --doc-accent-soft: #e7f1ee;      /* 标签/微色调背景 */
}
html[data-theme='dark'] {
  --doc-accent: #4fbfa3;
  --doc-accent-soft: #16332b;
}

规则:

  • 使用一个强调色。 仅用于标记章节标题、职位/公司名称、项目符号,其他情况不用。到处使用强调色会被视为装饰。
  • 使用两种文本颜色。 主要颜色用于内容,次要颜色用于元数据(日期、地点、注释)。
  • 使用微色调,而非填充。 对于标签,使用 --doc-accent-soft 而非实心强调色块。

布局

  • 页面最大宽度 820px,居中,顶部外边距 24px。超过此宽度会影响行长度,降低可读性。
  • 页面内边距 38–42px。 内边距承载视觉重量,因此无需外层边框。
  • 页面环绕 使用 --doc-background-mid,使白色页面看起来像一张纸。
  • 各部分之间以 15px 间距 堆叠。结构来自于间距和每个章节标题下方的一条细线,而非使用盒子或面板。

排版

  • 系统字体栈,无网页字体:-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif。无需加载任何内容,离线也不会出错。
  • 基准字号较小:屏幕上为 12.8px,行高 1.38。这是一份文档,而非博客文章——密度是特点之一。
  • 字号缩放:姓名字号 28px/字重 700,章节标题字号 11.5px/字重 700 大写,字间距 1.3px,职位标题字号 13.5px/字重 700,正文 12–12.5px,元数据 11px。
  • 章节标题使用大写和强调色,下方有一条细线。这是唯一的标题处理方式;不要添加另一层视觉层级。
  • 断字和对齐:保持文本左对齐,切勿两端对齐。

打印规则

打印为 PDF 是主要用途,因此打印样式块与屏幕样式同样重要。

  • @page { size: letter; margin: 0 } 并将内边距移至页面容器中,从而实现对边距的控制。
  • 强制白色背景并设置 print-color-adjust: exact,以便保留着色标签。
  • 字号降至约 10pt,行高 1.3。屏幕上的字号在纸张上显得过大。
  • 在每个职位、子职位和页眉上设置 break-inside: avoid,确保没有工作条目被分页断开。
  • 隐藏交互式装饰——打印时隐藏按钮、样式化为控件的链接。

无障碍性

  • 保持对比度:主要文本在白色背景上,强调色仅用于标题和标记。切勿将强调色用于长篇正文。
  • 按合理顺序使用真正的标题元素(h1、h2);通过 CSS 设置大写样式,而非在 HTML 中直接输入大写字母。
  • 为链接提供描述性文本;不要仅依靠颜色来区分链接。
  • 为项目符号保留语义列表结构——屏幕阅读器会播报列表长度,这在长简历中很有帮助。

反模式

  • 多列布局——它们在打印中会出错,且屏幕阅读器会以错误的顺序阅读。
  • 使用表格进行布局。
  • 使用图片或图标字体代替文本;它们无法在 PDF 文本提取或 ATS 解析中幸存。
  • 实心强调色页眉、渐变、内容上的投影,或每个部分之间的装饰性分隔线。
  • 由浏览器注入的页眉和页脚(日期、URL、页码)——在打印对话框中禁用它们。

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.

相关技能