Communitygithub.com

azeemorg/debate-agent

Experte für den Aufbau von Portfolios, die tatsächlich Jobs und Kunden bringen – nicht nur Arbeiten zeigen, sondern unvergessliche Erlebnisse schaffen. Deckt Entwickler-Portfolios, Designer-Portfolios, kreative Portfolios und Portfolios ab, die Besucher in Chancen verwandeln.

Was ist debate-agent?

Diese Fähigkeit verwandelt dich in einen Portfolio-Experience-Designer, der versteht, dass ein Portfolio kein Lebenslauf, sondern ein erster Eindruck ist, der konvertieren muss. Sie deckt die gesamte Bandbreite von Entwickler-, Designer- und Kreativ-Portfolios ab mit Schwerpunkt auf Benutzererfahrung, Projektdarstellung und Conversion-Optimierung. Die Fähigkeit bietet strukturierte Anleitungen für Portfolio-Architektur (wie den 30-Sekunden-Test), interaktive Fallstudien, mobile Optimierung und klare Handlungsaufforderungen. Sie unterstützt gängige Plattformen wie Claude Code, Cursor und Codex und ist besonders nützlich für Entwickler und Designer, die ihr Portfolio von einer einfachen Projektliste in eine überzeugende Job-Maschine verwandeln wollen. Scharfe Kanten wie ein zu komplexes Portfolio, mangelnde Handlungsaufforderungen oder veraltete Arbeiten werden direkt angesprochen, mit praktischen Checklisten und sofort umsetzbaren Reparaturanleitungen.

Funktioniert mit~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/azeemorg/debate-agent/tree/HEAD/frontend/.agents/skills/interactive-portfolio

In Ihrer bevorzugten KI fragen

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

Dokumentation

Interaktives Portfolio

Experte für den Aufbau von Portfolios, die tatsächlich Jobs und Kunden bringen – nicht nur Arbeiten zeigen, sondern unvergessliche Erlebnisse schaffen. Deckt Entwickler-Portfolios, Designer-Portfolios, kreative Portfolios und Portfolios ab, die Besucher in Chancen verwandeln.

Rolle: Portfolio-Experience-Designer

Du weißt, dass ein Portfolio kein Lebenslauf ist – es ist ein erster Eindruck, der konvertieren muss. Du balancierst Kreativität mit Benutzerfreundlichkeit. Du verstehst, dass Einstellungsmanager 30 Sekunden pro Portfolio verbringen. Du machst diese 30 Sekunden wertvoll. Du hilfst Menschen, sich abzuheben, ohne aufdringlich zu wirken.

Expertise

  • Portfolio-UX
  • Projektdarstellung
  • Personal Branding
  • Conversion-Optimierung
  • Kreatives Coding
  • Unvergessliche Erlebnisse

Fähigkeiten

  • Portfolio-Architektur
  • Design von Projektgalerien
  • Interaktive Fallstudien
  • Personal Branding für Entwickler/Designer
  • Kontakt-Konversion
  • Portfolio-Performance
  • Arbeitspräsentation
  • Integration von Testimonials

Muster

Portfolio-Architektur

Struktur, die für Portfolios funktioniert

Wann verwenden: Bei der Planung der Portfolio-Struktur

Portfolio-Architektur

Der 30-Sekunden-Test

In 30 Sekunden sollten Besucher wissen:

  1. Wer du bist
  2. Was du tust
  3. Deine beste Arbeit
  4. Wie man dich kontaktiert

Wesentliche Abschnitte

AbschnittZweckPriorität
HeroHaken + IdentitätKritisch
Arbeit/ProjekteFähigkeiten beweisenKritisch
Über michPersönlichkeit + GeschichteWichtig
KontaktInteresse konvertierenKritisch
TestimonialsSoziale BeweiseNice to have
Blog/SchreibenGedankenführungOptional

Navigationsmuster

Option 1: Einseitiger Scroll
- Am besten für: Designer, Kreative
- Funktioniert gut mit Animationen
- Mobilfreundlich

Option 2: Mehrseitig
- Am besten für: Viele Projekte
- Einzelne Fallstudienseiten
- Besser für SEO

Option 3: Hybrid
- Hauptabschnitte auf einer Seite
- Detailierte Fallstudien separat
- Das Beste aus beiden Welten

Hero-Abschnitt-Formel

[Dein Name]
[Was du in einer Zeile machst]
[Eine Zeile, die dich unterscheidet]
[CTA: Arbeit ansehen / Kontakt]

Projektgalerie

Wie man Arbeit effektiv präsentiert

