Communitygithub.com

Portfolio-Build

Baut eine klare, strukturell optimierte Portfolio-Website für Designer aus einer einzigen Inhaltsdatei und einem von drei erprobten Rastern.

Was ist Portfolio-Build?

Dieser Skill erstellt aus einem `portfolio.json`-File und einem Raster eine statische HTML/CSS-Website ohne Framework. Er fokussiert sich auf die **Struktur** (Raster, Reihenfolge, Sichtbarkeit der Rolle) und überlässt das visuelle Design dem Nutzer. Das Python-Build-Skript generiert die Seite, prüft sie auf häufig übersehene Lücken und gibt eine Audit-Liste aus. Unterstützt werden drei bewährte Layouts: ein fixes Profil neben Vollbreiten-Arbeiten, ein zweispaltiges Raster oder ein langer Case-Study-Block pro Projekt. Der Workflow umfasst Zielbestimmung, Rasterauswahl, Befüllen der Inhaltsdatei, optionaler Look-Compare-Modus, Browser-Check und die strukturierte Übergabe des fertigen Ordners. Der Skill ist ideal für Designer, Art Directors, Illustratoren, Fotografen und alle, die schnell und effizient eine präsentable Portfolio-Seite benötigen.

Funktioniert mit~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/adrituyo/30s/tree/main/skills/portfolio-build

In Ihrer bevorzugten KI fragen

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

Dokumentation

Portfolio Build

Ein Portfolio bekommt beim ersten Besuch etwa 30 Sekunden. Dieser Skill baut eines, das diese Sekunden gut nutzt: Wer du bist und was du machst auf dem ersten Bildschirm, echte Arbeiten daneben, dein Anteil an jedem Projekt benannt und eine klare Möglichkeit, dich zu erreichen.

Er repariert die Struktur und überlässt den Look der Person. Die drei Raster bestimmen, wo Dinge platziert werden und in welcher Reihenfolge. Schriftart, Farbe, Eckenradius und Abstand sind ihre Entscheidung, gesetzt in einem kleinen Block. Zwei mit diesem Skill erstellte Portfolios sollten gleich gelesen werden und komplett unterschiedlich aussehen.

Die Pfade unten beziehen sich auf den Ordner dieses Skills.

So funktioniert es

Eine Datei, portfolio.json, enthält alles: die Person, die Projekte, das gewählte Raster und den Look. Ein Befehl verwandelt sie in eine statische Site (reines HTML und CSS, kein Framework, nichts zu installieren):

python3 scripts/build.py path/to/their-site/portfolio.json

Die Site wird neben der Inhaltsdatei geschrieben. Das Skript gibt dann zwei Listen aus: was ein 30-Sekunden-Audit immer noch anmerken würde, jede Zeile mit einer Regelnummer (references/rules.md enthält die siebzehn in je einer Zeile), und jeden [Slot], der noch auf einen Fakt wartet. Behandle beide als To-do-Liste.

Schritte

1. Herausfinden, wofür das Portfolio ist

Frage oder leite aus dem ab, was du bekommen hast:

  • Das Ziel. Die Rolle oder der Kunde, auf den es abzielt. Es bestimmt die Überschrift, die Reihenfolge und was weggelassen wird.
  • Die Arbeit. Welche Projekte, und für jedes: was es war, ihr Anteil, für wen es war, das Jahr, eine Sache, die sie entschieden haben und was daraus resultierte.
  • Das Material. Wo die Bilder und Videos sind.

Wenn sie eine bestehende Seite haben, lies sie zuerst und übernimm, was da ist. Wenn der Skill portfolio-audit verfügbar ist und sie eine Live-Seite haben, zeigt dir dessen Ausführung genau, was geändert werden muss.

Frage nur nach dem, was du nicht finden kannst. Eine Person mit einem Ordner voller Bilder und einer LinkedIn-Seite hat dir bereits das meiste gegeben. Wenn niemand da ist, um zu antworten, mache mit dem weiter, was du hast, und verwende Slots (Schritt 3).

Material, bei dem die Person unsicher ist (ein Skizzenbuch, ein Studentenprojekt, etwas Altes), bleibt draußen. Sie hatten einen Grund, daran zu zweifeln, und ein Portfolio wird an seiner schwächsten Stelle beurteilt. Drei starke Projekte sind ein vollständiges Portfolio; füge nichts hinzu, um auf vier zu kommen.

2. Die Person das Raster wählen lassen

Lies references/grids.md. Es beschreibt die drei Raster und für wen sie geeignet sind. Das Raster bestimmt, wie die gesamte Seite gelesen wird, also ist es die Entscheidung der Person, nicht deine. Dein Teil ist es, diese Entscheidung einfach zu machen.

