Communitygithub.com

wjdgus6480/portfolio

Definiert die vollständigen UI/UX- und visuellen Designstandards für ein persönliches Entwickler-Portfolio.

Was ist portfolio?

Dieses Skill definiert ein umfassendes Designsystem für das Portfolio eines Softwareentwicklers, das speziell für KI- und Produktentwickler optimiert ist. Das Hauptziel ist es, den Eindruck eines Entwicklers zu vermitteln, der echte Probleme erkennt und mit KI und Software löst, anstatt nur eine Liste von Technologien zu präsentieren. Das System legt Wert auf Lesbarkeit, Minimalismus, Professionalität und Produktorientierung und bietet klare Richtlinien für Farben, Typografie, Layout, Projektkarten und Zugänglichkeit. Es betont die strikte Trennung von Inhalten und UI, den Verzicht auf dekorative Elemente und die Integrität der Daten, indem keine nicht existierenden Projekte, Erfahrungen oder Metriken erfunden werden dürfen.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Design-Theme Skill

1. Skill-Identität

  • Name: design-theme
  • Zweck: Definiert die gesamten UI/UX- und visuellen Designstandards für ein persönliches Entwickler-Portfolio.
  • Zielgruppe: KI / Software / Produktentwickler Portfolio
  • Hauptziel: Nicht ein Portfolio, das Technologien auflistet, sondern den Eindruck eines Entwicklers vermitteln, der echte Probleme erkennt und Produkte mit KI und Software entwickelt.

2. Kern-Designphilosophie

Dieses Portfolio priorisiert die folgenden Eindrücke:

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

Kernprinzip

„Inhalt und Projekte sollten die Hauptdarsteller sein, nicht die Dekoration.“

Der Benutzer sollte beim Anblick des ersten Bildschirms schnell Folgendes verstehen können:

  1. Wer ist das?
  2. Was wird entwickelt?
  3. Welche Probleme werden gelöst?
  4. Welche Projekte wurden erstellt?
  5. Welche Technologien werden verwendet?
  6. Ist die Person tatsächlich in der Lage zu entwickeln?

3. Visuelle Richtung

Grundrichtung

  • Light Mode priorisieren
  • Saubere weiße/helle graue Basis
  • Limitierte Blue Accent
  • Dünne Borders
  • Großzügiger Whitespace
  • Starke Typografie
  • Aufgeräumtes Grid
  • Minimierung übermäßiger Dekoration

Zu vermeidende Richtungen

Die folgenden Designs werden grundsätzlich nicht verwendet:

  • Übermäßige Gradienten
  • Starke Glow-Effekte
  • Glassmorphism
  • Übermäßige 3D-Effekte
  • Sinnlose Animationen
  • Übermäßige Schatten
  • Regenbogenfarben
  • Zu viele Badges
  • Übermäßiger Einsatz von Deko-Illustrationen
  • Generische Vorlagen, die häufig in KI-Portfolios vorkommen
  • Wahlloser Einsatz von Tech-Badges mit unterschiedlichen Farben für jede Technologie
  • Layouts, bei denen das Design mehr hervorsticht als der Inhalt

4. Farbsystem

Basis

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

Akzent

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

Der Akzent wird auf dem gesamten Bildschirm sparsam eingesetzt.

Akzent-Positionen

  • Primary CTA
  • Hauptlinks
  • Aktive Navigation
  • Fokus-Zustände
  • Wichtige Informationen
  • Projektstatus, die hervorgehoben werden müssen

Der Akzent wird nicht übermäßig als Hintergrund oder Dekoration auf dem gesamten Bildschirm verwendet.

Status

Success #16A34A
Warning #D97706
Error   #DC2626

Statusfarben werden nur verwendet, wenn sie einen tatsächlichen Status darstellen.


5. Typografie

Schriftarten-Priorität

Die Lesbarkeit von Koreanisch wird priorisiert.

Empfohlene Reihenfolge:

Pretendard
system-ui
sans-serif

Für Code, Technologienamen, Zahlen und Metainformationen kann Folgendes verwendet werden:

Geist Mono
monospace

Typografie-Skala

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. Layout-System

Container

Standard maximale Breite:

1200px

Horizontaler Abstand (Padding)

Desktop:

32px ~ 48px

Tablet:

