Communitygithub.com

infinyte/portfolio-showcase-generator

Verwandeln Sie technische Projekte in überzeugende Portfolio-Stücke mit Executive Summaries, technischen Tiefenbohrungen, Architekturdiagrammen, Impact-Metriken und demofertigen GitHub-Pages. Analysiert GitHub-Repos und Projektbeschreibungen, um zielgruppenspezifische Präsentationsmaterialien zu erstellen.

Was ist portfolio-showcase-generator?

Dieses Skill transformiert technische Projekte in professionelle Portfolio-Artefakte, die auf unterschiedliche Zielgruppen zugeschnitten sind – von Recruitern über Architekten bis hin zu technischen Führungskräften. Es unterstützt mehrere Eingabeformate (GitHub-Repos, Notizen, technische Spezifikationen, Gesprächsnotizen) und generiert Executive Summaries, technische Deep-Dives, Architekturdiagramme (Mermaid), Impact-Metriken, STAR-Interviewgeschichten und komplette GitHub-Pages-Websites. Der Workflow umfasst die Analyse der Codebasis (Entwicklungsumgebungen wie .NET, Node.js, Python) und die Extraktion von Metriken, Architekturmustern und Geschäftskontext. Die Ausgaben sind für Personalverantwortliche, Architekten und technische Teams optimiert – mit wählbarem Detaillierungsgrad und Jargon. Besonders hervorzuheben ist die Anpassungsfähigkeit des Skills: Es kann von einem einfachen GitHub-Link bis zu einer detaillierten Projektbeschreibung in natürlicher Sprache alles verarbeiten und liefert sofort einsatzbereite Inhalte für Bewerbungen, Portfolio-Seiten oder Vorbereitungsmaterialien für Vorstellungsgespräche. Die Qualitätssicherung umfasst eine Checkliste, die sicherstellt, dass alle Metriken quantifiziert, technische Begriffe erklärt und Diagramme verständlich sind.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add infinyte/portfolio-showcase-generator

In Ihrer bevorzugten KI fragen

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

Dokumentation

Portfolio Showcase Generator

Ein umfassendes Skill zur Umwandlung technischer Projekte in professionelle Portfolio-Stücke, optimiert für verschiedene Zielgruppen (Personalverantwortliche, Einstellungsmanager, Architekten, technische Leiter).

Kernfunktionen

  1. Code-Analyse – Analyse der GitHub-Repository-Struktur, des Tech-Stacks, der Architekturmuster
  2. Zielgruppenanpassung – Generierung von Inhalten für Führungskräfte, Architekten und technische Teams
  3. Architekturvisualisierung – Erstellung von System-, Datenfluss- und Bereitstellungsdiagrammen
  4. Impact-Quantifizierung – Extraktion und Präsentation von Geschäftskennzahlen und technischen Errungenschaften
  5. Multi-Format-Ausgabe – Executive Summaries, technische Tiefenbohrungen, Interview-Geschichten, GitHub-Pages

Wann dieses Skill verwenden

Verwenden Sie dieses Skill, wenn der Benutzer Folgendes möchte:

  • Ein technisches Projekt in Portfolio-Materialien umwandeln
  • Überzeugende Fallstudien aus seiner Arbeit erstellen
  • Vorbereitungsmaterialien für Vorstellungsgespräche generieren (STAR-Format-Geschichten)
  • Eine professionelle GitHub-Pages-Showcase-Seite aufbauen
  • Geschäftsauswirkungen aus technischen Errungenschaften extrahieren
  • Zielgruppenspezifische Projektzusammenfassungen erstellen

Eingabeformate

Das Skill akzeptiert mehrere Eingabeformate:

1. GitHub-Repository

  • Repository-URL oder lokaler Pfad
  • Analysiert: Dateistruktur, Code-Muster, Tech-Stack, Abhängigkeiten, Dokumentation
  • Extrahiert: Architekturmuster (DDD, Microservices usw.), Frameworks, Cloud-Dienste

