Communitygithub.com

wjdgus6480/portfolio

個人開発者ポートフォリオのUI/UXおよびビジュアルデザイン基準を定義するスキルです。

portfolio とは?

このスキルは、AIエージェント(Claude Code、Cursor、Codexなど)向けに設計された、個人開発者ポートフォリオの包括的なデザインシステムです。主な目的は、単なる技術リストではなく、問題発見からAIやソフトウェアを活用したプロダクト開発までを行う開発者としての印象を与えることです。 スキルはLight Mode優先、クリーンなホワイト/ライトグレーベース、限定的なブルーアクセント、豊富なホワイトスペース、強いタイポグラフィによるミニマルでプロフェッショナルなデザインを定義。カラーシステム、タイポグラフィスケール、レイアウト、グリッド、ヘッダー、ヒーローセクション、プロジェクトカードなど、全35以上のセクションで詳細なUI基準を規定しています。 特に重要なのは、データの整合性と実体験に基づくコンテンツの原則です。存在しないプロジェクトや技術経験を作り出さず、コンテンツとUIを完全に分離。プロジェクトデータは構造化された形式で管理し、UIコードを変更せずにプロジェクトを追加・編集できる設計を推奨します。また、React Server Componentを基本とし、必要最小限のクライアントコンポーネント使用、Tailwind CSSとCSS Variablesの組み合わせ、アクセシビリティ、レスポンシブデザインを必須要件としています。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/wjdgus6480/portfolio/tree/HEAD/claude/skills/design-theme

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

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

ドキュメント

デザインテーマスキル

1. スキルアイデンティティ

  • 名前: design-theme
  • 目的: 個人開発者ポートフォリオの全体のUI/UXおよびビジュアルデザイン基準を定義します。
  • 対象: AI / ソフトウェア / プロダクト開発者ポートフォリオ
  • 主要目標: 技術を羅列するポートフォリオではなく、実際の問題を発見し、AIとソフトウェアを活用してプロダクトを作る開発者という印象を与えます。

2. コアデザイン哲学

このポートフォリオは以下の印象を優先します。

  • Professional
  • Modern
  • Minimal
  • Technical
  • Product-oriented
  • Readable
  • Trustworthy

核心理念

「装飾よりもコンテンツとプロジェクトが主役であるべき」

ユーザーが最初の画面を見たときに、以下の内容を素早く理解できる必要があります。

  1. 誰か?
  2. 何を作っているか?
  3. どのような問題を解決しているか?
  4. どのようなプロジェクトを作ったか?
  5. どのような技術を使っているか?
  6. 実際に開発できる人か?

3. ビジュアルディレクション

基本方針

  • Light Mode優先
  • 清潔な白色/明るいグレーベース
  • 限定的なブルーアクセント
  • 薄いBorder
  • 十分なWhitespace
  • 強いTypography
  • 整頓されたGrid
  • 過度な装飾は最小限

避けるべき方針

以下のデザインは基本的に使用しません。

  • 過度なGradient
  • 強いGlow
  • Glassmorphism
  • 過度な3D効果
  • 意味のないアニメーション
  • 過度なShadow
  • Rainbow Color
  • 過度に多いBadge
  • 装飾用イラストの乱用
  • AIポートフォリオにありがちなGeneric Template
  • 技術ごとに異なる色を使う無分別なTech Badge
  • コンテンツよりもデザインが先に見えるレイアウト

4. カラーシステム

Base

Background      #FAFAFA
Surface         #FFFFFF
Foreground      #18181B
Text Secondary  #52525B
Text Weak       #71717A
Placeholder     #A1A1AA
Border          #E4E4E7
Background Weak #F4F4F5

Accent

Accent          #2563EB
Accent Hover    #1D4ED8
Accent Soft     #EFF6FF

Accentは画面全体で限定的に使用します。

Accent使用箇所

  • Primary CTA
  • 主要リンク
  • Active Navigation
  • Focus状態
  • 重要な情報
  • Project Statusの中で強調が必要な状態

Accentを画面全体の背景や装飾として過度に使用しないでください。

Status

Success #16A34A
Warning #D97706
Error   #DC2626

Status Colorは実際の状態を表現するときのみ使用します。


5. タイポグラフィ

フォント優先順位

韓国語の可読性を優先します。

推奨順序:

Pretendard
system-ui
sans-serif

コード、技術名、数字、メタ情報には以下を使用できます。

Geist Mono
monospace

Typography Scale

Hero

Desktop:

56px ~ 72px
font-weight: 700 ~ 800
line-height: 1.05 ~ 1.15

Mobile:

40px ~ 48px
font-weight: 700 ~ 800
line-height: 1.1 ~ 1.2

H2

Desktop:

36px ~ 44px

Mobile:

30px ~ 34px

H3

20px ~ 24px

Body

16px ~ 18px
line-height: 1.6 ~ 1.75

Small / Meta

13px ~ 14px

6. レイアウトシステム

Container

基本最大幅:

1200px

Horizontal Padding

Desktop:

32px ~ 48px

Tablet:

24px

Mobile:

20px

Section Spacing

Desktop:

120px ~ 160px

Mobile:

80px ~ 100px

ページ全体に同じ間隔を強制しません。

コンテンツの重要度に応じて間隔を調整します。


7. グリッドシステム

Project領域は基本的に以下の構造を使用します。

Desktop

2 Columns

Tablet

2 Columns

Mobile

1 Column

3列以上のGridは特別な理由がない限り使用しません。

プロジェクトカードのコンテンツが十分に読めることの方がGridの数より重要です。


8. ヘッダー

Headerはポートフォリオのナビゲーションを支援する最小限のUIで構成します。

推奨構造:

Logo / Name
Projects
About / Approach
Contact

必要に応じてResumeやGitHubリンクを追加できます。

Headerの原則

  • 過度に大きなHeaderは禁止
  • Navigationを過度に増やさない
  • Mobileでは必要な場合にMenuに折りたたむ
  • Active状態にはAccentを限定的に使用する

9. ヒーロー

Heroは最初の画面で最も重要な領域です。

目標は華やかに見せることではなく、開発者のアイデンティティを即座に伝えることです。

推奨構造:

Eyebrow
↓
Main Heading
↓
Short Description
↓
Primary CTA / Secondary CTA

例:

問題を発見したら、
自ら作ります。

AIとソフトウェアを活用して実際の問題を解決し
プロダクトにする開発者、ユン・ジョンヒョン

ただし、実際の最終的な文言は別のコンテンツファイルで管理します。

Heroコンポーネント内にコンテンツをハードコーディングしません。


10. プロジェクトデザイン

プロジェクトはポートフォリオの核となるコンテンツです。

Project Cardは単に技術名だけを表示するカードであってはなりません。

可能であれば以下の情報を伝えます。

Project Name
Status
Short Summary
Problem
Solution
Technology
Period

全ての情報を1つのカードに強制的に入れません。

情報が多い場合は詳細ページに誘導します。


11. プロジェクトカード

基本スタイル:

Background: #FFFFFF
Border: 1px solid #E4E4E7
Border Radius: 12px ~ 16px
Padding: 24px ~ 32px
Shadow: none または非常に弱く

Hover効果は最小限にします。

推奨:

border-color変化
background変化
transform: 非常に小さいレベル

過度な拡大効果やGlowは使用しません。


12. プロジェクトステータス

プロジェクトの状態は明確に表現します。

例:

Live
In Progress
Archived

状態を表現する際、色だけで意味を伝えません。

テキストまたはアイコンを併用します。


13. テクノロジータグ

技術タグは情報を素早く把握するための補助要素です。

技術ごとに虹色を適用しません。

基本的にNeutralスタイルを使用します。

例:

Next.js
TypeScript
Python
FastAPI
Supabase
SQLite
AI Agent

技術タグがプロジェクトの説明よりも目立ってはいけません。


14. プロジェクト詳細ページ

Project Cardクリック時、以下の構造を使用できます。

Project Header
↓
Overview
↓
Problem
↓
Approach
↓
Implementation
↓
Challenges
↓
Result
↓
What I Learned
↓
Technology
↓
Links

全てのプロジェクトが全てのセクションを持つ必要はありません。

実際のプロジェクトに存在する情報のみ表示します。


15. 注目プロジェクト

Homeでは全てのプロジェクトを同じ比重で表示しません。

featured ステータスを基準に主要プロジェクトを選定します。

例:

featured: true

UIは featured の値に基づいてプロジェクトを表示します。

したがって、プロジェクトをFeaturedから外すためにコンポーネントコードを修正する必要はありません。


16. その他のプロジェクト

Featured Projectsの下には、他のプロジェクトも確認できる領域を提供できます。

目的:

プロジェクトが少なく見えないようにするのではなく、 開発者がどのような問題を多様に解決してきたかを示すこと。

Featuredプロジェクトと通常プロジェクトの視覚的な階層を維持します。


17. Approachセクション

一般的な「About Me」ではなく、開発方法を示す領域を優先的に検討します。

例:

01 Problem
02 Discovery
03 Learning
04 Building
05 Result

核となるメッセージは次の通りです。

問題を発見し → 調査し → 必要な技術を学び → 自ら作り → 結果を確認する。

単なる自己紹介よりも、実際の開発プロセスと思考方法を示すことを優先します。


18. スキル

