Communitygithub.com

ShaysFrame/my

Persönliches Portfolio und Markensystem für Shay (ShaysFrame). Nutze diesen Skill beim Erstellen, Designen oder Verbessern von Shays persönlicher Portfolio-Website, Blog, Projektseiten, Lebenslauf-Seite oder selbstbewerbenden Webinhalten.

Was ist my?

Dieser Skill definiert das vollständige Marken- und Aufbausystem für das persönliche Portfolio von M. Mahafuj Rahman (Shay). Er enthält detaillierte Designrichtlinien, die eine redaktionelle, kontrastreiche und typografiegeführte Ästhetik vorgeben – ähnlich einem Magazin-Cover, nicht einer SaaS-Landingpage. Der Skill spezifiziert eine monochrome Farbpalette, empfohlene Schriftarten (z. B. Playfair Display für Helden, Inter für Fließtexte) und eine mehrschichtige Bewegungsphilosophie, bei der Animationen entweder durch CSS, natives Scrollen oder ein einzelnes „Wow“-Element im Heldenbereich umgesetzt werden. Er unterstützt die Entwicklung mit dem Astro-Framework und TypeScript, setzt auf CSS Custom Properties für das Styling und Deployment auf Vercel. Darüber hinaus enthält er eine klare Seitenstruktur, eine priorisierte Liste von Projekten (angefangen bei Qifa bis LittleLemon), Richtlinien für eine direkte und flufffreie Schreibweise sowie Komponentenrichtlinien für mobile-first, semantisches HTML und CSS-Animationen. Vermieden werden sollen generische Heldentexte, farbige Akzente, überladene Layouts und leeres Aufzählen von Technologien.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ShaysFrame/my/tree/HEAD/tools/portfolio-skill

In Ihrer bevorzugten KI fragen

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

Dokumentation

M. MAHAFUJ RAHMANS Portfolio – Marken- & Aufbausystem

Du baust das persönliche Portfolio von M. Mahafuj Rahman, einem Full-Stack-Entwickler mit einer breiten Palette an veröffentlichten Projekten in den Bereichen Mobile, Web, Backend, IoT und ML. Das Portfolio muss Tiefe, Bandbreite und Handwerkskunst vermitteln – nicht nur Technologien auflisten.


Identität

Name: M. MAHAFUJ RAHMAN (online bekannt als Shay) GitHub: ShaysFrame Website: shay.pub
Tech-Identität: Full-Stack-Generalist – Flutter, Vue, Astro, React, Django, PHP, Docker, YOLO/CV
Karriereziel: Eine Position bei einem erstklassigen Technologieunternehmen ergattern, indem ich echte, veröffentlichte Arbeiten demonstriere


Design-Philosophie

Ästhetik: Redaktionell. Hochkontrast. Typografiegeführt. Zieht sofort die Aufmerksamkeit auf sich.
Stimmung: Sauber und elegant – wie ein Magazin-Cover, nicht wie eine SaaS-Landingpage.
Leitprinzip: Jedes Element erregt entweder Aufmerksamkeit oder wird entfernt.

Farbpalette

--color-bg:        #0a0a0a   /* fast-schwarzer Hintergrund */
--color-surface:   #111111   /* Karten, Panels */
--color-border:    #222222   /* dezente Trennlinien */
--color-text:      #f5f5f5   /* Primärtext – gebrochenes Weiß, nicht grelles Reinweiß */
--color-muted:     #777777   /* Sekundär-/Metadaten-Text */
--color-accent:    #ffffff   /* reines Weiß – sparsam eingesetzt für maximalen Kontrast */
--color-highlight: #e8e8e8   /* Hover-Zustände, ausgewählte Elemente */

Keine Farbakzente. Keine Verläufe. Schwarz, Weiß und Kontrast leisten die ganze Arbeit.

Typografie

  • Anzeige / Hero: Eine einzelne, kräftige Serifen- oder kontrastreiche Grotesk-Display-Schriftart. Vorschläge: Playfair Display, Editorial New, PP Neue Montreal, Instrument Serif
  • Fließtext / UI: Saubere geometrische Sans-Serif. Inter, DM Sans oder Geist
  • Code: JetBrains Mono oder Geist Mono
  • Regel: Weniger Schriftgewichte, dafür bewusstere Größen. Verwende Maßstab, nicht Farbe, um Hierarchie zu schaffen.

Bewegung & Interaktion

Philosophie: Bewegung sollte sich unvermeidlich anfühlen, nicht dekorativ. Jede Animation beantwortet die Frage „Warum bewegt sich das?“ – um Aufmerksamkeit zu lenken, Zustand zu signalisieren oder Scrollen zu belohnen.

Ebene 1 – CSS (immer, ohne Abhängigkeiten)

  • Seitenübergänge: Verwende Astros eingebaute <ViewTransitions /> – ohne JS-Kosten
  • Hover-Zustände: Deckkraftverschiebungen, Unterstreichungs-Enthüllungen, subtile Skalierung (1.0 → 1.02)
  • Fokus-Zustände: sichtbarer Ring mit --color-accent
  • Eingang: CSS @keyframes fadeUp für Inhalte oberhalb der Falz

Ebene 2 – Scrollgesteuerte Animation (CSS-first)

  • Verwende natives CSS animation-timeline: scroll(), wo die Browserunterstützung es erlaubt
  • Fallback: IntersectionObserver in einer kleinen .ts-Utility – keine Bibliothek nötig
  • Projektkarten: gestaffeltes fade + translateY(24px → 0), wenn sie in den Viewport gelangen
  • Abschnittsüberschriften: beim Scrollen von links hereingleiten

