Communitygithub.com

SongGithub/personal-skills

一份可重複使用的 HTML 文件設計系統,適用於履歷、單頁摘要與簡短報告——包含設計標記、版面、排版、列印轉 PDF 規則與無障礙設計。適合在生成或重新設計一份預計在螢幕上閱讀或列印成 PDF 的獨立 HTML 文件時使用。

personal-skills 是什麼?

這是一個為獨立 HTML 文件設計的設計系統,目標是螢幕上顯示正確、列印成 PDF 時乾淨整潔,且無需建置步驟——單一檔案即可在任何地方開啟。它為開發者與 AI 代理提供了一套完整的 CSS 自訂屬性(設計標記)、版面規則、系統字型排版、列印樣式與無障礙設計指引。系統支援所有現代瀏覽器與 PDF 渲染引擎,並透過 `:root` 自訂屬性與深色主題覆寫,讓文件可主題化且可列印。主要使用方式為複製 `references/cv-template.html` 作為起點,它已整合所有設定。

相容平台~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 解析時保留。
  • 實心重點色填滿的頁首、漸層、內容上的陰影,或每個區塊之間的裝飾分隔線。
  • 由瀏覽器注入的頁首與頁尾(日期、網址、頁碼)——在列印對話框中停用它們。

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.

相關技能