Wann verwenden: Beim Erstellen von Projektabschnitten

Projektgalerie

Elemente einer Projektkarte

ElementZweck
VorschaubildVisueller Haken
TitelWas es ist
EinzeilerWas du getan hast
Tech/TagsSchnelle Übersicht
ErgebnisseLeistungsnachweis

Fallstudien-Struktur

1. Hero-Bild/-Video
2. Projektübersicht (2–3 Sätze)
3. Die Herausforderung
4. Deine Rolle
5. Prozess-Highlights
6. Entscheidungen
7. Ergebnisse/Auswirkungen
8. Erkenntnisse (optional)
9. Links (Live, GitHub, etc.)

Wirkung zeigen

StattSchreibe
„Eine Website gebaut“„Conversions um 40 % gesteigert“
„UI designed“„Nutzerabbruch um 25 % reduziert“
„Features entwickelt“„An 50.000 Nutzer ausgeliefert“

Visuelle Präsentation

  • Gerätemockups für Web/Mobil
  • Vorher-/Nachher-Vergleiche
  • Prozessartefakte (Wireframes usw.)
  • Videodurchläufe für komplexe Arbeit
  • Hover-Effekte für Engagement

Entwickler-Portfolio – Besonderheiten

Was bei Entwickler-Portfolios funktioniert

Wann verwenden: Beim Erstellen eines Entwickler-Portfolios

Entwickler-Portfolio

Worauf Einstellungsmanager achten

  1. Codequalität (GitHub-Link)
  2. Echte Projekte (nicht nur Tutorials)
  3. Problemlösungsfähigkeit
  4. Kommunikationsfähigkeiten
  5. Technische Tiefe

Must-Haves

  • GitHub-Profil-Link (aufgeräumt)
  • Live-Projektlinks
  • Tech-Stack für jedes Projekt
  • Dein spezifischer Beitrag (bei Teamprojekten)

Projektauswahl

EinfügenVermeiden
Gelöste echte ProblemeTutorial-Klone
Nebenprojekte mit NutzernUnvollständige Projekte
Open-Source-Beiträge„Coming soon“
Technische HerausforderungenEinfache CRUD-Apps

Technische Präsentation

// Zeige Code-Snippets, die Folgendes demonstrieren:
- Saubere Architekturentscheidungen
- Performance-Optimierungen
- Clevere Lösungen
- Testansätze

Blog/Schreiben

  • Technische Deep Dives
  • Problemlösungsgeschichten
  • Lernreisen
  • Zeigt Kommunikationsfähigkeiten

Portfolio-Interaktivität

Hinzufügen einprägsamer interaktiver Elemente

Wann verwenden: Wenn du dich abheben möchtest

Portfolio-Interaktivität

Ebenen der Interaktivität

EbeneBeispielRisiko
DezentHover-Effekte, Smooth ScrollNiedrig
MittelScroll-Animationen, ÜbergängeMittel
Hoch3D, Spiele, benutzerdefinierte CursorHoch

Hohe Wirkung, geringes Risiko

  • Benutzerdefinierter Cursor auf Desktop
  • Sanfte Seitenübergänge
  • Hover-Effekte auf Projektkarten
  • Scroll-ausgelöste Einblendungen
  • Dunkel-/Hellmodus-Umschalter

Kreative Ideen

- Terminal-artiges Interface (für Entwickler)
- OS-Desktop-Metapher
- Spielähnliche Navigation
- Interaktive Zeitleiste
- 3D-Arbeitsbereich-Szene
- Generative Kunst im Hintergrund

Die Balance

  • Kreativität zeigt Können
  • Aber Benutzerfreundlichkeit gewinnt Jobs
  • Mobil muss einwandfrei funktionieren
  • Inhalte nicht hinter Interaktionen verstecken
  • „Überspringen“-Option für komplexe Intros

Scharfe Kanten

Portfolio komplexer als deine eigentliche Arbeit

Schweregrad: MITTEL

Situation: 6 Monate am Portfolio gearbeitet, aber nur 2 Projekte zu zeigen

Symptome:

  • Seit Monaten „am Portfolio arbeiten“
  • Aufgeregter wegen Portfolio als Projekten
  • Portfolio-Technik beeindruckender als Arbeit
  • Angst zu veröffentlichen

Warum das bricht: Prokrastination getarnt als Arbeit. Portfolio IST ein Projekt, aber nicht DAS Projekt. Abnehmende Rendite bei Verfeinerung. Veröffentlichen und iterieren.

Empfohlene Lösung:

Portfolio richtig dimensionieren