24px

Mobile:

20px

Abschnittsabstand (Section Spacing)

Desktop:

120px ~ 160px

Mobile:

80px ~ 100px

Einheitliche Abstände werden nicht über die gesamte Seite erzwungen.

Die Abstände werden basierend auf der Wichtigkeit des Inhalts angepasst.


7. Grid-System

Der Projektbereich verwendet standardmäßig die folgende Struktur:

Desktop

2 Spalten

Tablet

2 Spalten

Mobile

1 Spalte

Grids mit 3 oder mehr Spalten werden ohne besonderen Grund nicht verwendet.

Die ausreichende Lesbarkeit des Inhalts der Projektkarten ist wichtiger als die Anzahl der Grids.


8. Header

Der Header besteht aus einer minimalen UI, die die Navigation durch das Portfolio unterstützt.

Empfohlene Struktur:

Logo / Name
Projects
About / Approach
Contact

Bei Bedarf können ein Link zum Lebenslauf oder GitHub hinzugefügt werden.

Header-Prinzipien

  • Kein übermäßig großer Header
  • Navigation nicht übermäßig erweitern
  • Auf Mobilgeräten bei Bedarf auf ein Menü reduzieren
  • Aktiven Status mit sparsamen Akzenten kennzeichnen

9. Hero

Der Hero-Bereich ist der wichtigste Bereich auf dem ersten Bildschirm.

Das Ziel ist nicht, auffällig zu sein, sondern die Identität des Entwicklers sofort zu vermitteln.

Empfohlene Struktur:

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

Beispielrichtung:

Probleme erkennen,
selbst lösen.

Ein Entwickler, der reale Probleme mit KI und Software löst
und daraus Produkte macht, Jeonghyeon Yun

Die endgültigen Formulierungen werden jedoch in einer separaten Inhaltsdatei verwaltet.

Inhalte werden nicht fest im Hero-Komponenten codiert.


10. Projektdesign

Projekte sind der Kerninhalt des Portfolios.

Eine Projektkarte sollte nicht nur der Anzeige von Technologienamen dienen.

Nach Möglichkeit werden die folgenden Informationen vermittelt:

Project Name
Status
Short Summary
Problem
Solution
Technology
Period

Es wird nicht erzwungen, alle Informationen auf einer Karte unterzubringen.

Bei vielen Informationen wird auf eine Detailseite verlinkt.


11. Projektkarte

Standardstil:

Background: #FFFFFF
Border: 1px solid #E4E4E7
Border Radius: 12px ~ 16px
Padding: 24px ~ 32px
Shadow: none oder sehr schwach

Hover-Effekte werden minimiert.

Empfohlen:

border-color Änderung
background Änderung
transform: sehr geringes Ausmaß

Übermäßige Vergrößerungseffekte oder Glow werden nicht verwendet.


12. Projektstatus

Der Projektstatus wird klar dargestellt.

Beispiel:

Live
In Progress
Archived

Die Bedeutung wird nicht allein durch Farbe vermittelt.

Text oder Icons werden zusammen verwendet.


13. Technologie-Tags

Technologie-Tags sind Hilfselemente, um Informationen schnell zu erfassen.

Regenbogenfarben werden nicht pro Technologie angewendet.

Standardmäßig wird ein neutraler Stil verwendet.

Beispiel:

Next.js
TypeScript
Python
FastAPI
Supabase
SQLite
AI Agent

Technologie-Tags sollten nicht auffälliger sein als die Projektbeschreibung.


14. Projektdetailseite

Beim Klick auf eine Projektkarte kann die folgende Struktur verwendet werden:

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

Nicht jedes Projekt muss alle Abschnitte enthalten.

Es werden nur die Informationen angezeigt, die im tatsächlichen Projekt vorhanden sind.


15. Featured Projects

Auf der Startseite werden nicht alle Projekte mit demselben Gewicht angezeigt.

Hauptprojekte werden basierend auf dem featured-Status ausgewählt.

Beispiel:

featured: true

Die UI zeigt Projekte basierend auf dem featured-Wert an.

Daher sollte es nicht notwendig sein, den Komponentencode zu ändern, um ein Projekt aus den Featured-Projekten zu entfernen.


16. Weitere Projekte

