Communitygithub.com

Hasnan42/Showfolio

Verwandle das aktuelle Octacer-Projekt in ein poliertes, mit Octacer gebrandetes Showcase-Video (ca. 40, 60 oder 90 Sekunden) mit Hyperframes. Die echten Bildschirme des Projekts bleiben unverändert; alles drumherum (Intro, Titel, Hintergründe, Outro, animiertes Logo) verwendet das Octacer-Branding. Stellt drei kurze Fragen – Videolänge, welche Funktionen/Seiten gezeigt werden sollen und den Zweck des Projekts in einem Satz – und fragt dann nach Test-Zugangsdaten, wenn die App hinter einem Login steckt. Verwende dies, wenn jemand "/showfolio", "Erstelle ein Showcase-Video", "Erstelle ein Demovideo", "Mach ein Video daraus" sagt oder zeigen möchte, was er gebaut hat. Liest den Projektcode direkt.

Was ist Showfolio?

Showfolio ist ein KI-Agenten-Skill, der aus dem aktuellen Webprojekt oder der App eines Entwicklers automatisch ein hochwertiges, markenkonformes Showcase-Video erstellt. Der Skill wurde für Plattformen wie Claude Code, Cursor und Codex entwickelt und nutzt Hyperframes als Rendering-Engine. Das Besondere: Die echten Screens des Projekts bleiben unverändert, während der gesamte Rahmen – animiertes Logo-Intro, Titel, Hintergründe, Beschriftungen, Ecklogo und Outro – mit dem Octacer-Branding (Schriftarten Space Grotesk, Montserrat, JetBrains Mono und die Farben Ink #040408, White, Lime #A3DC2F) gestaltet wird. Der Skill führt den Benutzer Schritt für Schritt durch einen Workflow: Zuerst werden drei Eingangsfragen gestellt (Videolänge, gewünschte Features/Seiten und der Zweck des Projekts). Anschließend wird der Projektcode analysiert, ein Storyboard mit präzisen Szenen, Timings und Übergängen erstellt, und schließlich wird ein Hyperframes-Kompositionsbrief geschrieben, der das Video rendert. Showfolio unterstützt sieben verschiedene Ton-Voreinstellungen (Standard, Poliert, YC-Parodie, Chaotisch, Totem, Kinematografisch, App-Store) sowie freie kreative Anweisungen, und ermöglicht optionale Sprachausgabe über Kokoro. Das Ergebnis ist ein 40-, 60- oder 90-sekündiges MP4-Video mit einem optimierten Poster-Frame und einem Freigabetext – alles ohne dass der Entwickler selbst Videoschnitt-Kenntnisse benötigt.

Funktioniert mit✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Hasnan42/Showfolio/tree/HEAD/skills/showfolio

In Ihrer bevorzugten KI fragen

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

Dokumentation

/showfolio

Du hast es gebaut. Jetzt zeig es.

Aufruf-Dispatch (muss zuerst passieren)

Modellprüfung. Wenn du Claude Opus 5.5 bist und der Aufruf nicht den vollständigen Workflow (--full, "nutze das vollständige showfolio") oder Sprachausgabe (--voice, was showfolio-slim nicht kann) verlangt, wechsle zu showfolio-slim: Lies <skill-dir>/slim.md (der /showfolio-slim-Skill, hier gebündelt) und folge für den Rest dieses Laufs dieser Datei anstatt dieser. Gib die Benutzereingabe weiter und reiche alle anderen Optionen (--no-music, --title, …) als klare Anweisung in natürlicher Sprache weiter. Informiere den Benutzer zuerst in einem Satz, z.B. „Du bist auf Opus 5.5, daher verwende ich /showfolio-slim: Ich baue das ganze Video selbst. Sag ‚nutze das vollständige showfolio‘, um zurückzuwechseln.“ Wenn du ein anderes Modell bist oder nicht feststellen kannst, welches Modell du bist, überspringe diese Prüfung.

Bevor du das Projekt inspizierst, analysiere den vollständigen /showfolio-Aufruf. Wenn der Aufruf --voice enthält, setze voice.enabled = true. Aktiviere die Erzählung nur für diesen Lauf. Aktiviere die Erzählung nicht automatisch und falle nicht auf den normalen Workflow ohne Sprache zurück.

/showfolio verwandelt die aktuelle Projektwebsite oder -App in ein poliertes, teilbares Showcase-Video mit Hyperframes, präsentiert als ein von Octacer erstelltes Projekt. Es ist schmal, meinungsstark und macht Spaß.

Octacer-Branding ist immer an. Die eigenen Bildschirme des Projekts erscheinen genau so, wie sie sind, und der Rahmen um sie herum (animiertes Logo-Intro, Titel, Hintergründe, Beschriftungen, Ecklogo, Outro) ist Octacer. Regeln und Assets: references/brand.md und <skill-dir>/assets/brand/.

Was dieser Skill tut

  1. Stellt dem Benutzer drei Eingangsfragen (Länge, was gezeigt werden soll, Zweck) und erhält Test-Zugangsdaten, wenn die App einen Login benötigt.
  2. Liest den aktuellen Projektcode, um die App zu verstehen.
  3. Plant ein Showcase-Konzept, das auf dieses Projekt zugeschnitten ist.
  4. Schreibt Drehbuch und Storyboard für das Video innerhalb des Octacer-Markenrahmens.
  5. Übergibt ein fokussiertes Kompositionsbriefing an Hyperframes.
  6. Validiert, rendert und schreibt Freitext.

Analysieren des Aufrufs

Der Benutzer kann den Skill mit natürlicher Sprache oder Flags aufrufen:

/showfolio
/showfolio --duration 60
/showfolio --tone polished --format vertical
/showfolio this. Mach es wie ein hochwertiges Produktvideo.

Analysiere diese Optionen:

OptionWerteStandard
--toneVoreinstellung oder Freiform-Beschreibungabgeleitet
--formatlandscape, vertical, squarelandscape
--durationSekunden (ca. 40, 60 oder 90)in Schritt 0 gefragt
--no-musicFlagMusik an
--no-sfxFlagSoundeffekte an
--titleZeichenfolgeaus Projekt abgeleitet
--voiceFlagErzählung aus

Sprachausgabe ist optional (Opt-in). Wenn --voice vorhanden ist, verwende Kokoro über Hyperframes und füge keine Anbieterauswahllogik hinzu. Der Sprach-Workflow ist bewusst auf einen einzigen Anbieter ausgelegt.

Der Ton kann eine Voreinstellung sein (default, polished, yc-parody, chaotic, deadpan, cinematic, app-store) oder eine kreative Richtung wie „gefälschter Series-A-Launch von 2016", „Museumsausstellung“ oder „überproduzierte Mobile-Game-Werbung“.

Wenn der Benutzer eine freie Tonrichtung angibt, ordne sie für Tempo und Struktur der nächstgelegenen Voreinstellung zu, bewahre aber die Richtung des Benutzers im Plan und im Kompositionsbrief.

Anleitung zur Erzählung

Wenn --voice aktiviert ist, schreibe eine Erzählung, die die visuellen Elemente ergänzt, nicht einfach sichtbaren Text vorliest, zum Szenentempo passt, natürlich und gesprächig klingt und sich fließend zwischen den Szenen bewegt. Halte das Skript prägnant und spezifisch für das Produkt, sodass die Stimme wie ein Teil des Schnitts wirkt und nicht wie eine separate Erzählspur.


Ausgabeverzeichnis

Standardmäßig geht die Ausgabe nach showfolio-output/. Um Überschreiben früherer Läufe zu vermeiden, verwende ein Verzeichnis mit Zeitstempel:

showfolio-output-2026-05-04-143022/

Verwende einen Zeitstempel, wenn:

  • Der Benutzer explizit einen neuen Lauf ohne Überschreiben früherer Ergebnisse verlangt
  • Ein showfolio-output/-Verzeichnis im Projekt bereits existiert

Generiere den Zeitstempel zu Beginn des Laufs (JJJJ-MM-TT-HHmmss) und verwende ihn konsistent für alle Ausgabepfade in diesem Lauf: Plan, Briefing, Komposition, Render und Freigabetext.

Skill-Verzeichnis

<skill-dir> ist das Verzeichnis, das diese SKILL.md enthält. Claude Code gibt es als „Basisverzeichnis für diesen Skill“ aus, wenn der Skill geladen wird; für andere Agenten ist es dort, wo der Skill installiert wurde. Gebündelte Assets befinden sich unter <skill-dir>/assets/ und Skripte unter <skill-dir>/scripts/. Rate keinen Installationspfad: Eine Plugin-Installation, eine Kopie in ~/.claude/skills/ und dieses Repository legen es jeweils an einem anderen Ort ab.


Schritt 0: Aufnahme

Lies: references/step-0-intake.md

Stelle dem Benutzer die drei Aufnahmefragen (Videolänge, Funktionen/Seiten, die gezeigt werden sollen, Zweck in einem Satz) in einer einzigen Nachricht und warte auf die Antworten. Führe dann die Login-Prüfung durch: Wenn die zu zeigenden Teile hinter einem Login liegen, verwende die vom Benutzer angegebenen Zugangsdaten, andernfalls suche nach Test-Zugangsdaten im Repository, andernfalls frage den Benutzer danach.

Tor: Du hast eine Ziellänge, eine Muss-zeigen-Liste (mit der Lieblingsfunktion des Benutzers markiert) und einen Zweck in einem Satz. Wenn die App einen Login benötigt, hast du funktionierende Test-Zugangsdaten oder der Benutzer hat gesagt, dass du ohne sie weitermachen sollst.


Schritt 1: Projekt inspizieren

Lies: references/step-1-inspect.md

Durchsuche das Projektverzeichnis und extrahiere die Informationen, die zur Planung des Videos benötigt werden. Achte besonders auf die Funktionen und Seiten, die der Benutzer in Schritt 0 ausgewählt hat.

Tor: Du kannst alle 9 Fragen des Planungsrasters beantworten.


Schritt 2: Planen und Storyboard

Lies: references/step-2-plan.md Lies: references/brand.md

Schreibe <output-dir>/showfolio-plan.md (wobei <output-dir> showfolio-output/ oder die oben gewählte Variante mit Zeitstempel ist). Beantworte das Planungsraster. Lege einen kreativen Winkel fest. Schreibe das Schlag-für-Schlag-Storyboard mit Szenen, Text, Timing, Übergängen und SFX-Hinweisen.

Wenn Musik ausgewählt ist, füge einen kompakten Abschnitt „Musik-Cue-Anleitung“ hinzu: Lies die Cue-Voreinstellung des gebündelten Tracks aus <skill-dir>/assets/music/cues/, falls vorhanden, ansonsten weise darauf hin, dass Cues zur Kompositionszeit erkannt werden (jeder Track unterstützt jetzt Beat-Sync – siehe references/audio.md). Cue-Metadaten sind nur optionale Timing-Hinweise: Geschichte, Lesbarkeit, Tempo und Produktklarheit bleiben primär.

Tor: <output-dir>/showfolio-plan.md existiert mit einem vollständigen Storyboard. Jedes Muss-zeigen-Element aus Schritt 0 hat eine Szene. Die Szenendauern summieren sich auf die Zieldauer aus Schritt 0, innerhalb von ±10 %.


Schritt 3: Übergabe an Hyperframes

Lies: Die Hyperframes-Domain-Skills – hyperframes-core, hyperframes-animation, hyperframes-creative, hyperframes-keyframes, hyperframes-cli. /showfolio ist sein eigener Workflow: Tritt nicht in das Einstiegs-Intent-Interview von hyperframes ein oder navigiere in seinen generischen Promo-/Launch-Video-Workflow. Lies: references/step-3-compose.md Lies: references/audio.md Lies: references/brand.md

Kopiere <skill-dir>/assets/brand/ in die Assets der Komposition. Schreibe das Kompositionsbriefing und verwende Hyperframes, um die Videoimplementierung in <output-dir>/composition/ zu erstellen.

/showfolio besitzt den Produktwinkel, das Quellmaterial, das Storyboard, den Ton, das Format, die Audioauswahl, die Musik-Cue-Anleitung und die Liefererwartungen. Hyperframes besitzt die konkrete Kompositionsstruktur, das genaue Animations-Timing, die Animationsmechanik, die Laufzeitentscheidungen, die Linting-Regeln und den Render-Workflow.

Tor: npx hyperframes check besteht mit null Fehlern innerhalb von <output-dir>/composition/ (das einzige Browser-Tor vor dem Rendern – siehe hyperframes-cli für das, was es prüft).


Schritt 4: Validieren, rendern und ausliefern

Lies: references/step-4-deliver.md

Validiere, zeige eine Vorschau an, rendere nach <output-dir>/showfolio.mp4, wähle das beste Poster-Frame aus und speichere es als <output-dir>/showfolio.jpg, backe dieses Poster als Frame 0 des Videos, damit es überall das ruhende Thumbnail ist, und schreibe <output-dir>/share-copy.txt.

Tor: <output-dir>/showfolio.mp4 existiert. Ein bestes Poster-Frame <output-dir>/showfolio.jpg ist ausgewählt (kein beliebiges Frame) und als Frame 0 von showfolio.mp4 eingebacken. Freigabetext ist geschrieben. Keine Zugangsdaten erscheinen in einer Ausgabedatei oder einem Frame.


Tonsystem

Sieben Ton-Voreinstellungen werden mit /showfolio ausgeliefert. Jede ändert die Energie des Skripts, das Tempo, die Typografie-Persönlichkeit und den Übergangsstil. Voreinstellungen sind Standardwerte, keine Grenzen.

Vollständige Definitionen: references/tones.md

TonEnergieEinzeiler
defaultVerspielt, sauber, postbarDie gute-Laune-Voreinstellung
polishedErnst, elegantFür Projekte, die keine Witze sind
yc-parodyTote-Startup-EnergieVorgetäuschte Ernsthaftigkeit auf absurde Projekte angewendet
chaoticSchnell, laut, aggressivÜbertrieben und aus dem Ruder gelaufen
deadpanRuhig, trocken, dezentDer Witz ist, dass nichts ein Witz ist
cinematicDramatisch, im TrailermaßstabGroße Bewegung, größere Behauptungen
app-storeGlatt, funktionskarten-sauberCorporate, aber nicht langweilig

Erlaube immer eine freie kreative Richtung, um die Voreinstellung zu verfeinern oder zu überschreiben.


Kreative Gesetze

Diese gelten für jedes Showfolio-Video, unabhängig vom Ton.

Octacer-Rahmen, echtes Produkt. Die Bildschirme des Produkts bleiben genau so, wie sie sind. Alles drumherum verwendet die Octacer-Marke (Ink #040408, White, Lime #A3DC2F als Signal; Space Grotesk, Montserrat, JetBrains Mono; das Logo-SVG, niemals getippt). Öffne mit dem animierten Octacer-Logo, schließe mit „Erstellt von Octacer“. Siehe references/brand.md.

Die Länge, die der Benutzer wollte. Erreiche das Ziel von Schritt 0 (ca. 40, 60 oder 90 Sekunden) innerhalb von ±10 %. Fülle es mit dem Produkt, nicht mit Füllmaterial: mehr Funktionen und längere Arbeitsmomente der App, niemals längeres Halten auf nichts. Dies gilt unabhängig davon, ob die Erzählung eingeschaltet ist; die Erzählung verlängert das Fenster nicht.

Zeige, was sie wollten. Jede Seite oder Funktion, die der Benutzer in Schritt 0 genannt hat, bekommt eine eigene Szene. Diejenige, die er als seine Lieblingsfunktion markiert hat, bekommt die meiste Bildschirmzeit und die stärkste Platzierung.

Lebendig und schnell. 60fps, flotte 0,5–0,8s Kamerafahrten, keine langsamen Drifts, alle 2–3s etwas Neues, der Cursor klickt in den meisten Produktszenen, und Echtzeit-Tippen in jedem Chat oder Eingabefeld. Vollständige Zahlen: „Bewegungs- und Temporegeln“ in references/step-2-plan.md.

Lesbar. Halte das Tempo durch Bewegung und Schnitte hoch, niemals durch aufblitzenden Text. Jede Zeile, die ein Betrachter lesen muss, bleibt lange genug sichtbar, um gelesen zu werden (kurze Beschriftung ~0,8s ruhig; ein Satz ~0,3s pro Wort). Schnell rein, dann halten – niemals schnell rein, dann weg.

Spezifisch. Das Video muss sich anfühlen, als wäre es für genau dieses Projekt gemacht, nicht für irgendein Projekt. Der Ein-Satz-Zweck des Benutzers ist das Rückgrat der Geschichte.

Zeige das Ding. Die meisten Szenen zeigen tatsächliche UI, Text oder ein Schlüsselbild aus dem Produkt. Keine abstrakten Füller.

Keine generische SaaS-Sprache. „Optimieren Sie Ihren Workflow“ ist verboten. Verwende die tatsächlichen Texte und Behauptungen des Projekts.

Der Haken ist alles. Die ersten 2 Sekunden entscheiden, ob jemand weiterschaut. Plane den Haken vor allem anderen.

Lustig verdient seinen Platz. Humor sollte aus der Absurdität des Projekts kommen, nicht aus dem Versuch, lustig zu sein.

Muster:

Octacer-Sting (1,5-2,5s) → Haken (3-5s) → Zweck/Enthüllung (4-8s) → ein Segment pro Muss-zeigen-Feature (6-15s jedes; das Lieblingsfeature bekommt das längste) → Outro mit Octacer-Logo (3-5s)

Passe dies an. Gestalte die Feature-Segmente so, dass die Gesamtzeit auf das Ziel trifft. Das Muster ist eine Ausgangsform, keine Vorlage.

Individual skills in this repo

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

Verwandte Skills