Communitygithub.com

문서 디자인 시스템

이력서, 원페이지 문서, 짧은 보고서를 위한 재사용 가능한 HTML 문서 디자인 시스템입니다. 디자인 토큰, 레이아웃, 타이포그래피, PDF 출력 규칙, 접근성을 제공합니다. 독립형 HTML 문서를 생성하거나 스타일을 변경할 때 사용하세요.

문서 디자인 시스템란 무엇인가요?

이 스킬은 빌드 단계 없이 단일 HTML 파일만으로 화면과 PDF 출력 모두에 최적화된 문서를 만들 수 있는 디자인 시스템입니다. `doc-background`, `doc-accent` 등 CSS 커스텀 프로퍼티로 구성된 디자인 토큰을 통해 일관된 테마를 적용하고, 다크 모드를 기본 지원합니다. 레이아웃은 최대 너비 820px 중앙 정렬, 시스템 폰트 스택 사용으로 가볍고 빠르며, PDF 출력 시 글자 크기와 페이지 나눔을 세밀하게 제어합니다. 접근성을 고려하여 실제 제목 요소와 시맨틱 리스트를 사용하고, color-adjust 속성으로 칩 배경이 PDF에서도 유지되도록 합니다. 이 스킬은 Claude Code, Cursor 등 HTML 문서 생성을 지원하는 모든 AI 어시스턴트에서 사용할 수 있으며, `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에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

문서 디자인

하나의 디자인 시스템으로 독립형 HTML 문서를 만듭니다. 목표: 화면에서도 올바르게 보이고, PDF로 출력할 때도 깔끔하며, 빌드 단계가 없어 어디서나 열 수 있는 단일 파일.

references/cv-template.html을 복사하여 시작점으로 삼으십시오; 이 파일은 아래의 모든 내용을 이미 연결하고 있습니다.

디자인 토큰

모든 색상과 표면을 :root의 커스텀 프로퍼티로 정의하고, 다크 테마 덮어쓰기를 제공합니다. 규칙에서 16진수 값을 절대 하드코딩하지 마십시오; 그래야 문서를 테마화하고 인쇄할 수 있습니다.

: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)를 의미 있는 순서로 사용하십시오; 대문자 스타일링은 HTML에 직접 쓰는 대신 CSS에서 적용합니다.
  • 링크에 설명적인 텍스트를 제공하십시오; 색상만으로 구분하지 마십시오.
  • 글머리 기호에 시맨틱 리스트 구조를 유지하십시오 — 스크린 리더가 리스트 길이를 알려주어 긴 이력서에서 도움이 됩니다.

안티 패턴

  • 다단 레이아웃 — 인쇄에서 깨지고 스크린 리더가 잘못된 순서로 읽습니다.
  • 레이아웃을 위한 테이블.
  • 텍스트 대신 이미지 또는 아이콘 폰트 사용; 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.

관련 스킬