Skillsは技術リストを羅列するのではなく、実際の使用コンテキストを示します。

推奨分類:

Frontend
Backend
AI / Automation
Database
Tools

例:

Frontend
Next.js
React
TypeScript
Tailwind CSS

Backend
Python
FastAPI
Flask

AI / Automation
AI Agent
RAG
LLM API
Automation

Database
SQLite
PostgreSQL
Supabase

Tools
Git
GitHub
VS Code

ただし、実際に使用した経験のない技術は追加しません。


19. スキル表現

技術習熟度を任意の数字や星評価で表現しません。

使用禁止:

Python ★★★★★
React 90%
AI 95%

代わりに、実際のプロジェクトと使用目的を結びつけます。

例:

Python
→ AI Agent / Automation / Backendプロジェクトで使用

20. お問い合わせ

Contact領域はシンプルかつ明確に構成します。

推奨:

Short Message
Email
GitHub
LinkedIn またはその他の実際のリンク

実際に存在しない連絡先やリンクは作成しません。


21. フッター

Footerは最小限で構成します。

例:

© 2026 ユン・ジョンヒョン
Built with Next.js

必要以上に情報を入れません。


22. レスポンシブデザイン

必ず以下の環境を考慮します。

Desktop
Tablet
Mobile

単に画面を縮小する方法でレスポンシブを実装しません。

特にMobileでは:

  • Navigation構造の変更
  • Hero Typographyの調整
  • Grid → 1 Column
  • Buttonサイズの調整
  • Paddingの縮小
  • 長いテキストの折り返し確認
  • Project Card情報の優先順位調整

を適用します。


23. アクセシビリティ

基本的なアクセシビリティを必ず考慮します。

  • 適切なHeading hierarchy
  • 十分な色のコントラスト
  • Keyboard Focus
  • 明確なButton / Link
  • 画像のAlt Text
  • 44px以上のタッチ領域推奨
  • 色だけで状態を区別しない
  • アニメーションがなくても情報伝達が可能な構成

24. アニメーション

Animationは機能を補助する場合のみ使用します。

推奨:

150ms ~ 300ms
ease-out

使用可能な領域:

  • Button Hover
  • Link Hover
  • Card Hover
  • Navigation
  • 短いSection Reveal

使用しないもの:

  • Parallax
  • 過度なScroll Animation
  • 継続的な動き
  • 意味のない装飾アニメーション
  • ページ遷移時の過度な演出

25. ダークモード

現時点の1次バージョンではLight Modeを優先します。

Dark Modeは別途要件がある場合に追加します。

Dark Modeのために現在のデザインシステムやコンポーネント構造が複雑にならないようにします。


26. 技術デザインルール

Tailwind CSSを基本スタイルシステムとして使用します。

CSS Variablesはグローバルなデザイントークンを管理する目的で使用します。

推奨:

Tailwind
+
CSS Variables

不要なインラインスタイルは使用しません。


27. コンポーネントルール

React Server Componentをデフォルトとして使用します。

以下の場合のみClient Componentを使用します。

  • ユーザー入力
  • 状態管理
  • ブラウザAPI
  • イベントベースのインタラクション
  • アニメーションライブラリなど、Client実行が必要な場合

不必要にページ全体をClient Componentにしません。


28. コンテンツ/UIの分離

コンテンツとUIを分離します。

推奨構造:

content/
├─ profile.ts
├─ projects.ts
├─ skills.ts
└─ types.ts

UIコンポーネント内にプロジェクト情報を直接記述しません。

プロジェクト追加または修正時、可能であれば:

content/projects.ts

のみを修正すれば画面に反映されるように設計します。


29. プロジェクトデータ原則

Projectデータは構造化された形式で管理します。

例:

{
  slug,
  title,
  summary,
  problem,
  solution,
  tech,
  status,
  featured,
  period,
  image,
  links,
  highlights
}

必要な値のみ使用します。

実際に存在しない情報は任意に入力しません。


30. 画像ルール

プロジェクト画像が実際に存在しない場合、任意の画像を生成したり取得したりしません。

Placeholderが必要な場合は、明確にPlaceholderであることを示します。

実際のプロジェクトスクリーンショットが確保されたら、プロジェクト画像に差し替えられるように構造を作ります。


31. データ整合性

ポートフォリオの最も重要な原則の1つです。

絶対に以下を任意に作成しません。

  • 存在しないプロジェクト
  • 存在しない技術経験
  • 存在しない成果
  • 存在しない数値
  • 存在しない顧客
  • 存在しない会社経験
  • 存在しないリンク
  • 存在しない資格/認定
  • 存在しないプロジェクト結果

情報が不足している場合は:

空のままにする

または

ユーザーに確認する