Bevor du baust, nenne die drei in einer kurzen Nachricht, eine Zeile pro Raster, sage, welches du für ihre Arbeit und ihr Ziel empfiehlst und warum, und frage, welches sie möchten. Packe es zusammen mit allem, was du sonst noch aus Schritt 1 fragen musst, damit es eine Frage-Runde gibt und nicht zwei.

  • Wenn sie bereits ein Raster genannt haben, verwende es und stelle die Frage nicht erneut.
  • Wenn sie ein anderes als deine Empfehlung wählen, baue ihres. Sage einmal, was es sie kostet, falls es relevant ist (z.B. index hat keinen Platz für eine Entscheidung und ein Ergebnis), und lasse es dann ruhen.
  • Wenn sie unsicher sind oder niemand da ist, um zu antworten, fahre mit deiner Empfehlung fort und baue mit --compare in Schritt 5, sodass alle drei nebeneinander geöffnet werden können.

Wechseln ist später ein Wort in der Datei, also ist niemand festgelegt. Das ist ein Grund, die Auswahl leicht anzubieten, nicht ein Grund, sie zu überspringen.

3. Die Inhaltsdatei schreiben

Kopiere assets/example/portfolio.json als Ausgangspunkt und lies references/content.md für jedes Feld. Lege sie in den Ordner, der die Site werden soll, mit den Bildern daneben. Das Beispiel verwendet das case-Raster; für index und columns sind decision und result optional und Vorher-/Nachher-Zeilen sind selten nötig.

Wie du die wichtigsten Teile schreibst:

  • Überschrift: ein Satz, der sagt, was sie machen und für wen, mit einer Tatsache darin. Sie sollte auf keine andere Seite passen. „Produktdesigner für Fintech-Apps. Acht Jahre, zuletzt Lead für den Sparvorgang bei Ledger.“ Nicht „Multidisziplinärer Kreativer, leidenschaftlich daran interessiert, Erlebnisse zu gestalten.“
  • Nachweis: die drei oder vier stärksten Namen oder Zahlen, direkt nach der Überschrift.
  • Reihenfolge: das Projekt, das am besten zum Ziel passt, kommt zuerst, egal welches Datum es hat. Vier bis acht Projekte. Nebendisziplinen (Film für einen Art Director, Illustration für einen Produktdesigner) sind besser als eine zweite Seite mit eigener Inhaltsdatei als vermischt.
  • Jedes Projekt: eine einzeilige Zusammenfassung, die Rolle und ob es für einen Kunden, einen Arbeitgeber oder ein persönliches Konzept war. Für Produkt- und Führungsziele füge die Entscheidung und das Ergebnis hinzu.
  • Rolle: ihren aktuellen Titel, wie er ist, nicht den, für den sie sich bewerben.
  • Frage: ein Satz über der E-Mail, der sagt, wofür sie schreiben sollen.
  • Sprache: schreibe in der Sprache ihres Publikums und setze site.lang. Die eigenen Wörter der Vorlage (Index, Facts, Next…) folgen dem für Englisch und Spanisch; für jede andere Sprache setze sie in labels.

Verwende nur Fakten, die die Person dir gegeben hat oder die auf ihren bestehenden Seiten stehen. Ein Fakt, den du selbst erschlossen hast, wie der Name eines Kunden aus einem Dateinamen, darf verwendet werden, aber sage der Person, dass er erschlossen wurde, damit sie ihn bestätigen kann.

Wo ein Fakt fehlt, schreibe einen Slot in eckigen Klammern ([Jahr], [Teamgröße], [Was ausgeliefert wurde]). Slots erscheinen auf der Site genau so, wie geschrieben, und der Build listet jeden auf, also:

  • Halte die Überschrift frei von Slots: Schreibe sie aus dem, was du weißt. Ein Slot im ersten Satz ist das Erste, was ein Besucher liest.
  • Wenn ein ganzes Feld unbekannt und optional ist (Stadt, Team, site.url), lasse das Feld stattdessen weg.
  • Für Arbeit ohne Ergebnis sage die wahre Sache: „2024 ausgeliefert; ich habe die Zahlen nicht“, „Konzept, nicht gestartet“. Das ist ein Ergebnis. Ein leeres Versprechen von Wirkung ist keins.
  • Eine Site mit Slots ist ein Entwurf. Sage das bei der Übergabe klar.

Ein Portfolio mit einer ehrlichen Lücke ist in Ordnung. Ein Portfolio mit einem erfundenen Kunden ist ein Problem in einem Vorstellungsgespräch.

4. Den Look festlegen

Im theme-Block: hell oder dunkel, eine Akzentfarbe, die Schriftart, Eckenradius, Abstand zwischen Bildern. Wenn die Person eine Marke oder eine bestehende Site hat, nimm diese daraus. Wenn sie nichts haben, wähle eine Schriftart und einen Akzent, die zu ihrer Arbeit passen, und sage, was du gewählt hast. Kopiere nicht den Look des Beispiels oder einer anderen Designerseite.

