html-report-design

Files (5)

• README.md
• SKILL.md
• prompt-lite.md · assets/
• report.template.html · assets/
• sample_input_output.md · examples/

SKILL.md (first lines)

# HTML資料デザイン — コンサル品質の出力設計

AIが出すHTMLがダサいのは、**構造を「線と箱」で作るから**。
一流の資料は、構造を**「余白と文字の階層」**で作る。
このスキルは、HTMLを出力するあらゆる場面でその流儀を強制する。

## 目的

HTMLで資料（報告書・分析メモ・提案書・調査サマリー・ダッシュボード）を出すとき、
そのまま社内外に出せる「コンサル品質」のデザインで出力する。
デフォルトのAIっぽい見た目（カード乱立・グラデ・絵文字・虹色）を禁止する。

## 原則（5つ）

1. **区切りは余白で作る。** セクションの境界は64px以上の余白＋横の細罫1本まで。囲み枠は使わない。
2. **階層は文字で作る。** サイズ・太さ・色の濃淡（黒→グレー2段階）で階層を表現する。背景色で表現しない。
3. **色は3つまで。** 紙の白＋インクの黒グレー系＋アクセント1色（既定は濃紺）。アクセントは面積5%以下、重要な数字と構造要素だけに使う。
4. **構造は「メッセージ→根拠」。** 各セクションは見出しの直後に「言いたいこと1文（メッセージライン）」を置き、その下に根拠（表・図・本文）を並べる。
5. **印刷に耐える。** 白背景固定・A4で崩れない。画面映えではなく配布資料として設計する。

## 禁止事項（ダサさの正体。1つでもあれば直す）

- `border` + `border-radius` + `box-shadow` の**カードUI**でコンテンツを囲む
- グラデーション背景（特に紫→青）、ダークテーマ既定
- 絵文字・アイコンを見出しや箇条書きの飾りに使う
- 意味なく色数が増える（青の情報ボックス、黄色の注意ボックス、緑の成功ボックス…）
- 本文・見出しのセンタリング（表紙のみ例外可、既定は左揃え）
- 表の縦罫線・全セル罫線・シマシマ背景
- 角丸・影・立体表現の多用
- `border-left: 4px solid` の色付きコールアウト乱立

## デザインCSS（そのまま使う。変えてよいのは --accent の1色だけ）

