Communitygithub.com

tmnhutwork/デザインシステム管理

デザインシステムを監査・文書化・拡張します。コンポーネント間の命名の不整合やハードコード値の確認、コンポーネントのバリアント・ステート・アクセシビリティノートの文書化、既存システムに適合する新しいパターンの設計に使用します。

デザインシステム管理 とは?

このスキルは、デザインシステムの管理を支援するものです。主に3つのコマンドを提供します:/design-system audit(システム全体の監査)、/design-system document [component](コンポーネントの文書化)、/design-system extend [pattern](新しいコンポーネントやパターンの設計)。監査では、命名の一貫性、トークンカバレッジ、コンポーネントの完全性を評価し、優先アクションを提示します。文書化では、コンポーネントの説明、バリアント、プロパティ、ステート、アクセシビリティ、Do's and Don'tsなどを構造化して出力します。拡張では、新しいコンポーネントの提案に必要な問題、既存パターンとの比較、API設計、使用トークン、アクセシビリティ、未解決問題を整理します。また、Figmaやナレッジベースと連携することで、より高度な監査や文書公開が可能です。このスキルはClaude CodeやCursorなどのAIエージェントプラットフォームで利用でき、デザインシステムの一貫性維持と効率的な運用に貢献します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/tmnhutwork/Landingpage-Photo-Retouch/tree/HEAD/.agents/plugins/anthropic-design/skills/design-system

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

/design-system

見慣れないプレースホルダーや接続されているツールの確認が必要な場合は、CONNECTORS.md を参照してください。

デザインシステムを管理します — 一貫性を監査し、コンポーネントを文書化し、新しいパターンを設計します。

使用方法

/design-system audit                    # システム全体の監査
/design-system document [component]     # コンポーネントの文書化
/design-system extend [pattern]         # 新しいコンポーネントまたはパターンの設計

デザインシステムの構成要素

デザイントークン

ビジュアル言語を定義する原子値:

  • 色(ブランド、セマンティック、ニュートラル)
  • タイポグラフィ(スケール、ウェイト、行間)
  • スペーシング(スケール、コンポーネントパディング)
  • ボーダー(半径、幅)
  • シャドウ(エレベーションレベル)
  • モーション(持続時間、イージング)

コンポーネント

定義された以下の要素を持つ再利用可能なUI要素:

  • バリアント(プライマリ、セカンダリ、ゴースト)
  • ステート(デフォルト、ホバー、アクティブ、無効、ローディング、エラー)
  • サイズ(sm、md、lg)
  • 動作(インタラクション、アニメーション)
  • アクセシビリティ(ARIA、キーボード)

パターン

コンポーネントを組み合わせた一般的なUIソリューション:

  • フォーム(入力グループ、バリデーション、送信)
  • ナビゲーション(サイドバー、タブ、パンくずリスト)
  • データ表示(テーブル、カード、リスト)
  • フィードバック(トースト、モーダル、インラインメッセージ)

原則

  1. 創造性よりも一貫性 — システムはチームが車輪の再発明をしないために存在する
  2. 制約の中での柔軟性 — コンポーネントは構成可能であって、硬直的であってはならない
  3. すべてを文書化する — 文書化されていなければ存在しないも同然
  4. バージョン管理と移行 — 破壊的変更には移行パスが必要

出力 — 監査

## デザインシステム監査

### サマリー
**レビュー済みコンポーネント数:** [X] | **発見された問題数:** [X] | **スコア:** [X/100]

### 命名の一貫性
| 問題 | コンポーネント | 推奨事項 |
|------|----------------|----------|
| [不整合な命名] | [リスト] | [採用すべき標準] |

### トークンカバレッジ
| カテゴリ | 定義済み | 見つかったハードコード値 |
|----------|----------|----------------------|
| 色 | [X] | [X]個のハードコードされた16進数値 |
| スペーシング | [X] | [X]個の任意の値 |
| タイポグラフィ | [X] | [X]個のカスタムフォント/サイズ |

### コンポーネント完全性
| コンポーネント | ステート | バリアント | ドキュメント | スコア |
|--------------|--------|----------|------------|-------|
| Button | ✅ | ✅ | ⚠️ | 8/10 |
| Input | ✅ | ⚠️ | ❌ | 5/10 |