Ebene 3 – Hero-„Wow“-Element (eines, und nur eines)

  • Der Hero erhält EINEN charakteristischen Bewegungseffekt. Optionen in der Reihenfolge der Präferenz:
    1. Gestaffelte Buchstaben-/Wort-Enthüllung – Der Hero-Name wird Zeichen für Zeichen animiert (nur CSS)
    2. Rauschen-/Kornüberlagerung – animierte CSS-Korn-Textur über dem dunklen Hintergrund (nur CSS)
    3. Subtile 3D-Neigung – Projektkarten neigen sich leicht bei Mausbewegung (Vanilla JS, ~15 Zeilen)
    4. Three.js / React Three Fiber – nur wenn ein spezifisches 3D-Asset benötigt wird (z. B. ein sich drehendes geometrisches Logo). Verwende die Skills 3D-Animation-Creator oder 3D-Website-Asset-Generator, um das Asset separat zu generieren, und bette es dann als einzelne isolierte Komponente ein.

Was niemals getan werden sollte

  • Ganzseitige Three.js-Hintergründe (schlechte Performance, lenkt vom Inhalt ab)
  • Wiederholte Animationen außerhalb des Hero-Bereichs
  • Hüpfende Feder-Physik (falscher Ton für redaktionelle Ästhetik)
  • Parallax-Scrolling auf Text
  • Bewegung nur, weil ein Tutorial sie verwendet hat

Seitenstruktur

/                  → Hero + Teaser zu ausgewählten Projekten + kurze Einleitung
/about             → Wer Shay ist, Hintergrund, Philosophie, Fähigkeiten-Übersicht
/projects          → Raster aller Projekte mit Stack-Tags und Kurzbeschreibungen
/projects/[slug]   → Detailansicht einzelner Projekte (Problem, Lösung, Stack, Links, Screenshots)
/resume            → Inline-Lebenslauf-Ansicht + Link zum herunterladbaren PDF
/blog              → Liste der Blogbeiträge (existiert bereits in Astro)
/blog/[slug]       → Einzelbeitrag (existiert bereits)

Technologie-Stack

  • Framework: Astro (SSG, Markdown-first, standardmäßig null JS, exzellentes SEO)
  • Komponentensprache: Astro-Komponenten + React/Preact (.tsx) für interaktive Inseln
  • Sprache: TypeScript überall – .ts, .tsx, .astro mit typisiertem Frontmatter. Niemals .js oder .jsx
  • Styling: CSS-Custom-Properties (kein Tailwind, es sei denn, der Benutzer fordert es explizit an)
  • Deployment: Vercel
  • Inhalte: Astro Content Collections für Blogbeiträge und Projekte

Priorisierung der Projektvorstellung

Beim Erstellen von Projektseiten priorisiere diese Projekte in dieser Reihenfolge (die beeindruckendsten zuerst):

  1. Qifa – Multi-App-Ökosystem (Client, Shop, Büro, Docker, benutzerdefiniertes Logging-Dashboard, ChatWoot)
  2. Open RTMS – Echtzeitsystem mit YOLO v8n-Gesichtserkennung (ML-Winkel ist selten und beeindruckend)
  3. XueHanYu – Full-Stack (Vue + Django), chinesische Sprachlernplattform
  4. NoorConnect – App + Backend + Firmware (IoT/Eingebettet ist selten für Webentwickler)
  5. Jidian Daojia – Flutter + PHP + uniapp, plattformübergreifend
  6. LittleLemon – Meta Professional Certificate Abschlussprojekt (zertifizierte Arbeit)

Strukturiere den Inhalt jeder Projektseite wie folgt:

  1. Einzeiliger Aufhänger (welches Problem es löst, nicht welche Technologie es verwendet)
  2. Stack-Badges
  3. Die Herausforderung / was es interessant gemacht hat
  4. Wichtige Entscheidungen, die getroffen wurden
  5. Links (GitHub, Live-Demo, falls verfügbar)

Schreibstil

  • Direkt. Selbstbewusst. Kein Füllmaterial.
  • Erste Person, wo angebracht („Ich habe gebaut…“, „Ich habe mich für… entschieden, weil…“)
  • Vermeide: „leidenschaftlich interessiert an“, „selbstmotiviert“, „ergebnisorientiert“, „Synergien genutzt“
  • Technische Details > vage Behauptungen. Sage „Ich habe eine Echtzeit-Gesichtserkennungspipeline mit YOLO v8n gebaut“, nicht „Ich habe an Computer-Vision-Projekten gearbeitet“

Komponentenrichtlinien

Beim Generieren von Astro-Komponenten für dieses Portfolio:

  • Standard-Export-Stil: .astro-Dateien mit ----Frontmatter
  • Verwende CSS-Custom-Properties aus der obigen Palette
  • Mobile-First responsives Design
  • Semantisches HTML (richtige Verwendung von <article>, <section>, <nav>, <main>)
  • Keine Inline-Stile außer für dynamische Werte
  • Animationen via CSS – Keyframes in global.css oder in <style>-Blöcken mit Scope
  • Interaktive Inseln: Verwende die Direktive client:visible, sodass JS nur bei Bedarf geladen wird

Was zu vermeiden ist

  • Generischer Hero-Text wie „Hallo, ich bin ein Entwickler, der es liebt zu coden“
  • Lila Verläufe, alles abgerundet, blaue CTA-Buttons
  • Überladene Layouts – nutze weißen (oder schwarzen) Raum
  • Auflisten jeder Technologie, mit der du gearbeitet hast, ohne Kontext
  • Texte, die sich wie ein Lebenslauf lesen; dies ist eine Erzählung, keine Liste

Verwandte Skills