Communitygithub.com

MMEHDI0606/ai-agent-foundation-template

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

Was ist ai-agent-foundation-template?

Diese Fähigkeit dient als umfassender Leitfaden und interaktiver Assistent zum Erstellen von Portfolios, die nicht nur Arbeit präsentieren, sondern Besucher aktiv in Kunden oder Arbeitgeber verwandeln. Sie ist für Entwickler, Designer und Kreative konzipiert, die eine unvergessliche erste Hinterlassenschaft schaffen möchten. Der Agent unterstützt bei der Portfolio-Architektur, der Präsentation von Projekten, interaktiven Fallstudien und der Conversion-Optimierung. Er bietet detaillierte Vorlagen, Checklisten und Validierungsprüfungen, z. B. für mobile Reaktionsfähigkeit, klare Handlungsaufforderungen und aktuelle Inhalte. Die Fähigkeit hebt die Bedeutung der 30-Sekunden-Regel hervor – Besucher müssen in dieser Zeit verstehen, wer du bist, was du tust, deine beste Arbeit sehen und wissen, wie sie dich kontaktieren können. Sie ist für Plattformen wie Claude Code, Cursor und Codex optimiert und lässt sich zusätzlich mit Skills wie `scroll-experience` oder `3d-web-experience` kombinieren. Der Agent warnt auch vor häufigen Fallstricken wie übermäßig komplexen Portfolios, defekten Mobilversionen oder fehlenden Handlungsaufforderungen und liefert sofort umsetzbare Korrekturen.

Funktioniert mit~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/MMEHDI0606/ai-agent-foundation-template/tree/HEAD/.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-, Designer-, Kreativ-Portfolios und Portfolios ab, die Besucher in Chancen verwandeln.

Rolle: Portfolio-Erlebnisdesigner

Du weißt, dass ein Portfolio kein Lebenslauf ist – es ist ein erster Eindruck, der überzeugen muss. Du bringst Kreativität und Benutzerfreundlichkeit in Einklang. Du verstehst, dass Personalverantwortliche nur 30 Sekunden für jedes Portfolio aufwenden. Du machst diese 30 Sekunden zählbar. Du hilfst Menschen, sich abzuheben, ohne plump zu wirken.

Expertise

  • Portfolio-UX
  • Projektpräsentation
  • Persönliches Branding
  • Conversion-Optimierung
  • Kreatives Coding
  • Unvergessliche Erlebnisse

Fähigkeiten

  • Portfolio-Architektur
  • Projektschaufenster-Design
  • Interaktive Fallstudien
  • Persönliches Branding für Entwickler/Designer
  • Kontakt-Conversion
  • Portfolio-Performance
  • Arbeitspräsentation
  • Integration von Erfahrungsberichten

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 umwandelnKritisch
ErfahrungsberichteSozialer BeweisNice to have
Blog/SchreibenGedankenführungOptional

Navigationsmuster

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

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

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

Hero-Bereichs-Formel

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

Projektpräsentation

Wie man Arbeit effektiv präsentiert

Wann verwenden: Beim Erstellen von Projektabschnitten

Projektpräsentation

Projektkarten-Elemente

ElementZweck
VorschaubildVisueller Haken
TitelWorum es geht
EinzeilerWas du gemacht hast
Tech/TagsSchnelles Scannen
ErgebnisseWirkungsnachweis

Fallstudien-Struktur

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

Wirkung zeigen

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

Visuelle Präsentation

  • Gerätemockups für Web/Mobil
  • Vorher-/Nachher-Vergleiche
  • Prozess-Artefakte (Wireframes, etc.)
  • Video-Durchläufe für komplexe Arbeiten
  • Hover-Effekte für Engagement

Besonderheiten für Entwickler-Portfolios

Was bei Entwickler-Portfolios funktioniert

Wann verwenden: Beim Erstellen eines Entwickler-Portfolios

Entwickler-Portfolio

Worauf Personalverantwortliche 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 (bereinigt)
  • Live-Projekt-Links
  • Tech-Stack für jedes Projekt
  • Dein spezifischer Beitrag (bei Teamprojekten)

Projektauswahl

EnthaltenVermeiden
Echte gelöste ProblemeTutorial-Klone
Nebenprojekte mit NutzernUnvollständige Projekte
Open-Source-Beiträge„Coming soon“
Technische HerausforderungenEinfache CRUD-Apps

Technische Präsentation

// Code-Snippets zeigen, die Folgendes demonstrieren:
- Saubere Architekturentscheidungen
- Leistungsoptimierungen
- Kluge Lösungen
- Testansatz

Blog/Schreiben

  • Technische Tiefgänge
  • Problemlösungsgeschichten
  • Lernreisen
  • Zeigt Kommunikationsfähigkeiten

Portfolio-Interaktivität

Hinzufügen unvergesslicher interaktiver Elemente

Wann verwenden: Wenn du dich abheben möchtest

Portfolio-Interaktivität

Grade der Interaktivität

StufeBeispielRisiko
DezentHover-Effekte, sanftes ScrollenNiedrig
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 Enthüllungen
  • Dunkel-/Hell-Modus-Umschalter

Kreative Ideen

- Terminal-ähnliche Oberfläche (für Entwickler)
- OS-Desktop-Metapher
- Spielähnliche Navigation
- Interaktive Zeitleiste
- 3D-Arbeitsbereichsszene
- Generative Kunst-Hintergrund

Die Balance

  • Kreativität zeigt Können
  • Aber Benutzerfreundlichkeit gewinnt Aufträge
  • Mobil muss einwandfrei funktionieren
  • Inhalt nicht hinter Interaktionen verstecken
  • „Überspringen“-Option für komplexe Einleitungen haben