```css
:root{
  --ink:#1a1a1a;         /* 本文 */
  --ink-2:#555555;       /* 補足 */
  --ink-3:#8e8e8e;       /* キャプション・出所 */
  --accent:#173f66;      /* アクセント（濃紺）。クライアントカラーがあれば1色だけ差し替え */
  --accent-tint:#eef3f8; /* アクセント淡色。合計行など最小限に */
  --hairline:#d9d9d9;    /* 罫線 */
  --fill-gray:#e7e9ec;   /* 図解の脇役の面（矢羽根・ロードマップのバー） */
  --paper:#ffffff;
}
html{color-scheme:light}
body{
  margin:0;background:var(--paper);color:var(--ink);
  font-family:"Helvetica Neue",Arial,"Hiragino Kaku Gothic ProN","Hiragino Sans","Yu Gothic Medium","Yu Gothic",Meiryo,sans-serif;
  font-size:15px;line-height:1.9;
  border-top:6px solid var(--accent);
  -webkit-font-smoothing:antialiased;
}
.page{max-width:760px;margin:0 auto;padding:56px clamp(24px,6vw,48px) 96px}

/* 表紙ブロック */
.doc-header{padding-bottom:28px;border-bottom:1px solid var(--ink)}
.eyebrow{font-size:11px;letter-spacing:.16em;color:var(--ink-3);text-transform:uppercase;margin:0 0 20px}
h1{font-size:27px;line-height:1.5;letter-spacing:.02em;margin:0 0 12px;font-feature-settings:"palt" 1}
.lead{font-size:14px;color:var(--ink-2);margin:0 0 24px;max-width:38em}
.doc-meta{font-size:12px;color:var(--ink-3);display:flex;gap:24px;flex-wrap:wrap}

/* セクション */
.page>section{border-top:1px solid var(--hairline);padding-top:44px;margin-top:64px}
.page>section:first-of-type{border-top:0;padding-top:0;margin-top:56px}
h2{font-size:19px;letter-spacing:.03em;margin:0;font-feature-settings:"palt" 1}
h2 .no{color:var(--accent);margin-right:14px;font-variant-numeric:tabular-nums}
.msg{font-size:16px;font-weight:600;line-height:1.8;margin:18px 0 24px;max-width:36em}
h3{font-size:15px;margin:36px 0 8px}
p{margin:0 0 16px;max-width:42em}

/* リスト */
ul,ol{margin:0 0 16px;padding-left:1.4em;max-width:41em}
li{margin-bottom:6px}
ul{list-style:none;padding-left:1.2em}
ul li::before{content:"–";float:left;margin-left:-1.2em;color:var(--ink-3)}

/* サマリー（結論の番号付き列挙） */
.summary{list-style:none;margin:24px 0 0;padding:0;counter-reset:s;max-width:44em}
.summary li{counter-increment:s;position:relative;padding-left:2.4em;margin-bottom:14px}
.summary li::before{
  content:counter(s,decimal-leading-zero);position:absolute;left:0;top:.4em;
  font-size:12px;font-weight:700;color:var(--accent);letter-spacing:.04em;
  font-variant-numeric:tabular-nums;
}

/* KPI（数字は箱に入れず、余白と縦罫で並べる） */
.kpis{display:flex;flex-wrap:wrap;row-gap:24px;margin:32px 0 8px}
.kpi{padding:2px 32px}
.kpi:first-child{padding-left:0}
.kpi+.kpi{border-left:1px solid var(--hairline)}
.kpi .v{font-size:30px;font-weight:700;color:var(--accent);line-height:1.3;
  font-variant-numeric:tabular-nums;letter-spacing:.01em}
.kpi .v small{font-size:14px;font-weight:600;margin-left:2px}
.kpi .l{font-size:11.5px;color:var(--ink-3);letter-spacing:.06em;margin-top:6px}

/* 表（縦線なし・横の細罫のみ。数字は右揃え） */
.tbl{overflow-x:auto}
table{width:100%;border-collapse:collapse;margin:28px 0 8px;font-size:13px;line-height:1.6}
caption{text-align:left;font-size:12.5px;font-weight:600;margin-bottom:10px}
th{font-size:12px;font-weight:600;text-align:left;padding:10px 12px;
  border-top:2px solid var(--ink);border-bottom:1px solid var(--ink);vertical-align:bottom}
td{padding:10px 12px;border-bottom:1px solid var(--hairline);vertical-align:top}
th.num,td.num{text-align:right;font-variant-numeric:tabular-nums}
tr.total td{border-top:1px solid var(--ink);border-bottom:2px solid var(--ink);
  font-weight:600;background:var(--accent-tint)}

/* 図表・出所・注記 */
figure{margin:32px 0 8px}
figcaption{font-size:12.5px;font-weight:600;margin-bottom:14px}
figure svg{width:100%;height:auto;display:block}
svg text{font-family:inherit}
.fig-scroll{overflow-x:auto}
.src{font-size:11.5px;color:var(--ink-3);margin:6px 0 0}
.note{font-size:12.5px;color:var(--ink-2);border-left:2px solid var(--hairline);
  padding:2px 0 2px 14px;margin:24px 0 16px;max-width:40em}

/* 矢羽根（プロセス・バリューチェーン。主役フェーズだけ濃紺） */
.chevrons{display:flex;margin:28px 0 8px;min-width:520px}
.chev{flex:1;padding:9px 10px 9px 22px;font-size:12px;font-weight:600;line-height:1.5;

From Ted0321/kotetsu-work-ai-skills, MIT.

More from Ted0321/kotetsu-work-ai-skills