audit-typography について
audit-typographyは、具体的な問題と修正方法に焦点を当てた、チェックリスト形式のWebタイポグラフィ監査スキルです。開発者が優先度に沿って変更ファイルを確認し、該当箇所を報告できます。
主な機能
- 0110カテゴリ、89項目のルール
- 02変更ファイルまたは全体を監査
- 03カテゴリ別に必要なルールを参照
- 04重大度と影響度の高い項目を優先
- 05ファイル位置と修正案を報告
活用シーン
- 01変更したCSSファイルのタイポグラフィ確認
- 02Webタイポグラフィ監査の問題を優先順位付け
- 03該当ルールを再実行して修正を検証
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ mblode/ agent-skills --skill audit-typographyインストール後、Claude Code で/audit-typographyを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
rules/_sections.md_template.mdbrand-capitalization.mdbrand-color.mdbrand-cross-medium.mdbrand-dark-backgrounds.mdbrand-equity.mdbrand-identifiable-body.mdbrand-licensing.mdbrand-logo-typeface.mddisplay-cuts.mddisplay-drop-caps.mddisplay-grid-breaking.mddisplay-headline-opentype.mddisplay-headline-spacing.mddisplay-large-type.mddisplay-lead-paragraph.mddisplay-swashes.mdfont-body-selection.mdfont-condensed-extended.mdfont-face-setup.mdfont-fallbacks.mdfont-monospaced.mdfont-optical-sizes.mdfont-quality.mdfont-true-styles.mdfont-variable-fonts.mdfont-weight-body.mdhierarchy-body-first.mdhierarchy-caps-subheads.md詳細
タイポグラフィの監査
Web タイポグラフィの品質に関する10カテゴリー、89個のルールです。具体的な問題と具体的な修正方法に重点を置いています。
監査ワークフロー
監査中はこのチェックリストをコピーして、進捗を記録してください。
Audit progress:
- [ ] Step 1: Scope changed surfaces and select relevant categories
- [ ] Step 2: Run CRITICAL checks (punctuation, font setup)
- [ ] Step 3: Run HIGH checks (sizing, spacing)
- [ ] Step 4: Run MEDIUM+ checks for remaining categories in scope
- [ ] Step 5: Report findings with file:line and concrete fixes
- 全体の確認を依頼された場合を除き、変更されたファイルのみを監査します。
- CSS の
font-family、@font-face、font-feature-settings、サイズや間隔に関するプロパティをスキャンし、該当するカテゴリーを特定します。 - カテゴリーのプレフィックスごとにルールファイルを段階的に読み込み、該当するものだけを確認します。
- 中優先度の仕上げよりも先に、CRITICAL と HIGH の指摘事項を優先します。
- 修正後、最終確認の前に該当するルールを再実行します。
優先度別のルールカテゴリー
| 優先度 | カテゴリー | 影響度 | プレフィックス | ルール数 |
|---|---|---|---|---|
| 1 | 句読点と特殊文字 | CRITICAL | punct- | 12 |
| 2 | フォントの選択とウェイト | CRITICAL | font- | 10 |
| 3 | サイズと文字幅 | HIGH | size- | 7 |
| 4 | 間隔とリズム | HIGH | spacing- | 10 |
| 5 | OpenType 機能 | MEDIUM-HIGH | opentype- | 8 |
| 6 | 階層とスケール | MEDIUM-HIGH | hierarchy- | 8 |
| 7 | 配置とレイアウト | MEDIUM | layout- | 8 |
| 8 | 書体の組み合わせ | MEDIUM | pairing- | 10 |
| 9 | ブランドとアイデンティティ | LOW-MEDIUM | brand- | 8 |
| 10 | ディスプレイと見出し | LOW-MEDIUM | display- | 8 |
クイックリファレンス
現在の監査範囲に必要なものだけを読みます。
- カテゴリーマップと影響度の根拠:
rules/_sections.md - ルールごとのガイダンスと例:
rules/<prefix>-*.md
ルールファイルの例:
rules/punct-smart-quotes.md
rules/font-true-styles.md
rules/size-line-height.md
各ルールファイルには次の内容が含まれます。
- ルールが重要な理由
- 不適切な例
- 適切な例
レビュー結果の形式
次の形式で指摘事項を報告します。
## Typography Audit Findings
### path/to/file.css
- [CRITICAL] `punct-smart-quotes`: Straight quotes used in heading text.
- Fix: Replace `"` with `“`/`”` entities.
### path/to/clean-file.css
- ✓ pass
- 指摘事項はファイルごとにまとめます。
- 行番号がわかる場合は
file:lineを使用します。 - 問題点を示し、具体的な修正方法を提案します。
- 問題のないファイルも
✓ passとして記載します。
コメント
Markdown 対応