Unter den Featured-Projekten kann ein Bereich bereitgestellt werden, in dem andere Projekte eingesehen werden können.

Zweck:

Es geht nicht darum, das Portfolio kleiner aussehen zu lassen, sondern zu zeigen, wie vielfältig der Entwickler Probleme gelöst hat.

Die visuelle Hierarchie zwischen Featured-Projekten und normalen Projekten wird beibehalten.


17. Approach-Bereich

Anstelle eines allgemeinen „Über mich“-Bereichs wird zuerst ein Bereich in Betracht gezogen, der die Entwicklungsweise zeigt.

Beispiel:

01 Problem
02 Discovery
03 Learning
04 Building
05 Result

Die Kernbotschaft lautet:

Probleme erkennen → recherchieren → notwendige Technologien lernen → selbst bauen → Ergebnisse prüfen.

Es wird priorisiert, den tatsächlichen Entwicklungsprozess und die Denkweise zu zeigen, anstatt eine einfache Selbstvorstellung.


18. Skills

Skills zeigen nicht nur eine Liste von Technologien, sondern den tatsächlichen Verwendungskontext.

Empfohlene Kategorisierung:

Frontend
Backend
AI / Automation
Database
Tools

Beispiel:

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

Technologien, mit denen keine tatsächliche Erfahrung besteht, werden nicht hinzugefügt.


19. Skill-Darstellung

Technologiekenntnisse werden nicht mit willkürlichen Zahlen oder Sternen dargestellt.

Verboten:

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

Stattdessen werden die Technologien mit tatsächlichen Projekten und Verwendungszwecken verknüpft.

Beispiel:

Python
→ Verwendet in AI Agent / Automation / Backend Projekten

20. Kontakt

Der Kontaktbereich ist einfach und klar aufgebaut.

Empfohlen:

Short Message
Email
GitHub
LinkedIn oder andere echte Links

Es werden keine nicht existierenden Kontaktdaten oder Links erstellt.


21. Footer

Der Footer ist minimal gehalten.

Beispiel:

© 2026 Jeonghyeon Yun
Built with Next.js

Es werden keine überflüssigen Informationen hinzugefügt.


22. Responsive Design

Die folgenden Umgebungen werden unbedingt berücksichtigt:

Desktop
Tablet
Mobile

Responsive Design wird nicht einfach durch Verkleinern des Bildschirms implementiert.

Insbesondere auf Mobilgeräten werden folgende Anpassungen vorgenommen:

  • Änderung der Navigationsstruktur
  • Anpassung der Hero-Typografie
  • Grid → 1 Spalte
  • Anpassung der Button-Größe
  • Reduzierung von Padding
  • Überprüfung des Zeilenumbruchs bei langen Texten
  • Priorisierung der Informationen in Projektkarten

23. Barrierefreiheit (Accessibility)

Eine grundlegende Barrierefreiheit wird unbedingt berücksichtigt.

  • Angemessene Heading-Hierarchie
  • Ausreichender Farbkontrast
  • Tastaturfokus
  • Klare Buttons / Links
  • Alt-Text für Bilder
  • Empfohlene Touch-Ziele von mindestens 44px
  • Keine rein farbliche Unterscheidung von Zuständen
  • Sicherstellung der Informationsvermittlung auch ohne Animationen

24. Animationen

Animationen werden nur verwendet, wenn sie die Funktion unterstützen.

Empfohlen:

150ms ~ 300ms
ease-out

Mögliche Bereiche:

  • Button Hover
  • Link Hover
  • Card Hover
  • Navigation
  • Kurze Section Reveals

Nicht verwendet werden:

  • Parallax
  • Übermäßige Scroll-Animationen
  • Dauerhafte Bewegungen
  • Sinnlose Dekorationsanimationen
  • Übermäßige Inszenierung beim Seitenaufruf

25. Dark Mode

In der ersten Version wird vorrangig der Light Mode verwendet.

Dark Mode wird nur hinzugefügt, wenn eine separate Anforderung besteht.

Dark Mode sollte nicht dazu führen, dass das aktuelle Designsystem oder die Komponentenstruktur unnötig komplex wird.


26. Technische Designregeln

Tailwind CSS wird als grundlegendes Stylesystem verwendet.

CSS-Variablen werden zur Verwaltung globaler Design-Tokens verwendet.

