# Digital Go Design Skill

> 非公式のスキルです。デジタル庁デザインシステム（DADS、Digital Agency Design System）に沿って、Web サイト・Web アプリの画面を設計・実装・見直しするためのスキル。カラー・タイポグラフィ・余白・レイアウト・角の形状・エレベーション・アイコン・リンクの基準と、ボタンやフォームなど各コンポーネントの仕様、アクセシビリティ要件を公式ドキュメントから引く。「デジタル庁のデザインで」「デジタル庁風に」「DADS に合わせて」「行政サイトのような画面に」「デザインシステムに沿って見直して」といった依頼のほか、業務システム・管理画面・申請フォームを読みやすくアクセシブルに作りたいときにも使う。デジタル庁の名前が出ていなくても、日本語の公共向け・業務向け Web 画面でこの基準を求められているなら使う。Web 専用で、iOS などのネイティブアプリには使わない。

- Skill: `capsrock/digital-go-design-skill` (Agent Skill, multi-file: 162 files)
- Install (CLI): `npx get-skill add capsrock/digital-go-design-skill`
- Raw SKILL.md: https://api.skillmd.com/api/skills/capsrock/digital-go-design-skill/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Design & Media
- Author: capsrock (https://skillmd.com/u/capsrock)
- Updated: 2026-11-14
- Page: https://skillmd.com/skills/capsrock/digital-go-design-skill

---


# digital-go-design-skill

デジタル庁デザインシステムβ版（以下 DADS）の公式ドキュメントを手元で引きながら、画面を作るためのスキルです。

このスキルは非公式です。デジタル庁が作成・承認したものではありません。

デジタル庁デザインシステムウェブサイト https://design.digital.go.jp/dads/ をもとに capsrock が作成しました。条件の詳細は [SOURCE.md](SOURCE.md) にあります。

## 進め方

1. 作る画面の種類と、必要なコンポーネントを洗い出します。
2. `references/dads/MANIFEST.md` で該当ページを探します（全ページの題名と概要の一覧です）。
3. 使うコンポーネントの `references/dads/components/<slug>/index.md` を読みます。下の早見表は入口にすぎないので、実装の前に必ず該当ページの本文を確かめます。コンポーネントごとに、サイズ・状態・配置・アクセシビリティの決まりがあります。
4. 基本デザインに沿って実装し、最後に「満たすべき要件」で点検します。

全ページを読む必要はありません。合計 860KB あるので、必要なページだけを開きます。

## ページの探し方

| 知りたいこと | 場所 |
| --- | --- |
| 全ページの一覧 | `references/dads/MANIFEST.md` |
| カラー、タイポグラフィ、アイコン、レイアウト、リンク、余白、角の形状、エレベーション | `references/dads/foundations/<color・typography・icon・layout・link-text・spacing・corner-shapes・elevation>/index.md` |
| 各コンポーネントの仕様 | `references/dads/components/<slug>/index.md`（一覧は `components/index.md`） |
| 自社のブランドに合わせて変えてよい範囲 | `references/dads/guidance/local-design-system/index.md` |
| アクセシビリティの考え方 | `references/dads/guidance/accessibility/index.md` |
| 利用条件・出典の書き方 | `references/dads/introduction/notices/index.md` |

各ファイルの冒頭の `source_url` が公式ページの URL です。図版は Markdown に入っていないので、図の内容が判断に関わるときは公式ページを見ます。

## 色などの値は同梱のトークンから取る

ドキュメントの Markdown には、白と黒以外の HEX 値が載っていません。`Yellow-300` や `Gray-536` のような色名は出てきますが、値は書かれていません。

色・文字サイズ・行高・角丸などの値は、記憶や推測で書かず、同梱の公式トークンから取ります。GitHub や npm から取得し直す必要はありません。

- `references/tokens/tokens.css`: すべてのトークンです。通常はこちらを使います。
- `references/tokens/tokens-simple.css`: 色・フォント・エレベーションだけのサブセットです。

CSS 変数の名前は次のように対応します。

| 種類 | 変数の例 |
| --- | --- |
| 色の階調 | `--color-primitive-yellow-300` |
| ニュートラル | `--color-neutral-solid-gray-536` |
| キーカラー（初期値は青の階調） | `--color-key-800` |
| セマンティックカラー | `--color-semantic-error-1` |
| 文字 | `--font-size-16`、`--line-height-170`、`--font-weight-700`、`--font-family-sans` |
| 角丸 | `--border-radius-16` |

トークンが `:root` に定義されているので、CSS に読み込むか、必要な行を写して使います。ブランドの色に変えるときは、`--color-key-*` の割り当てを差し替えます。

同梱分はパッケージ 2.1.0 です。リポジトリの対応表では Figma データ 2.0.4〜2.18.1 に対応します。ドキュメントの版とは別に更新されているので、値が食い違っていたら利用者に伝えます。

## 早見表

以下は 2026年10月21日版の本文から抜き出した値です。

**書体**

- 本文は `'Noto Sans JP', sans-serif`、コードは `'Noto Sans Mono', monospace`。システムフォントの使用を禁じるものではありません。
- 太さは N（400）と B（700）の2段階です。
- 本文と UI は 16 CSS px 以上を基準にします。14 CSS px は、領域の制約などで標準の大きさを使えないときに限ります。
- 読み物の本文の行高は、フォントサイズの 1.5 倍以上にします。
- テキストスタイル名は `Std-17N-170`（種類-大きさ太さ-行高）の形です。

| 種類 | 用途 | 大きさ・行高 |
| --- | --- | --- |
| Display (Dsp) | ページ上部のヘッドコピー | 48・57・64、行高 140% |
| Standard (Std) | 見出しと本文 | 16〜45。45 と 36 は 140%、32〜20 は 150%、18 は 160%、17 は 170%、16 は 170% か 175% |
| Dense (Dns) | 管理画面、データテーブル | `foundations/typography/index.md` を参照 |
| Oneline (Oln) | 1行の UI 要素 | 行高 100% |
| Mono | コード | 行高 150%、等幅 |

**色**

- テキストと背景のコントラスト比は 4.5:1 以上です。
- 枠線・ディバイダーなどの非テキスト要素と背景は 3:1 以上です。
- プライマリーカラーは主要な背景色に対して 4.5:1 以上、セカンダリー・ターシャリーは隣接する場合に 3:1 以上にします。
- フォーカスインジケーターは Yellow-300 と Black の2重構造です。いかなる場合も変更しません。
- セマンティックカラーの色相と意味の結びつきは変えません。

**レイアウトと余白**

- 12カラムが基本です。ガターは原則、本文の文字サイズの2倍にします。
- ブレークポイントの例は 768px です（未満がモバイル・タブレット、以上がデスクトップ）。
- リキッドレイアウトを採用し、見た目の並びと読み上げ順をできるだけ一致させます。
- 余白は 8 CSS px を基準単位にすることが一般的です。絶対の値はありませんが、規則性を持たせます。空白文字や両端揃えで調整しません。

**角の形状**

角丸なし・スモール・ミディアム・ラージ・フルの5段階が基本の目安です。図形の大きさで見え方が変わるので、コンポーネント単位で決めます。ドキュメントの図の例では 16・20・24 ですが、トークンは 4・6・8・12・16・24・32・full です。実装ではトークンの値を使います。

**操作**

- ボタンのターゲット領域は 44 CSS px 以上です。Small・X-Small は上下の余白で確保します。
- リンク領域が 24 CSS px に満たない場合の扱いは `foundations/link-text/index.md` にあります。
- アイコンは必ずラベルと組み合わせます。やむを得ずアイコン単体にするときは、代替テキストを設定します。
- リンクは色だけで示さず、下線などのテキスト装飾と組み合わせます。

## 変えてよいところ、変えてはいけないところ

初期のデザイントークンは特定の見た目を規定するものではなく、編集の起点です。キーカラー、角の形状、余白などはブランドに合わせて変えられます。

ただし、アクセシビリティの骨格は維持します。上の数値を下回る変更と、フォーカスインジケーターの変更はできません。詳しくは `guidance/local-design-system/index.md` を読みます。

## 満たすべき要件（仕上げの点検）

- [ ] テキスト 4.5:1、非テキスト 3:1 のコントラストを満たしている
- [ ] 本文と UI が 16 CSS px 以上で、本文の行高が 1.5 倍以上ある
- [ ] キーボードで操作でき、公式のフォーカスインジケーターが表示される
- [ ] ターゲット領域が 44 CSS px 以上ある
- [ ] アイコンにラベルがある
- [ ] リンクが色以外でも見分けられる
- [ ] 余白の値に規則性がある
- [ ] 高さを持つ要素に 3:1 以上の境界がある（影だけに頼っていない）
- [ ] 見た目の順序と読み上げ順序が一致している
- [ ] 強制カラーモードでも境界と状態が判別できる
- [ ] 使ったコンポーネントのページにある固有の要件を満たしている

## 出典の扱い

利用者のために作る画面やコードは、次のように条件が分かれます。詳しくは `introduction/notices/index.md` を読みます。

- `references/tokens/` のトークンをそのまま配布する場合: MIT License の条件として、`references/tokens/LICENSE` の著作権表示とライセンス文を添えます。`tokens.css` の本文には表示がありません。
- コードスニペットや Figma データを編集して作った UI: 出典の明記は不要です。
- 編集せずにそのまま公開する場合: 出典を記載します。
- ドキュメント本文を転載・加工する場合: 出典を記載し、加工した場合はその旨も書きます。
- どの場合も、デジタル庁が作成したように見せてはいけません。デジタル庁の公式サイトに見える画面を作る依頼は、ロゴや名称を使わない形に調整します。