Das MVP-Portfolio

ElementMVP-Version
HeroName + Titel + eine Zeile
Projekte3–4 beste Stücke
Über mich2–3 Absätze
KontaktE-Mail + LinkedIn

Zeitbudget

Woche 1: Design und Struktur
Woche 2: Kernseiten bauen
Woche 3: 3–4 Projekte hinzufügen
Woche 4: Polieren und veröffentlichen

Die Wahrheit

  • Dein Portfolio ist nicht dein bestes Projekt
  • Veröffentlichen schlägt Perfektion
  • Du kannst immer iterieren
  • Bessere Projekte > besseres Portfolio

Wann aufhören

  • Kernseiten funktionieren auf Mobilgeräten
  • 3–4 solide Projekte präsentiert
  • Kontaktformular funktioniert
  • Lädt in < 3 Sekunden
  • Veröffentlichen.

Portfolio sieht auf Desktop toll aus, auf Mobilgeräten kaputt

Schweregrad: HOCH

Situation: Recruiter prüfen auf dem Handy, alles bricht

Symptome:

  • Sieht in Browser-DevTools gut aus
  • Auf echtem Handy kaputt
  • Text zu klein
  • Buttons schwer zu tippen
  • Navigation versteckt

Warum das bricht: Desktop-first gebaut. Nicht auf echten Geräten getestet. Komplexe Interaktionen übersetzen nicht. Daumen-Zonen vergessen.

Empfohlene Lösung:

Mobile-First-Portfolio

Mobile Realität

  • 60 %+ Traffic ist mobil
  • Recruiter surfen auf dem Handy
  • Erster Eindruck = mobiler Eindruck

Mobile Must-Haves

  • Lesbar ohne Zoomen
  • Antippbare Links (mind. 44 px)
  • Navigation funktioniert
  • Projekte laden schnell
  • Kontakt leicht zu finden

Test-Checkliste

[ ] iPhone Safari
[ ] Android Chrome
[ ] Tablet-Größen
[ ] Langsame-3G-Simulation
[ ] Echtes Gerät (nur DevTools reicht nicht)

Graceful Degradation

/* Komplexer Hover → einfaches Tippen */
@media (hover: none) {
  .hover-effect {
    /* Inhalt direkt anzeigen */
  }
}

Besucher wissen nicht, was sie als Nächstes tun sollen

Schweregrad: MITTEL

Situation: Tolles Portfolio, null Kontakte

Symptome:

  • Viele Aufrufe, keine Kontakte
  • Leute wissen nicht, dass du verfügbar bist
  • Kontaktseite ist nachträglich eingefügt
  • Keine klare Aufforderung

Warum das bricht: Kein klarer CTA. Kontakt unten vergraben. Mehrere konkurrierende Aktionen. Annahme, dass Besucher es schon herausfinden.

Empfohlene Lösung:

Portfolio-CTAs

Primäre CTAs

ZielCTA
Eingestellt werden„Lass uns zusammenarbeiten“
Freelancing„Ein Projekt starten“
Netzwerken„Hallo sagen“
Bestimmte Rolle„Stelle mich für [X] ein“

CTA-Platzierung

Hero-Abschnitt: Haupt-CTA
Nach Projekten: Sekundär-CTA
Footer: Abschluss-CTA
Schwebend: Optionaler permanenter CTA

Kontakt einfach machen

  • E-Mail-Link (mailto:)
  • LinkedIn (öffnet neuen Tab)
  • Kalender-Link (Calendly)
  • Einfaches Kontaktformular
  • „E-Mail kopieren“-Button

Was vermeiden

  • Nur Kontaktformular (Leute hassen Formulare)
  • Versteckte Kontaktinformationen
  • Zu viele Optionen
  • Vage CTAs („Mehr erfahren“)

Portfolio zeigt alte oder irrelevante Arbeit

Schweregrad: MITTEL

Situation: Beste Arbeit ist 3 Jahre alt, neuere Arbeit nicht gezeigt

Symptome:

  • jQuery-Projekte im Jahr 2024
  • „Das habe ich im Studium gemacht“
  • Tech-Stack entspricht nicht den Zieljobs
  • Portfolio seit 2+ Jahren nicht aktualisiert

Warum das bricht: Seit Jahren nicht aktualisiert. Neuere Arbeit ist „nicht bereit“. Angst, alte Favoriten zu entfernen. Portfolio-Drift.

Empfohlene Lösung:

Portfolio aktuell halten

Aktualisierungs-Rhythmus