Empfohlen:

Tailwind
+
CSS Variables

Unnötige Inline-Stile werden nicht verwendet.


27. Komponentenregeln

React Server Component wird als Standard verwendet.

Ein Client Component wird nur in folgenden Fällen verwendet:

  • Benutzereingaben
  • Zustandsverwaltung
  • Browser-APIs
  • Ereignisbasierte Interaktionen
  • Animationsbibliotheken oder andere Client-seitige Ausführungen

Es werden nicht unnötigerweise ganze Seiten zu Client Components gemacht.


28. Trennung von Inhalt / UI

Inhalte und UI werden getrennt.

Empfohlene Struktur:

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

Projektinformationen werden nicht direkt in UI-Komponenten geschrieben.

Beim Hinzufügen oder Ändern von Projekten sollte nach Möglichkeit nur die Datei:

content/projects.ts

geändert werden müssen, damit die Änderungen im UI erscheinen.


29. Projektdatenprinzip

Projektdaten werden in einer strukturierten Form verwaltet.

Beispiel:

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

Es werden nur die benötigten Werte verwendet.

Nicht existierende Informationen werden nicht willkürlich ausgefüllt.


30. Bildregeln

Wenn keine tatsächlichen Projektbilder existieren, werden keine willkürlichen Bilder erstellt oder importiert.

Wenn ein Platzhalter benötigt wird, wird dieser klar als solcher gekennzeichnet.

Die Struktur wird so gestaltet, dass echte Projektscreenshots später als Projektbilder eingefügt werden können.


31. Datenintegrität

Dies ist eines der wichtigsten Prinzipien des Portfolios.

Folgendes wird niemals willkürlich erstellt:

  • Nicht existierende Projekte
  • Nicht existierende Technologieerfahrungen
  • Nicht existierende Erfolge
  • Nicht existierende Zahlen
  • Nicht existierende Kunden
  • Nicht existierende Berufserfahrungen
  • Nicht existierende Links
  • Nicht existierende Zertifikate/Qualifikationen
  • Nicht existierende Projektergebnisse

Wenn Informationen fehlen, wird priorisiert:

Leer lassen

oder

Beim Benutzer nachfragen

32. Erhaltung bestehender Projekte

Die Bedeutung bestehender Projekte wird nicht willkürlich geändert.

Es wird auf der Grundlage der vom Benutzer bereitgestellten Projektbeschreibungen oder Anforderungen gearbeitet.

Wenn eine Löschung oder Reduzierung bestehender Funktionen erforderlich ist, wird zuerst der Grund erläutert und eine Bestätigung eingeholt.


33. Portfolio-Informationsarchitektur

Die grundlegende Startseitenstruktur priorisiert Folgendes:

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

Diese kann jedoch je nach tatsächlichem Inhalt und Benutzerfreundlichkeit angepasst werden.


34. Priorität von Designentscheidungen

Bei Designkonflikten wird die folgende Prioritätsreihenfolge angewendet:

1. Content readability (Lesbarkeit des Inhalts)
2. Information hierarchy (Informationshierarchie)
3. Accessibility (Barrierefreiheit)
4. Responsive usability (reaktionsfähige Benutzerfreundlichkeit)
5. Consistency (Konsistenz)
6. Visual aesthetics (Visuelle Ästhetik)
7. Decorative effects (Dekorative Effekte)

Ein Design, das leicht zu lesen und zu verstehen ist, wird einem hübschen Design vorgezogen.


35. Implementierungsworkflow

Beim Erstellen einer neuen Seite oder UI wird die folgende Reihenfolge eingehalten:

SCHRITT 1. Analysieren

Zunächst werden die aktuelle Projektstruktur und die vorhandene UI überprüft.

SCHRITT 2. Planen

Die erforderliche Informationsstruktur und Bildschirmkomposition werden vorgeschlagen.

SCHRITT 3. Designen

Basierend auf den Designprinzipien dieser SKILL.md wird eine visuelle Richtung vorgeschlagen.

SCHRITT 4. Komponente

Die erforderliche Komponentenstruktur wird vorgeschlagen.

SCHRITT 5. Bestätigen

Bei größeren Strukturänderungen oder neuen Funktionen wird vor der Implementierung die Bestätigung des Benutzers eingeholt.