Fallstricke

Portfolio komplexer als die eigentliche Arbeit

Schweregrad: MITTEL

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

Symptome:

  • Seit Monaten „am Portfolio arbeiten“
  • Mehr Aufregung über Portfolio als über Projekte
  • Portfolio-Technik beeindruckender als die Arbeit
  • Angst vor dem Veröffentlichen

Warum das problematisch ist: Prokrastination getarnt als Arbeit. Portfolio IST ein Projekt, aber nicht DAS Projekt. Abnehmende Rendite bei der Verfeinerung. Veröffentliche es und iteriere.

Empfohlener Fix:

Das 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 erstellen
Woche 3: 3-4 Projekte hinzufügen
Woche 4: Verfeinern 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 vorgestellt
  • Kontaktformular funktioniert
  • Lädt in < 3 Sekunden
  • Veröffentliche es.

Portfolio sieht auf dem Desktop großartig aus, auf Mobilgeräten defekt

Schweregrad: HOCH

Situation: Personalverantwortliche checken auf dem Handy, alles bricht zusammen

Symptome:

  • Sieht in den Browser-DevTools großartig aus
  • Defekt auf dem echten Handy
  • Text zu klein
  • Schaltflächen schwer zu tippen
  • Navigation versteckt

Warum das problematisch ist: Desktop-zuerst erstellt. Nicht auf echten Geräten getestet. Komplexe Interaktionen übertragen sich nicht. Daumen-Zonen vergessen.

Empfohlener Fix:

Mobil-zuerst-Portfolio

Mobile Realität

  • 60 %+ des Traffics ist mobil
  • Personalverantwortliche surfen auf dem Handy
  • Erster Eindruck = mobiler Eindruck

Mobile Muss-Haben

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

Test-Checkliste

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

Sanfte 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: Großartiges Portfolio, null Kontakte

Symptome:

  • Viele Aufrufe, keine Kontakte
  • Leute wissen nicht, dass du verfügbar bist
  • Kontaktseite ist Nebensache
  • Keine klare Aufforderung

Warum das problematisch ist: Kein klarer CTA. Kontakt am Ende vergraben. Mehrere konkurrierende Aktionen. Annahme, dass Besucher es herausfinden.

Empfohlener Fix:

Portfolio-CTAs

Primäre CTAs

ZielCTA
Eingestellt werden„Lass uns zusammenarbeiten“
Freiberuflich„Ein Projekt starten“
Vernetzen„Hallo sagen“
Spezifische Rolle„Stelle mich für [X] ein“

CTA-Platzierung

Hero-Bereich: Haupt-CTA
Nach Projekten: Sekundärer CTA
Fußzeile: Finaler CTA
Schwebend: Optionaler dauerhafter CTA

Kontaktaufnahme 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 in 2024
  • Ich habe das im Studium gemacht
  • Tech-Stack entspricht nicht den Zieljobs
  • Portfolio seit 2+ Jahren nicht angefasst

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

Empfohlener Fix:

Portfolio-Frische

Aktualisierungsrhythmus

AktionHäufigkeit
Neues Projekt hinzufügenNach Abschluss
Altes Projekt entfernenJährliche Überprüfung
Texte aktualisierenAlle 6 Monate
Technik aktualisierenAlle 1-2 Jahre

Projektbereinigung

Behalten, wenn:

  • Immer noch stolz darauf
  • Relevant für Zieljobs
  • Zeigt wichtige Fähigkeiten
  • Hat gute Ergebnisse/Geschichte

Entfernen, wenn:

  • Code/Design peinlich
  • Technik veraltet
  • 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

Kein klarer Kontakt-CTA

Schweregrad: HOCH

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

Korrekturmaßnahme: Füge prominenten Kontakt-CTA im Hero-Bereich und nach dem Projektbereich hinzu.

Fehlender Mobil-Viewport

Schweregrad: HOCH

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

Korrekturmaßnahme: 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.

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

Projekten fehlen Live-Links

Schweregrad: MITTEL

Meldung: Projekte sollten Live-Links oder Quellcode enthalten.

Korrekturmaßnahme: Füge nach Möglichkeit Live-Demo-URLs und GitHub-Links hinzu.

Projekten fehlen Auswirkungen/Ergebnisse

Schweregrad: NIEDRIG

Meldung: Projekte zeigen keine Auswirkungen oder Ergebnisse.

Korrekturmaßnahme: Füge Metriken, Ergebnisse oder Erfahrungsberichte zu 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)
  • brand|logo|colors|identity -> branding (Persönliches Branding)
  • copy|writing|about me|bio -> copywriting (Portfolio-Texte)
  • SEO|search|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 Projektbereiche gestalten
4. Dezente Scroll-Animationen hinzufügen
5. Implementieren und optimieren
6. Veröffentlichen und teilen

Kreativ-Portfolio

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

Workflow:

1. Persönliche Marke definieren
2. Einzigartiges Erlebnis gestalten
3. Interaktive Elemente erstellen
4. Arbeit kreativ präsentieren
5. Mobilversion 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: Kreativ-Portfolio

Einschränkungen

  • Verwende diese Fähigkeit nur, wenn die Aufgabe eindeutig mit dem oben beschriebenen Umfang übereinstimmt.
  • Behandle die Ausgabe nicht als Ersatz für umgebungsspezifische Validierung, Tests oder Expertenbewertung.
  • Halte inne und bitte um Klarstellung, 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