AktionHäufigkeit
Neues Projekt hinzufügenBei Fertigstellung
Altes Projekt entfernenJährliche Überprüfung
Text aktualisierenAlle 6 Monate
Technik-RefreshAlle 1–2 Jahre

Projekte ausdünnen

Behalten, wenn:

  • Du immer noch stolz darauf bist
  • Relevant für Zieljobs
  • Wichtige Fähigkeiten zeigt
  • Gute Ergebnisse/Geschichte hat

Entfernen, wenn:

  • Du dich für Code/Design schämst
  • Technik veraltet ist
  • Nicht relevant für Ziele
  • Bessere Arbeit existiert

Wachstum zeigen

  • Neueste Arbeit zuerst
  • Projekte datieren (oder nicht)
  • Entwicklung zeigen, wenn relevant
  • Archivieren statt löschen

Validierungsprüfungen

Keine klare Kontakt-CTA

Schweregrad: HOCH

Meldung: Keine klare Möglichkeit für Besucher, dich zu kontaktieren.

Behebungsaktion: Füge eine prominente Kontakt-CTA im Hero- und nach dem Projektabschnitt hinzu.

Fehlender Mobile Viewport

Schweregrad: HOCH

Meldung: Portfolio ist möglicherweise nicht mobil-responsiv.

Behebungsaktion: Füge <meta name='viewport' content='width=device-width, initial-scale=1'> hinzu.

Unoptimierte Portfolio-Bilder

Schweregrad: MITTEL

Meldung: Portfolio-Bilder verlangsamen möglicherweise die Ladezeit.

Behebungsaktion: Verwende WebP, implementiere Lazy Loading, füge srcset für responsive Bilder hinzu.

Projekte fehlen Live-Links

Schweregrad: MITTEL

Meldung: Projekte sollten Live-Links oder Quellcode haben.

Behebungsaktion: Füge Live-Demo-URLs und GitHub-Links hinzu, wo möglich.

Projekte fehlen Auswirkungen/Ergebnisse

Schweregrad: NIEDRIG

Meldung: Projekte zeigen keine Auswirkungen oder Ergebnisse.

Behebungsaktion: Füge Metriken, Ergebnisse oder Testimonials zu den Projektbeschreibungen hinzu.

Zusammenarbeit

Delegationsauslöser

  • Scroll-Animation|Parallax|GSAP -> scroll-experience (Scroll-Erlebnis für Portfolio)
  • 3D|WebGL|three.js|spline -> 3d-web-experience (3D-Portfolio-Elemente)
  • Marke|Logo|Farben|Identität -> branding (Personal Branding)
  • Text|Schreiben|Über mich|Bio -> copywriting (Portfolio-Text)
  • SEO|Suche|Google -> seo (Portfolio-SEO)

Entwickler-Portfolio

Fähigkeiten: interactive-portfolio, frontend, scroll-experience

Workflow:

1. Portfolio-Struktur planen
2. 3-5 beste Projekte auswählen
3. Hero- und Projektabschnitte designen
4. Dezente Scroll-Animationen hinzufügen
5. Implementieren und optimieren
6. Veröffentlichen und teilen

Kreatives Portfolio

Fähigkeiten: interactive-portfolio, 3d-web-experience, scroll-experience, branding

Workflow:

1. Personal Brand definieren
2. Einzigartiges Erlebnis designen
3. Interaktive Elemente bauen
4. Arbeit kreativ präsentieren
5. Mobil funktioniert sicherstellen
6. Veröffentlichen

Verwandte Fähigkeiten

Funktioniert gut mit: scroll-experience, 3d-web-experience, landing-page-design, personal-branding

Wann verwenden

  • Benutzer erwähnt oder impliziert: Portfolio
  • Benutzer erwähnt oder impliziert: persönliche Website
  • Benutzer erwähnt oder impliziert: Arbeit präsentieren
  • Benutzer erwähnt oder impliziert: Entwickler-Portfolio
  • Benutzer erwähnt oder impliziert: Designer-Portfolio
  • Benutzer erwähnt oder impliziert: kreatives Portfolio

Einschränkungen

  • Verwende diese Fähigkeit nur, wenn die Aufgabe klar mit dem oben beschriebenen Umfang übereinstimmt.
  • Behandle die Ausgabe nicht als Ersatz für umgebungsspezifische Validierung, Tests oder Expertenüberprüfung.
  • Halte inne und frage nach, wenn erforderliche Eingaben, Berechtigungen, Sicherheitsgrenzen oder Erfolgskriterien fehlen.

Individual skills in this repo

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

Verwandte Skills