SCHRITT 6. Implementieren

Es wird nur der bestätigte Umfang implementiert.

SCHRITT 7. Überprüfen

Folgendes wird überprüft:

TypeScript
Build
Responsive
Accessibility
Visual consistency
Existing functionality

36. Änderungsmanagement

Bei kleinen Änderungen wird die bestehende Struktur so weit wie möglich beibehalten.

Vor einer größeren Änderung:

  1. Aktuelle Struktur prüfen
  2. Grund für die Änderung erläutern
  3. Auswirkungsbereich prüfen
  4. Alternativen vorschlagen
  5. Benutzerzustimmung einholen
  6. Implementieren

Diese Reihenfolge wird eingehalten.


37. Abhängigkeiten

Neue Bibliotheken werden nur hinzugefügt, wenn die Notwendigkeit eindeutig ist.

Wenn das Problem mit vorhandenen Funktionen von Next.js / React / TypeScript / Tailwind gelöst werden kann, wird keine neue Bibliothek hinzugefügt.

Wenn eine Bibliothek hinzugefügt werden muss, wird zuerst geprüft:

Warum wird sie benötigt?
Was löst sie?
Gibt es Alternativen?

38. Supabase / Backend-Prinzip

Die erste Version des Portfolios basiert auf statischen Inhalten.

content/*.ts

wird vorrangig verwendet.

Backend-Lösungen wie Supabase werden nur hinzugefügt, wenn die folgenden Anforderungen tatsächlich bestehen:

  • Admin-Panel
  • Projekt-CRUD
  • Blog
  • Entwicklungsnotizen
  • Kontaktformular-Speicherung
  • Authentifizierung
  • Dynamische Datenverwaltung

Eine Datenbank wird nicht in einem Stadium eingeführt, in dem kein Backend benötigt wird.


39. Git-Workflow

Nach Abschluss einer sinnvollen Arbeitseinheit wird ein Commit durchgeführt.

Grundlegender Ablauf:

git add .
git commit -m "Arbeitsinhalt"
git push

Das Format Conventional Commit wird für Commit-Nachrichten empfohlen.

Beispiel:

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

Arbeitseinheiten werden nicht übermäßig groß gebündelt.


40. Abschließender Qualitätsstandard

Der fertige Bildschirm sollte die folgenden Fragen mit „Ja“ beantworten können:

  • Ist die Identität des Entwicklers auf dem ersten Bildschirm erkennbar?
  • Werden Projekte als Kerninhalte dargestellt?
  • Ist verständlich, was jedes Projekt gelöst hat?
  • Werden tatsächliche Ergebnisse und Prozesse stärker betont als eine Liste von Technologien?
  • Ist das Portfolio auch auf Mobilgeräten gut lesbar?
  • Sind Inhalte und UI getrennt?
  • Können neue Projekte einfach hinzugefügt werden?
  • Sind keine nicht existierenden Informationen enthalten?
  • Vermittelt das Portfolio ohne übermäßige Designeffekte einen professionellen Eindruck?
  • Wurden keine bestehenden Funktionen unnötig gelöscht?

41. Nicht verhandelbare Regeln

Die folgenden Prinzipien werden stets eingehalten:

  1. Dekoration geht nicht vor Inhalt.
  2. Projekte sind der Kern des Portfolios.
  3. Keine Inhalte erfinden, die nicht auf tatsächlicher Erfahrung basieren.
  4. Keine Erfolge oder Zahlen hinzufügen, die nicht vom Benutzer bereitgestellt wurden.
  5. Inhalte und UI trennen.
  6. Responsive Design als Standard betrachten.
  7. Barrierefreiheit (Accessibility) berücksichtigen.
  8. Keine unnötigen Bibliotheken hinzufügen.
  9. Bestehende Funktionen nicht willkürlich löschen.
  10. Große strukturelle Änderungen vor der Implementierung mit dem Benutzer abstimmen.
  11. Das Design bleibt in der Richtung Professional / Modern / Minimal / Technical.
  12. Light Mode als primären Standard in der ersten Version beibehalten.
  13. Das System so gestalten, dass beim Hinzufügen von Projekten kein UI-Code geändert werden muss.
  14. Alle Designentscheidungen priorisieren Lesbarkeit und Informationsvermittlung.

Verwandte Skills