### 優先アクション
1. [最も影響力のある改善]
2. [第2の優先事項]
3. [第3の優先事項]

出力 — 文書化

## コンポーネント: [名前]

### 説明
[このコンポーネントが何であるか、いつ使用するか]

### バリアント
| バリアント | 使用するタイミング |
|-----------|----------------|
| [プライマリ] | [主要なアクション] |
| [セカンダリ] | [補助的なアクション] |

### プロパティ
| プロパティ | 型 | デフォルト | 説明 |
|----------|------|---------|-------------|
| [prop] | [type] | [default] | [description] |

### ステート
| ステート | 視覚 | 動作 |
|---------|------|--------|
| デフォルト | [説明] | — |
| ホバー | [説明] | [インタラクション] |
| アクティブ | [説明] | [インタラクション] |
| 無効 | [説明] | 非インタラクティブ |
| ローディング | [説明] | [アニメーション] |

### アクセシビリティ
- **ロール:** [ARIAロール]
- **キーボード:** [Tab、Enter、Escapeの動作]
- **スクリーンリーダー:** [次のようにアナウンスされる...]

### 推奨事項と禁止事項
| ✅ 推奨 | ❌ 禁止 |
|--------|---------|
| [ベストプラクティス] | [アンチパターン] |

### コード例
[フレームワークに適したコードスニペット]

出力 — 拡張

## 新しいコンポーネント: [名前]

### 問題
[このコンポーネントが対処するユーザーニーズまたはギャップ]

### 既存のパターン
| 関連コンポーネント | 類似点 | 不足している理由 |
|-------------------|--------|-----------------|
| [コンポーネント] | [共有するもの] | [不足しているもの] |

### 提案デザイン

#### API / プロパティ
| プロパティ | 型 | デフォルト | 説明 |
|----------|------|---------|-------------|
| [prop] | [type] | [default] | [description] |

#### バリアント
| バリアント | 使用するタイミング | 視覚 |
|-----------|----------------|--------|
| [バリアント] | [シナリオ] | [説明] |

#### ステート
| ステート | 動作 | 備考 |
|---------|--------|------|
| デフォルト | [説明] | — |
| ホバー | [説明] | [インタラクション] |
| 無効 | [説明] | 非インタラクティブ |
| ローディング | [説明] | [アニメーション] |

#### 使用するトークン
- 色: [どのトークン]
- スペーシング: [どのトークン]
- タイポグラフィ: [どのトークン]

### アクセシビリティ
- **ロール:** [ARIAロール]
- **キーボード:** [期待されるインタラクション]
- **スクリーンリーダー:** [次のようにアナウンスされる...]

### 未解決の質問
- [デザインレビューが必要な決定事項]
- [解決すべきエッジケース]

コネクタが利用可能な場合

~~デザインツール が接続されている場合:

  • Figmaのコンポーネントを直接監査 — 命名、バリアント、トークン使用を確認
  • コンポーネントのプロパティとレイヤー構造を文書化のために取得

~~ナレッジベース が接続されている場合:

  • 既存のコンポーネント文書と使用ガイドラインを検索
  • 更新された文書をWikiに公開

ヒント

  1. 監査から始める — どこに向かうかを決める前に、現在地を知ること。
  2. 作りながら文書化する — コンポーネントを設計中に文書化する方が簡単。
  3. カバレッジを完全性より優先する — 10個のコンポーネントの100%よりも、80%のコンポーネントが文書化されている方が良い。

Individual skills in this repo

This repo contains 15 individual skills — each has its own dedicated page.

tmnhutwork/Landingpage-Photo-Retouch

Run a WCAG 2.1 AA accessibility audit on a design or page. Trigger with "audit accessibility", "check a11y", "is this accessible?", or when reviewing a design for color contrast, keyboard navigation, touch target size, or screen reader behavior before handoff.

tmnhutwork/Landingpage-Photo-Retouch

Get structured design feedback on usability, hierarchy, and consistency. Trigger with "review this design", "critique this mockup", "what do you think of this screen?", or when sharing a Figma link or screenshot for feedback at any stage from exploration to final polish.

tmnhutwork/Landingpage-Photo-Retouch

Generate developer handoff specs from a design. Use when a design is ready for engineering and needs a spec sheet covering layout, design tokens, component props, interaction states, responsive breakpoints, edge cases, and animation details.