を優先します。


32. 既存プロジェクトの保存

既存プロジェクトの意味を任意に変更しません。

ユーザーが提供したプロジェクトの説明や要件に基づいて作業します。

既存機能を削除または縮小する必要がある場合は、まず理由を説明し、確認を求めます。


33. ポートフォリオ情報アーキテクチャ

基本Home構造は以下を優先的に検討します。

Header
↓
Hero
↓
Featured Projects
↓
More Projects
↓
Approach
↓
Skills
↓
Contact
↓
Footer

ただし、実際のコンテンツとユーザビリティに応じて調整できます。


34. デザイン決定の優先順位

デザインに矛盾が生じた場合は、以下の優先順位に従います。

1. Content readability
2. Information hierarchy
3. Accessibility
4. Responsive usability
5. Consistency
6. Visual aesthetics
7. Decorative effects

綺麗なデザインよりも、読みやすく理解しやすいデザインを優先します。


35. 実装ワークフロー

新しいページやUIを作成する際、次の順序に従います。

STEP 1. Analyze

現在のプロジェクト構造と既存のUIをまず確認します。

STEP 2. Plan

必要な情報構造と画面構成を提案します。

STEP 3. Design

このSKILL.mdのデザイン原則に基づいてビジュアル方向性を提案します。

STEP 4. Component

必要なコンポーネント構造を提案します。

STEP 5. Confirm

大きな構造変更や新機能は、実装前にユーザー確認を受けます。

STEP 6. Implement

確定した範囲のみ実装します。

STEP 7. Verify

以下を確認します。

TypeScript
Build
Responsive
Accessibility
Visual consistency
Existing functionality

36. 変更管理

小さな修正は既存の構造を最大限維持します。

大きな変更の前には:

  1. 現在の構造を確認
  2. 変更理由を説明
  3. 影響範囲を確認
  4. 代替案を提示
  5. ユーザー承認
  6. 実装

の順序に従います。


37. 依存関係

新しいライブラリは必要性が明確な場合のみ追加します。

既存のNext.js / React / TypeScript / Tailwindの機能で解決できる場合、新しいライブラリは追加しません。

ライブラリ追加が必要な場合は:

なぜ必要なのか
何を解決するのか
代替方法はあるのか

をまず検討します。


38. Supabase / Backendの原則

現在のポートフォリオ1次バージョンは静的コンテンツベースで開始します。

content/*.ts

を優先して使用します。

SupabaseなどのBackendは、以下の要件が実際に必要になったときに追加します。

  • 管理画面
  • プロジェクトCRUD
  • ブログ
  • 開発記録
  • 問い合わせ保存
  • 認証
  • 動的データ管理

Backendが必要ない段階でデータベースを先に導入しません。


39. Gitワークフロー

意味のある作業単位が完了したらコミットします。

基本フロー:

git add .
git commit -m "作業内容"
git push

Commit MessageはConventional Commit形式を推奨します。

例:

feat: add portfolio homepage
feat: add project section
style: improve project cards
fix: resolve mobile layout
refactor: simplify project components
docs: update portfolio documentation
chore: update dependencies

作業単位を過度に大きくまとめません。


40. 最終品質基準

完成した画面は以下の質問に「はい」と答えられる必要があります。

  • 最初の画面で開発者のアイデンティティが見えるか?
  • プロジェクトが核となるコンテンツとして見えるか?
  • 各プロジェクトが何を解決したか理解できるか?
  • 技術リストよりも実際の結果とプロセスが強調されているか?
  • モバイルでも読みやすいか?
  • コンテンツとUIが分離されているか?
  • 新しいプロジェクトを簡単に追加できるか?
  • 実際に存在しない情報が含まれていないか?
  • 過度なデザイン効果なしにプロフェッショナルな印象を与えるか?
  • 既存機能を不必要に削除していないか?

41. 譲れないルール

以下の原則は常に維持します。

  1. コンテンツより装飾が先に立たない。
  2. プロジェクトがポートフォリオの核である。
  3. 実際の経験でない内容を作り出さない。
  4. ユーザーが提供していない成果や数値を任意に追加しない。
  5. コンテンツとUIを分離する。
  6. Responsive Designを基本とする。
  7. Accessibilityを考慮する。
  8. 不要なライブラリを追加しない。
  9. 既存機能を任意に削除しない。
  10. 大きな構造変更は実装前にユーザーと確認する。
  11. デザインはProfessional / Modern / Minimal / Technicalの方向性を維持する。
  12. Light Modeを1次デフォルトとして維持する。
  13. プロジェクト追加時にUIコードを修正しなくて済むように設計する。
  14. 全てのデザイン決定は可読性と情報伝達を優先する。

関連スキル