Communitygithub.com

文書デザインシステム

自己完結型HTML文書(CV、単一ページ、短いレポート)のための再利用可能なデザインシステムです。デザイントークン、レイアウト、タイポグラフィ、印刷からPDFへのルール、アクセシビリティを提供します。画面表示またはPDF印刷用のHTML文書を生成・再スタイルする際に使用します。

文書デザインシステム とは?

このスキルは、自己完結型HTML文書のための一貫したデザインシステムを提供します。画面表示でもPDF印刷でも綺麗に表示され、ビルドステップ不要でどこでも開ける単一ファイルとして機能します。 主な特徴は以下の通りです。 - **デザイントークン**: 色やサーフェスをCSSカスタムプロパティ(`:root`)で一元管理し、ダークテーマ対応も容易にします。 - **レイアウト**: 最大幅820px、中央寄せ、適切なパディングとマージンで読みやすさを確保。 - **タイポグラフィ**: システムフォントスタックを使用し、基本フォントサイズ12.8px、密度を重視した設計。 - **印刷ルール**: `@page`ルールで余白制御、改ページ防止、背景色保持などPDF出力に最適化。 - **アクセシビリティ**: 適切な見出し階層、コントラスト確保、意味論的なリスト構造を維持。 このスキルは、Claude Code、Cursor、Codexなど、AIエージェントがCVやレポート用のHTML文書を生成・整形する際に特に有用です。`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;           /* 1つのアクセントカラー、控えめに使用 */
  --doc-accent-soft: #e7f1ee;      /* チップ/薄い背景色 */
}
html[data-theme='dark'] {
  --doc-accent: #4fbfa3;
  --doc-accent-soft: #16332b;
}

ルール:

  • アクセントカラーは1色のみ。セクション見出し、役職/会社名、箇条書きのマーカーのみに使用します。アクセントを多用すると装飾的に見えます。
  • テキストカラーは2色。プライマリは本文、セカンダリはメタデータ(日付、場所、メモ)に使用。
  • 塗りつぶしではなく、薄い色で表現。ベタのアクセントブロックではなく、チップには--doc-accent-softを使用。

レイアウト

  • ページ幅は最大820px、中央寄せ、上部マージン24px。これ以上広いと行の長さが読みやすさを損ねます。
  • ページ内余白は38~42px。余白が視覚的な重みを持つため、外側の境界線は不要。
  • ページ周囲は--doc-background-midで、白いページがシートとして認識されるようにします。
  • セクションは15pxの間隔で積み上げます。構造はボックスやパネルではなく、スペーシングと各セクション見出し下の細い線で表現します。

タイポグラフィ

  • システムフォントスタックを使用し、Webフォントは不使用: -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 を設定し、1つのジョブエントリーがページをまたがないようにします。
  • インタラクティブな要素(ボタン、リンク風のコントロール)は印刷時に非表示にします。

アクセシビリティ

  • コントラストを維持: 白背景にプライマリテキスト、見出しとマーカーのみアクセントカラー。長い本文テキストにはアクセントカラーを使用しないでください。
  • 実際の見出し要素(h1、h2)を適切な順序で使用。大文字はCSSでスタイリングし、HTML上で大文字で入力しない。
  • リンクには説明的なテキストを与え、色だけで区別しない。
  • 箇条書きには意味論的なリスト構造を維持 — スクリーンリーダーがリストの長さを通知し、長いCVで役立ちます。

アンチパターン

  • マルチカラムレイアウト — 印刷で崩れたり、スクリーンリーダーが誤った順序で読み上げます。
  • レイアウトのためのテーブル。
  • テキストの代わりに画像やアイコンフォント — 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.

関連スキル