tmnhutwork/Landingpage-Photo-Retouch

Synthesize user research into themes, insights, and recommendations. Use when you have interview transcripts, survey results, usability test notes, support tickets, or NPS responses that need to be distilled into patterns, user segments, and prioritized next steps.

tmnhutwork/Landingpage-Photo-Retouch

Plan, conduct, and synthesize user research. Trigger with "user research plan", "interview guide", "usability test", "survey design", "research questions", or when the user needs help with any aspect of understanding their users through research.

tmnhutwork/Landingpage-Photo-Retouch

Write or review UX copy — microcopy, error messages, empty states, CTAs. Trigger with "write copy for", "what should this button say?", "review this error message", or when naming a CTA, wording a confirmation dialog, filling an empty state, or writing onboarding text.

tmnhutwork/Landingpage-Photo-Retouch

Design banners for social media, ads, website heroes, creative assets, and print. Multiple art direction options with AI-generated visuals. Actions: design, create, generate banner. Platforms: Facebook, Twitter/X, LinkedIn, YouTube, Instagram, Google Display, website hero, print. Styles: minimalist, gradient, bold typography, photo-based, illustrated, geometric, retro, glassmorphism, 3D, neon, duotone, editorial, collage. Uses ui-ux-pro-max, frontend-design, ai-artist, ai-multimodal skills.

tmnhutwork/Landingpage-Photo-Retouch

Brand voice, visual identity, messaging frameworks, asset management, brand consistency. Activate for branded content, tone of voice, marketing assets, brand compliance, style guides.

tmnhutwork/Landingpage-Photo-Retouch

Comprehensive design skill: brand identity, design tokens, UI styling, logo generation (55 styles, Gemini AI), corporate identity program (50 deliverables, CIP mockups), HTML presentations (Chart.js), banner design (22 styles, social/ads/web/print), icon design (15 styles, SVG, Gemini 3.1 Pro), social photos (HTML→screenshot, multi-platform). Actions: design logo, create CIP, generate mockups, build slides, design banner, generate icon, create social photos, social media images, brand identity, design system. Platforms: Facebook, Twitter, LinkedIn, YouTube, Instagram, Pinterest, TikTok, Threads, Google Ads.

tmnhutwork/Landingpage-Photo-Retouch

Audit, document, or extend your design system. Use when checking for naming inconsistencies or hardcoded values across components, writing documentation for a component's variants, states, and accessibility notes, or designing a new pattern that fits the existing system.

tmnhutwork/Landingpage-Photo-Retouch

Translates Figma designs into production-ready application code with 1:1 visual fidelity. Use when implementing UI code from Figma files, when user mentions "implement design", "generate code", "implement component", provides Figma URLs, or asks to build components matching Figma specs. For Figma canvas writes via `use_figma`, use `figma-use`.

tmnhutwork/Landingpage-Photo-Retouch

Use the Figma MCP server to fetch design context, screenshots, variables, and assets from Figma, and to translate Figma nodes into production code. Trigger when a task involves Figma URLs, node IDs, design-to-code implementation, or Figma MCP setup and troubleshooting.

tmnhutwork/Landingpage-Photo-Retouch

Create strategic HTML presentations with Chart.js, design tokens, responsive layouts, copywriting formulas, and contextual slide strategies.

tmnhutwork/Landingpage-Photo-Retouch

Create beautiful, accessible user interfaces with shadcn/ui components (built on Radix UI + Tailwind), Tailwind CSS utility-first styling, and canvas-based visual designs. Use when building user interfaces, implementing design systems, creating responsive layouts, adding accessible components (dialogs, dropdowns, forms, tables), customizing themes and colors, implementing dark mode, generating visual designs and posters, or establishing consistent styling patterns across applications.

tmnhutwork/Landingpage-Photo-Retouch

UI/UX design intelligence for web, mobile, and desktop. This skill should be used when designing, building, reviewing, or fixing interfaces, including pages, components, design systems, accessibility, interaction, responsive layout, typography, color, charts, and stack-specific UI implementation. Searchable local data: 79 searchable styles (50 active), 192 product palettes and reasoning profiles, 74 font pairings, 119 UX guidelines, 105 icons, 17 GSAP presets, 25 chart types, and 22 stacks.

関連スキル