Eine Schriftart, die nicht auf jedem Gerät vorhanden ist, benötigt font_url, um sie zu laden; sie nur in font zu nennen, fällt für die meisten Besucher auf die Systemschrift zurück. Gib entweder beides an oder wähle einen Stapel von Systemschriften.

5. Bauen, ansehen, reparieren

Führe den Build aus. Wenn die Person noch kein Raster gewählt hat, füge --compare hinzu:

python3 scripts/build.py path/to/their-site/portfolio.json --compare

Es schreibt denselben Inhalt auch in allen drei Rastern in einen Ordner compare/, mit einer Seite, die sie verlinkt. Zeige der Person diese Seite und lass sie wählen. compare/ ist nur zum Auswählen da: Lösche es vor der Veröffentlichung.

Sieh es dir dann in einem Browser auf Desktop- und Telefonbreite an, wenn möglich: starte python3 -m http.server im Site-Ordner (das case-Raster verlinkt auf Projektordner, die einen Server benötigen) und überprüfe den ersten Bildschirm selbst: Name, was sie tun, Nachweis, eine Möglichkeit, sie zu erreichen, und ein echtes Stück Arbeit, ohne zu scrollen.

Wenn du keinen Browser öffnen kannst, sage das bei der Übergabe und halte zumindest die Überschrift und den Nachweis auf etwa 45 Wörtern zusammen, was auf die erste Bildschirmseite über dem ersten Bild auf einem Telefon passt.

Arbeite die Liste durch, die das Skript ausgegeben hat. Repariere, was du aus dem Inhalt kannst (eine fehlende Rollenzeile, ein schweres Bild, eine lange Überschrift). Gib den Rest der Person als kurze Liste dessen, was nur sie liefern kann.

6. Übergeben

Sage ihnen: welches Raster und ob sie es gewählt haben oder du (und dass die anderen beiden nur ein Wort entfernt sind, oder in compare/, wenn du es gebaut hast), was du für die Überschrift geschrieben hast, was du weggelassen hast, was du erschlossen hast, die noch zu füllenden Slots, was die Audit-Liste noch zeigt, und wie sie Dinge ändern können (portfolio.json bearbeiten, Build erneut ausführen). Der Ordner ist eine vollständige statische Site: Sie kann auf jedem statischen Host veröffentlicht werden, indem sie so hochgeladen wird.

Nur zwei Dinge können nur sie liefern, also frage hier danach: die Adresse, unter der die Site leben wird (site.url), und ein 1200×630 Bild für Linkvorschauen (site.share_image); ein Ausschnitt des besten Bilds des ersten Projekts erfüllt den Zweck.

Bilder

  • Exportiere sie maximal 2000 px breit, als AVIF oder WebP, unter etwa 500 KB pro Stück. Der Build warnt bei schwereren. JPEG, PNG und SVG funktionieren auch.
  • Eine kleinere Kopie für Telefone wird automatisch verwendet, wenn die Dateien als Paar benannt sind: shot-lg.jpg in der Inhaltsdatei und shot-sm.jpg daneben. Ein .avif mit denselben Namen wird Browsern, die es lesen, zuerst angeboten.
  • Gib jedem Bild ein alt, das sagt, was es zeigt. Ohne einen wird der Projekttitel verwendet, was einer Suchmaschine oder einem KI-Assistenten sehr wenig sagt. Wenn du die Bilder nicht gesehen hast, sage, welches Stück jedes ist, und bitte die Person, sie zu beschreiben.
  • Kurze Schleifenvideos (.mp4, .webm) funktionieren als Kacheln. Sie werden stumm abgespielt, nur während sie auf dem Bildschirm sind. Gib ihnen ein ratio.

Was nicht zu tun ist

  • Füge keine Intro-Animation, keinen Ladebildschirm, keinen benutzerdefinierten Cursor und keine Scrolleffekte hinzu, die den Inhalt verzögern. Die Vorlage zeigt den ersten Bildschirm absichtlich sofort an.
  • Verstecke Projekttitel nicht hinter Hover. Telefone haben kein Hover.
  • Entferne nicht die Dock-Leiste, die kleine Leiste mit dem Namen und der E-Mail, die erscheint, sobald der Kontaktblock weg gescrollt wurde. Ein Betrachter entscheidet sich mitten in einem Projekt zu schreiben, nicht am Ende der Seite.
  • Puste dünne Arbeit nicht mit Prozessbildern (Haftnotizen, Personas) auf. Eine Entscheidung, klar gesagt, ist mehr wert.
  • Bearbeite das generierte HTML nicht von Hand: Der nächste Build überschreibt es. Ändere die Inhaltsdatei oder die Vorlage in assets/template/, wenn die Struktur selbst geändert werden muss.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Verwandte Skills