2. Projektkontext (beliebige Kombination)

  • Rohe Notizen/Aufzählungen – Kurze Erfassungen von Errungenschaften und Details
  • Technische Spezifikationen – Architekturdokumente, Design-Dokumente
  • Gesprächsform – Der Benutzer beschreibt das Projekt natürlich
  • Vorhandene Dokumentation – README-Dateien, Wikis, ADRs

3. Geschäftskontext

  • Projektziele und -vorgaben
  • Gelöste Probleme
  • Stakeholder und Benutzer
  • Zeitplan und Teamgröße
  • Einschränkungen und Herausforderungen

Ausgabegenerierung

1. Executive Summary (für Einstellungsmanager/Personalverantwortliche)

Zweck: Kurzer, wirkungsvoller Überblick mit Fokus auf Geschäftswert und Ergebnisse.

Struktur:

  • Projektübersicht (2-3 Sätze): Was es ist, warum es wichtig ist
  • Wichtigste Errungenschaften (3-5 Aufzählungspunkte): Quantifizierte Geschäftsauswirkung
  • Technische Highlights (kurz): Bemerkenswerte Technologien/Ansätze
  • Zeitplan & Umfang: Dauer, Teamgröße, Rolle
  • Impact-Metriken: Leistungssteigerungen, Kosteneinsparungen, Nutzerkennzahlen

Ton: Professionell, selbstbewusst, ergebnisorientiert. Jargon minimieren. Mit Ergebnissen beginnen.

Länge: 150-250 Wörter (30-60 Sekunden Lesedauer)

2. Technische Tiefenbohrung (für Architekten/Technische Leiter)

Zweck: Architektonisches Denken, technische Tiefe und technisches Urteilsvermögen demonstrieren.

Struktur:

  • Kontext & Einschränkungen: Anforderungen, Einschränkungen, bestehende Systeme
  • Architekturentscheidungen: Wichtige Design-Entscheidungen mit Begründung
  • Technische Implementierung:
    • Systemarchitektur
    • Tech-Stack und warum
    • Angewandte Muster (DDD, CQRS, Event Sourcing usw.)
    • Integrationspunkte
  • Herausforderungen & Lösungen: Technische Probleme und wie Sie sie gelöst haben
  • Skalierung & Leistung: Metriken, Optimierungsstrategien
  • Sicherheit & Qualität: Tests, Beobachtbarkeit, Sicherheitsmaßnahmen
  • Kompromisse: Wofür optimiert wurde, was geopfert wurde, warum

Ton: Technisch, aber zugänglich. Begründungen erklären, nicht nur Entscheidungen nennen. Urteilsvermögen zeigen.

Länge: 800-1500 Wörter (4-6 Minuten Lesedauer)

3. Architekturdiagramme (Mermaid)

Generieren Sie relevante Diagramme basierend auf dem Projekttyp:

Systemarchitektur-Diagramm:

graph TB
    Client[Clientanwendung]
    API[API-Gateway]
    Service1[Dienstname]
    Service2[Dienstname]
    DB[(Datenbank)]
    Cache[(Cache)]
    
    Client --> API
    API --> Service1
    API --> Service2
    Service1 --> DB
    Service1 --> Cache

Datenflussdiagramm:

flowchart LR
    Source[Datenquelle] --> Ingestion[Erfassungsebene]
    Ingestion --> Processing[Verarbeitung]
    Processing --> Storage[(Speicher)]
    Storage --> API[API-Ebene]
    API --> Consumer[Verbraucher]

Bereitstellungsdiagramm:

graph TB
    subgraph Azure
        subgraph VNet
            AppService[App Service]
            Function[Azure Functions]
        end
        DB[(SQL-Datenbank)]
        Storage[(Blob-Speicher)]
    end
    
    AppService --> DB
    Function --> Storage

Richtlinien:

  • Verwenden Sie den passenden Diagrammtyp für den Inhalt
  • Halten Sie Diagramme fokussiert (maximal 5-12 Knoten)
  • Verwenden Sie klare, beschreibende Beschriftungen
  • Fügen Sie ggf. eine Legende für Farben/Formen hinzu
  • Generieren Sie bei komplexen Projekten mehrere Diagramme

4. Metriken & Impact-Analyse

Extrahieren und präsentieren Sie quantifizierbare Errungenschaften:

Technische Metriken:

  • Leistungsverbesserungen (Antwortzeit, Durchsatz usw.)
  • Skalierbarkeitserfolge (unterstützte Benutzer, Transaktionen/Sekunde)
  • Codequalität (Testabdeckung, Fehlerreduzierung)
  • Zuverlässigkeit (Verfügbarkeit, MTTR, Fehlerraten)
  • Sicherheitsverbesserungen (behobene Schwachstellen, Compliance)

Geschäftsmetriken:

  • Kosteneinsparungen (Infrastruktur, Entwicklungszeit)
  • Umsatzauswirkungen (neue Fähigkeiten, Markterweiterung)
  • Effizienzgewinne (Automatisierung, reduzierte manuelle Arbeit)
  • Benutzerzufriedenheit (NPS, Akzeptanzraten)
  • Time-to-Market (Liefergeschwindigkeit, Release-Häufigkeit)

Format: Präsentieren Sie konkrete Zahlen mit Kontext:

  • „API-Antwortzeit um 60 % reduziert (450 ms → 180 ms)“
  • „Cloud-Kosten durch Ressourcenoptimierung um 24.000 $/Jahr gesenkt“
  • „10-fache Skalierung von 1.000 auf 10.000 gleichzeitige Benutzer ermöglicht“

5. Vorbereitung auf Vorstellungsgespräche (STAR-Format)

Generieren Sie 2-4 überzeugende Geschichten im STAR-Format:

Struktur:

  • Situation: Kontext, Problem, Einschränkungen (2-3 Sätze)
  • Aufgabe: Ihre spezifische Verantwortung (1-2 Sätze)
  • Handlung: Was Sie getan haben, technische Entscheidungen, Implementierung (3-5 Sätze)
  • Ergebnis: Ergebnisse, Metriken, Auswirkungen (2-3 Sätze)

Länge: Jede Geschichte sollte bei mündlicher Präsentation 90-120 Sekunden dauern

Fokus: Unterschiedliche Geschichten sollten hervorheben:

  • Technische Problemlösung
  • Architektonische Entscheidungsfindung
  • Führung/Einflussnahme
  • Umgang mit Einschränkungen/Kompromissen

6. GitHub Pages Site

Generieren Sie eine vollständige statische Seitenstruktur:

Startseite (index.html):

  • Hero-Bereich mit Projektname und Slogan
  • Kurzübersicht (Tech-Stack, Zeitplan, Impact-Metriken)
  • Navigation zu den Abschnitten
  • Screenshot/Demo (falls verfügbar)

Architektur-Seite (architecture.html):

  • Systemübersicht
  • Architekturdiagramme (eingebettetes Mermaid)
  • Tech-Stack-Details
  • Design-Entscheidungen

Impact-Seite (impact.html):

  • Geschäftsergebnisse
  • Technische Errungenschaften
  • Metrikvisualisierung
  • Vorher-Nachher-Vergleiche

Demo-Seite (demo.html – falls zutreffend):

  • Interaktive Demo oder Rundgang
  • Screenshots mit Anmerkungen
  • Nutzungsszenarien
  • Videoeinbettung (falls verfügbar)

Gestaltung:

  • Sauberes, professionelles Design
  • Für Mobilgeräte optimiert
  • Schnell ladend (minimale Abhängigkeiten)
  • Barrierefrei (WCAG-konform)
  • Optional: Verwendung von GitHub’s Primer CSS oder Tailwind CDN

Workflow

Schritt 1: Eingabe sammeln

  1. Nach der Projektquelle fragen:

    • GitHub-Repo-URL/Pfad
    • Vorhandene Dokumentation
    • Projektskizzen
  2. Kontext verstehen:

    • Welches Problem wurde gelöst?
    • Für wen war es?
    • Was war Ihre Rolle?
    • Was machte es herausfordernd?
    • Was waren die Ergebnisse?
  3. Ausgaben klären:

    • Welche Ergebnisse werden benötigt?
    • Gibt es spezifische Anforderungen (Länge, Schwerpunkte)?
    • Details zur Zielgruppe?

Schritt 2: Analyse (falls GitHub-Repo bereitgestellt)

Verwendung von Bash-/View-Tools zur Analyse des Repositorys:

# Repository-Struktur analysieren
find /path/to/repo -type f -name "*.cs" -o -name "*.csproj" | head -20
find /path/to/repo -type f -name "*.yml" -o -name "*.yaml"

# Nach Architekturdokumenten suchen
find /path/to/repo -type f -name "*.md" | grep -i "architecture\|design\|adr"

# Abhängigkeiten analysieren
cat /path/to/repo/*.csproj
cat /path/to/repo/package.json
cat /path/to/repo/requirements.txt

# Nach Konfiguration suchen
find /path/to/repo -name "appsettings*.json" -o -name "*.config"

Extrahieren Sie:

  • Tech-Stack: Sprachen, Frameworks, Datenbanken, Cloud-Dienste
  • Muster: DDD, Microservices, Event-Driven, CQRS usw.
  • Architektur: Monolith, Microservices, Serverless usw.
  • Infrastruktur: Cloud-Anbieter, Bereitstellungsstrategie
  • Qualitätspraktiken: Tests, CI/CD, Monitoring

Schritt 3: Inhalte generieren

Generieren Sie jede angeforderte Ausgabeart gemäß den obigen Strukturen.

Schlüsselprinzipien:

  • Zielgruppenorientiert: Tiefe und Jargon an die Zielgruppe anpassen
  • Evidenzbasiert: Behauptungen nach Möglichkeit mit Code/Dokumenten belegen
  • Quantifizieren: Immer Zahlen und Metriken einbeziehen
  • Geschichtengetrieben: Betonung von Herausforderungen → Lösungen → Auswirkungen
  • Ehrlich: Einschränkungen und Kompromisse anerkennen

Schritt 4: Artefakte erstellen

Für Dokumente (Zusammenfassungen, Tiefenbohrungen):

  • Markdown-Format verwenden
  • Klare Abschnitte mit Überschriften einfügen
  • Code-Snippets (wo relevant) hinzufügen
  • Diagramme einbetten

Für GitHub Pages:

  • Vollständige HTML-Dateien generieren
  • Inline-CSS oder CDN-Referenz einfügen
  • Mobile Reaktionsfähigkeit sicherstellen
  • Meta-Tags für SEO hinzufügen

Für Diagramme:

  • Mermaid Chart Tool zum Rendern verwenden
  • Sowohl Mermaid-Quelle als auch gerendertes Bild bereitstellen
  • Sicherstellen, dass Diagramme selbsterklärend sind

Schritt 5: Ergebnisse paketieren

Organisieren Sie die Ergebnisse nach den Bedürfnissen des Benutzers:

Für Bewerbungen:

  • Executive Summary (kopierfertig)
  • 2-3 STAR-Geschichten
  • Liste der wichtigsten Metriken

Für Portfolio-Seite:

  • Vollständige GitHub Pages-Struktur
  • Alle Assets organisiert
  • Bereitstellungsanweisungen

Für Vorstellungsgespräche:

  • STAR-Geschichten (ausgedruckt/PDF)
  • Architekturdiagramm (als Referenz für Whiteboard-Übungen)
  • Metrik-Spickzettel

Besondere Überlegungen

.NET/Azure-Projekte

  • Hervorheben: DDD-Muster, SOLID-Prinzipien, Async/Await-Muster
  • Betonen: Zero Trust, InfoSec-Compliance, Enterprise-Muster
  • Tech-Stack: .NET-Version, verwendete Azure-Dienste, Designmuster

Machine Learning/Computer Vision-Projekte

  • Fokus: Problemdefinition, Modellauswahl-Begründung, Leistungsmetriken
  • Hervorheben: Trainingsansatz, Datenpipeline, Inferenzoptimierung
  • Metriken: Genauigkeit, Präzision, Recall, F1, Inferenzlatenz

Integrationsprojekte

  • Betonen: API-Design, Fehlerbehandlung, Datenkonsistenz
  • Hervorheben: Drittanbieter-Integrationen, Ratenbegrenzung, Resilienzmuster
  • Metriken: Zuverlässigkeit (Verfügbarkeit), Datengenauigkeit, Durchsatz

Enterprise-/Großprojekte

  • Kontext: Skalierung, Compliance-Anforderungen, Legacy-Einschränkungen
  • Hervorheben: Migrationsstrategien, Rückwärtskompatibilität, Risikominderung
  • Metriken: Skalierungszahlen, Leistung unter Last, Kostenoptimierung

Ausgabeformat

Bei der Generierung mehrerer Ausgaben wie folgt organisieren:

# Portfolio Showcase: [Projektname]

## Kurzübersicht
- **Tech-Stack**: [Liste]
- **Dauer**: [Zeitplan]
- **Rolle**: [Ihre Rolle]
- **Impact**: [Top 1-2 Metriken]

## Generierte Ausgaben

### 1. Executive Summary
[Inhalt]

### 2. Technische Tiefenbohrung
[Inhalt]

### 3. STAR-Geschichten
#### Geschichte 1: [Titel]
[Inhalt]

#### Geschichte 2: [Titel]
[Inhalt]

### 4. Architekturdiagramme
[Diagramme mit Erklärungen]

### 5. Metrik-Dashboard
[Formatierte Metriken]

### 6. GitHub Pages-Dateien
[Dateistruktur und Inhalt]

Qualitäts-Checkliste

Vor der Auslieferung sicherstellen:

  • Alle Metriken sind spezifisch und quantifiziert
  • Technische Begriffe werden für die Zielgruppe erklärt oder begründet
  • Diagramme sind klar und ordnungsgemäß beschriftet
  • STAR-Geschichten sind vollständig (alle 4 Elemente)
  • Executive Summary besteht den „Elevator-Pitch“-Test
  • Technische Tiefenbohrung zeigt architektonisches Denken
  • GitHub Pages sind mobil reaktionsfähig und barrierefrei
  • Keine grammatikalischen Fehler oder Tippfehler
  • Konsistente Terminologie durchgängig
  • Errungenschaften werden als Impact dargestellt, nicht als Aufgaben

Beispiel-Prompts

Einfach: „Erstelle eine Portfolio-Showcase für mein DocFlow-Projekt auf GitHub“

Ausführlich: „Ich habe ein Flugstatus-Dashboard mit .NET 8, DDD und Azure gebaut. Es war die erste App, die in unserer Zero-Test-Umgebung bereitgestellt wurde. Ich brauche eine Executive Summary für Personalverantwortliche und eine technische Tiefenbohrung für das Vorstellungsgespräch, plus Architekturdiagramme.“

Gesprächsform: „Ich möchte mein KI-Dokumentenscanner-Projekt präsentieren. Es verwendet Computer Vision, um Daten aus Whiteboards zu extrahieren, und integriert sich in mehrere Systeme. Können Sie mir helfen, Materialien für meine Portfolio-Seite zu erstellen?“

Tipps für Benutzer

Für die besten Ergebnisse:

  1. Nach Möglichkeit GitHub-Zugriff bereitstellen (reichhaltigste Informationsquelle)
  2. Das „Warum“ hinter dem Projekt teilen (Geschäftskontext ist wichtig)
  3. Alle Metriken einbeziehen, die Sie verfolgt haben (auch informelle)
  4. Herausforderungen erwähnen, die Sie gemeistert haben (diese ergeben großartige Geschichten)
  5. Ihre Zielgruppe angeben (die technische Tiefe variiert stark)
  6. Notieren, worauf Sie stolz waren oder was Sie gelernt haben (authentische Details kommen gut an)

Häufige Fehler, die vermieden werden sollten:

  • Zu bescheiden sein (das Portfolio ist nicht der Ort für Bescheidenheit)
  • Aufgaben statt Errungenschaften auflisten („API gebaut“ vs. „API entworfen, die die Latenz um 40 % reduziert hat“)
  • Jargon ohne Kontext für nicht-technische Zielgruppen verwenden
  • Quantifizierung des Impacts vergessen
  • Es wie einen Teambericht klingen lassen, statt Ihren eigenen Beitrag hervorzuheben

Verwandte Skills