Communitygithub.com

ARYAN2302/liquid_researcher

Generiert eine einseitige, chinesische Atelier-Portfolio-Website (horizontale Zeilenliste + Hover-Enthüllungs-Thumbnail-Interaktion, künstlerische LiShu-Typografie „Alimama DaoLiTi“ per CDN, Hell/Dunkel-Design, Hash-Routing für Detailseiten). Nimmt eine natürliche Beschreibung des Studios und erzeugt eine funktionierende .html-Datei.

Was ist liquid_researcher?

Dieses Skill erstellt eine vollständige, eigenständige Portfolio-Website im Stil eines chinesischen Ateliers, die in einer einzigen HTML-Datei geliefert wird. Es eignet sich besonders für handwerkliche oder künstlerische Projekte wie Buchbinderei, Kalligrafie, Keramik oder Tee, bei denen eine zurückhaltende, elegante Ästhetik gewünscht ist. Die Website nutzt eine horizontale Textzeilen-Liste, die beim Überfahren mit der Maus ein großes Thumbnail auf der rechten Seite einblendet, kombiniert mit der kunstvollen Schriftart „Alimama DaoLiTi“ per CDN. Sie unterstützt sowohl Hell- als auch Dunkelmodi, Hash-Routing für Detailseiten mit vollständigen Projektbeschreibungen, Bildergalerien und Credits. Das Skill arbeitet in zwei Modi: In Claude Code (mit Dateisystemzugriff) schreibt es die Datei auf den Desktop und kann lokale Bilder integrieren; in Online-Chats (GLM etc.) gibt es den HTML-Code inline aus, nutzt Platzhalterbilder und vermeidet Dateisystemoperationen. Es wird durch natürliche Phrasen auf Chinesisch ausgelöst, z. B. „做个中式工作室作品集“ oder „做个隶书作品集“.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ARYAN2302/liquid_researcher/tree/HEAD/skills/design/design-templates/portfolio-detail

In Ihrer bevorzugten KI fragen

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

Dokumentation

portfolio-detail — Chinesisches Atelier / LiShu-Portfolio (mit sekundärer Detailseite)

Kurzbeschreibung

Horizontale Textzeilen + Hover zeigt großes Bild auf der rechten Seite + „Alimama DaoLiTi“-Kunstschrift + Schwarz-Weiß + Hell/Dunkel + Hash-Routing für Detailseiten + Listen-/Kachelansicht.

Unterschiede zu anderen Portfolio-Skills

SkillKernmodusGeeignet für
portfolio-genUnendlich verschiebbare Leinwand + KachelnFotografen / Grafikdesigner für Muster
portfolio-museum-genHero-Karussell + große Karten + Wasserfall-Layout + Detailseiten (Kuratorgefühl)Video-/Film-/Installationskünstler
industrial-archive-genSchwarzer Rahmen als Cover + Seitenleisten-Archiv + skandinavisch-industriellPhysische Produkte / Gegenstände / Hardware
lishu-portfolio-genHorizontale Textzeilen + Hover zeigt Thumbnail auf der rechten Seite + große LiShu-Schrift + chinesische ZurückhaltungBuchgestaltung / Schrift / Ausstellungen / Stillleben / Chinesische Kräuter / Tee / Keramik / Holz / Papier / Duft

Wenn das Projekt des Nutzers Themen wie „Buch / Schrift / Ausstellung / Stillleben / Chinesische Kräuter / Tee / Keramik / Holz / Papier / Duft“ umfasst, die eine zurückhaltende, elegante Ausstrahlung benötigen – verwenden Sie dieses Skill.

Wann wird es ausgelöst

Der Nutzer sagt:

  • „Erstelle ein Portfolio im chinesischen / orientalischen / klassischen Stil“
  • „Erstelle eine Website im LiShu-Stil / eine Studio-Website“
  • „Erstelle ein Portfolio im Stil des weißen Hauses“ / „Erstelle eine horizontale Listen-Website wie Gurgel D’Alfonso“
  • „lishu-portfolio-gen ...“

Und liefert:

  • Studiobeschreibung (erforderlich): Name, Leiter, Stadt, Disziplin, Titel und Geschichten mehrerer Werke
  • Werkbilder (optional): URL / Upload / Pfad. Funktioniert auch ohne (dann mit Picsum-Platzhaltern).

Wenn der Nutzer überhaupt keine Werkstitel angibt → einmal nachfragen, welche Werke mindestens gezeigt werden sollen. Wenn der Nutzer nur Titel ohne Details angibt → selbst schreiben: jedes Werk erhält 1 Lead-Satz + 3 Prosa-Absätze + 6-8 Specs + 3-6 Picsum-Bilder + mehrere Credits. Tonfall passend zum Werktyp (Buch → Buchgestaltung, Schrift → Schrift, Gegenstand → Stillleben, Ausstellung → Ausstellungsvisualität).

Zwei Betriebsmodi

Modus A · Claude Code / Lokal (mit Dateisystem)

  • Mit Bash Ordner auflisten, sips für Breite/Höhe jedes Bildes
  • Ausgabepfad: ~/Desktop/{slug}-portfolio.html (Einzeldatei, alle Bilder per URL)
  • Wenn der Nutzer lokale Bilder angibt: Diese nach ~/Desktop/{slug}-portfolio-images/ kopieren und src auf relativen Pfad ändern

Modus B · GLM / Online-Chat (ohne Dateisystem)

  • Der Nutzer lädt eine ZIP-Datei hoch, entpackt sie und sieht 4 Dateien
  • Nur eine vollständige HTML-Zeichenkette ausgeben, eingeschlossen in einem ```html-Codeblock
  • Vom Nutzer hochgeladene Bilder ohne URL → alle mit https://picsum.photos/id/{id}/{w}/{h} als Platzhalter (bekannte IDs verwenden)
  • Nicht versuchen, auf lokale Dateien zuzugreifen oder Befehlszeilenoperationen vorzuschlagen

Entscheidung: Wenn Sie keine lokalen Bilder lesen können → standardmäßig Modus B.

Dateiaufteilung

DateiRolleVerwendung
reference.htmlVollständige Referenz — BAIWU mit 6 WerkenAnsehen: Formulierung der Listeneinträge, Prosa-Tonfall, Specs-Vokabular, JSON-Felddichte
template.htmlLeeres Grundgerüst — Gleiches CSS/JS/Routing-System, 2 Beispiele + 20 SWAP-MarkenDarauf aufbauend ändern, finales HTML ausgeben
README.mdBedienungsanleitung aus NutzersichtModell muss es nicht lesen
SKILL.mdArbeitsablauf für das Modell (diese Datei)Lesepflicht

Kernregel: Alle Änderungen basieren auf template.html; aus reference.html lernen, wie man schreibt (Tonfall, Wortanzahl, Tag-Verwendung), aber keine spezifischen Inhalte kopieren.

Arbeitsschritte

1. Beide HTML-Dateien lesen

  • Zuerst reference.html lesen, um zu verstehen, „wie das Endergebnis aussieht“ (insbesondere die Felddichte des works-data-JSONs und den Prosa-Tonfall)
  • Dann template.html lesen, um die 20 SWAP-Positionen zu finden

JS nicht ändern / CSS nicht ändern / Detailseiten-Routing-System nicht ändern / Schriftarteinbindung nicht ändern. Die SWAPs befinden sich nur im HTML-Text und in den JSON-Daten.

2. Eingabe des Nutzers parsen und Informationen extrahieren

Extrahieren:

  • ATELIER_NAME_ZH — Chinesischer Name des Studios (optimal 2-4 Zeichen, z. B. „白屋“, „素园“, „墨记“, „青庐“, „拙轩“)
  • PINYIN — Pinyin (5-6 englische Buchstaben, GROSSGESCHRIEBEN: BAIWU / SUYUAN / MOJI)
  • CHAR — Einzelzeichen für das Logo (normalerweise das erste Zeichen des Studio-Namens: 白 / 素 / 墨 / 青 / 拙)
  • CITY — Stadt
  • DIRECTOR_ZH / DIRECTOR_EN — Name des Leiters + Pinyin
  • DISCIPLINE — 3 Disziplin-Wörter („Buchgestaltung · Schrift · Stillleben“)
  • TAGLINE — Ein-Satz-Positionierung (20-40 Zeichen, Kalligrafie-Stil)
  • YEAR_FOUNDED — Gründungsjahr (kann mit Himmelsstämmen und Erdzweigen angegeben werden: 乙未冬 / 甲辰春)

Für jedes Werk extrahieren:

  • slug — URL-ID, englische Kleinbuchstaben mit Bindestrich (kong-shan-ji / wu-ming-shu)
  • title_zh — Chinesischer Titel (optimal 2-5 Zeichen, desto präziser, desto stilvoller)
  • title_en — Englischer Untertitel (Stil „An Anthology of Empty Mountains“)
  • year — Jahr oder Himmelsstamm-Erdzweig-Jahr (甲辰 / 2024 / 2025 / 乙巳 / 2025)
  • tag — Kategorie oben, in eckigen Klammern, z. B. [ 诗集 · 装帧设计 ] / [ 字体设计 · 中草药图谱 ]
  • cover — URL des großen Bildes auf der Detailseite
  • location in der Liste – Stadt, Jahr · Technik/Spezifikation (erscheint beim Hovern)
  • meta — 4 Schlüssel-Wert-Paare (4-spaltige Zusammenfassung auf der Detailseite)
  • lead — 30-70 Zeichen großer Eröffnungssatz, kann <em>Schlüsselwort</em> zur Betonung enthalten
  • prose — 3-4 Absätze, jeder 80-150 Zeichen
  • specs — 6-10 Zeilen Spezifikationstabelle (Format/Papier/Bindung/Schrift/Auflage/Druck/Technik/Preis usw.)
  • gallery — 3-6 Bilder, Layout: eines von drei Optionen: g-wide / g-half / g-third
  • credits — 4-7 Paare Position/Name

Wenn der Nutzer nur einen Satz / keine Geschichte liefert → selbst erfinden: basierend auf Titel und Typ des Werks Lead und Prosa schreiben, die zum Stil des Werks passen. Tonfall referenziert reference.html – keine Marketing-Sprache, sondern „Museums-Wandtext + Studio-Notizen“ (zurückhaltend, konkret, langsam, handwerklich geprägt).

3. Werke auflisten + Abmessungen ermitteln (nur Modus A)

ls -la "{works_path}"
sips -g pixelWidth -g pixelHeight "{works_path}/{file}" 2>/dev/null

Für jedes Bild ermitteln: (Dateiname, Breite, Höhe, Seitenverhältnis). Bevorzugt Hochformate als Listen-Thumbnails (4:3-Container, Hochformate wirken besser).

4. 20 SWAPs ersetzen

SWAPPositionInhalt
1<title>{ATELIER_NAME} {PINYIN} — {DIRECTOR} Portfolio / Studio
2meta descriptionEin-Satz-Website-Beschreibung
3Einzelzeichen im VorhangErstes Zeichen des Studio-Namens (z. B. „白“)
4Einzelzeichen im Logo-SVGWie SWAP-3
5Pinyin im Logo-SVG{PINYIN} in GROSSBUCHSTABEN
6Hauptnavigation liNormalerweise 3 Punkte: Arbeiten / Über / Kontakt
7Brand-Block chinesischer Name{ATELIER_NAME} mit Leerzeichen zwischen Zeichen (z. B. 白&nbsp;&nbsp;屋)
8Brand-Block englisch{PINYIN} Studio · {CITY}
9TaglineKalligrafie-Stil, Ein-Satz-Positionierung, 20-40 Zeichen, kann <br> für Zeilenumbruch verwenden
10Listeneinträge N WerkeJedes <a class="item" href="#work/{slug}"> mit num/project-name/en-name/location/photo-thumb
11Galerie-Einträge N WerkeGleiche N Werke, kompakteres Raster – slug muss mit Liste übereinstimmen
12Überschrift „Über“Ü&nbsp;ber&nbsp;{name}<span class="en">About</span>
13Absätze „Über“1-3 Absätze im Kalligrafie-Stil (Gründungshintergrund / Leiter / Designphilosophie), jeder 60-120 Zeichen
14Fakten „Über“4-6 li-Einträge (Gegründet/Ort/Disziplin/Leiter/Öffnungszeiten)
15Überschrift „Kontakt“Kon&nbsp;takt<span class="en">Get in Touch</span>
16Absätze „Kontakt“1-2 Absätze, Einladung zur Kontaktaufnahme + Versprechen der Antwortzeit
17Fakten „Kontakt“4-6 li-Einträge (E-Mail/Telefon/Adresse/Instagram/WeChat-Kanal)
18Rotierender CreditWebsite von {WER} (normalerweise der Studio-Name)
19Footer drei Blöcke© / ICP / Social-Media-Links
20works-data JSONVollständige Detaildaten der N Werke (entscheidend!)

5. works-data JSON schreiben (entscheidender Schritt)

Jedes Werk muss einen Eintrag im JSON-Array haben, slug muss exakt mit dem #work/SLUG in den href-Attributen der Listen-/Galerie-Karten übereinstimmen.

JSON-Felder:

{
  "slug": "kong-shan-ji",
  "title_zh": "空山集",
  "title_en": "An Anthology of Empty Mountains",
  "year": "甲辰 / 2024",
  "tag": "[ 诗集 · 装帧设计 ]",
  "cover": "https://picsum.photos/id/143/1800/1100",
  "meta": [
    {"label": "Type / 类型", "value": "诗集装帧"},
    {"label": "Year / 年份", "value": "2024"},
    {"label": "Edition / 印量", "value": "Erstauflage 320 Exemplare"},
    {"label": "Format / 开本", "value": "130 × 195 mm"}
  ],
  "lead": "Sechsunddreißig Gedichte über Berge. Wir wollten ein Buch machen – das der Leser zuerst <em>den Wind hören</em> lässt, bevor er die Schrift liest.",
  "prose": [
    "Absatz 1: Herkunft der Gedichtmanuskripte / Gestaltungskontext. 80—150 Zeichen.",
    "Absatz 2: Wichtige Entscheidungen während der Herstellung – Schriftart, Papier, Bindung.",
    "Absatz 3: Endpräsentation / Das Gefühl, das dem Leser bleibt."
  ],
  "specs": [
    ["Format / 开本", "130 × 195 mm"],
    ["Seiten / 页数", "144 Seiten"],
    ["Papier / 纸张", "Naturfarbenes Baumwollpapier 90gsm"],
    ["Bindung / 装订", "Vierfadenheftung"],
    ["Schrift / 字体", "Alte Song (Titel) · Kursivschrift (Text)"],
    ["Druck / 印刷", "Einfarbiger Hochdruck"],
    ["Auflage / 印量", "Erstauflage 320 Exemplare"],
    ["Preis / 定价", "¥ 388"]
  ],
  "gallery": [
    {"src": "...", "layout": "g-wide", "caption": "Cover"},
    {"src": "...", "layout": "g-half"},
    {"src": "...", "layout": "g-half"},
    {"src": "...", "layout": "g-third"},
    {"src": "...", "layout": "g-third"},
    {"src": "...", "layout": "g-third"}
  ],
  "credits": [
    ["Design / 设计", "周墨白"],
    ["Handheftung / 手工装订", "陈漱石 (Hangzhou · Bookbindery)"]
  ]
}

JSON-Fehlerquellen ⚠️:

  • In chinesischen Prosa-Texten Anführungszeichen verwenden → müssen 「...」 oder "..." (U+201C / U+201D) sein, nicht ASCII " (bricht das JSON)
  • Keine echten Zeilenumbrüche in JSON-Strings; für Absätze im prose-Array einfach einen weiteren Eintrag hinzufügen
  • <em>Wort</em> im Lead direkt als HTML-Tag schreiben – wird beim Rendern als innerHTML ausgegeben
  • layout in der Gallery muss eine von drei Optionen sein: g-wide (volle Breite) / g-half (halbe Breite) / g-third (1/3 Breite)

6. Bildquellenauswahl

  • Picsum-Platzhalter: id/X statt seed/X verwenden (stabiler). Bekannte gute IDs: 0, 20, 40, 51, 64, 76, 88, 91, 96, 119, 121, 130, 143, 145, 158, 164, 165, 175, 177, 180, 187, 195, 200
  • Für Cover/Galerie desselben Werks benachbarte IDs verwenden, um einen einheitlichen Farbton zu erzeugen
  • Keinen ?grayscale-Parameter anhängen (der Nutzer wünscht sich Farbbilder)

7. Inspiration für chinesische Studio-Namen (wenn der Nutzer keinen angibt)

Wenn der Nutzer „erfinden Sie selbst“ sagt → 2 Zeichen + altertümlich wählen:

  • Gegenstandsart: 白屋 / 素园 / 墨记 / 青庐 / 拙轩 / 听雨 / 一勺 / 半亩
  • Zeilenart: 素白 / 子衿 / 砚池 / 半山 / 寻常 / 浮云
  • Vermeiden Sie Funktionswörter wie „工作室 / 设计 / Studio“, lassen Sie den Namen selbst ein Gedicht sein

8. Video-Unterstützung

Wenn das Cover eines Werks .mp4 / .webm / .mov ist, verwendet die Detailseite automatisch <video autoplay muted loop> statt <img>. Das Modell muss nur den Videopfad in der Cover-URL angeben.

9. Bericht

Modus A: Ein-Satz-Bericht.

Erstellt ~/Desktop/baiwu-portfolio.html — 6 Werke, Zeile hovern für Thumbnail, Klicken für Detailseite. Hell/Dunkel unten links, Listen-/Kachelansicht oben mittig.

Modus B: Sofort den vollständigen HTML-Codeblock + eine Zeile Erklärung ausgeben.

Speichern Sie das Obige als index.html und doppelklicken Sie darauf. Bewegen Sie die Maus über einen Werknamen, um das Thumbnail rechts erscheinen zu sehen, klicken Sie für die Detailseite. Zum Austausch von Bildern ersetzen Sie die Picsum-URLs durch Ihre eigenen Bildadressen.

Muss beibehalten werden (darf nicht geändert werden)

  • Schriftarteinbindung: @font-face lädt die woff2-URL von „Alimama DaoLiTi“ (Schriftquelle nicht ändern)
  • CSS-Variablen-System: Hell/Dunkel-Doppelthema
  • Sämtliches JS: Theme-Umschalter, Ansichtsmodus-Umschalter, Hover-Row-Interaktion, rotierender Credit, Hash-Routing applyRoute() und renderDetail() für Detailseiten
  • <script id="works-data">-Knoten muss erhalten bleiben
  • <main id="detail-root"> muss erhalten bleiben (Einhängepunkt für Detailseite)
  • body[data-view="home/detail"] und body[data-mode="list/gallery"] Zustandssystem
  • Fünf fix positionierte Elemente: #logo / #main-menu / .theme-toggle / #project-view / #svp-credit

Schnell-Checkliste für Fehler

  • Slug stimmt nicht überein: Listen-Eintrag #work/kong-shan-ji ↔ Galerie-Eintrag #work/kong-shan-ji ↔ JSON "slug": "kong-shan-ji" — alle drei müssen exakt identisch sein
  • JSON-Anführungszeichen: Anführungszeichen im chinesischen Text immer mit 「」 oder "..." (U+201C / U+201D), nicht mit ASCII "
  • Zu viele Galeriebilder: Maximal 6 Bilder pro Werk, sonst leidet das Layout
  • Prosa zu lang: Jeder Absatz 80-150 Zeichen, bei über 200 Zeichen sinkt die Lesbarkeit
  • Liste / Galerie nicht synchron: Sie müssen dieselbe Sammlung von Werken enthalten (eins-zu-eins-Entsprechung)
  • Picsum seed: id/X verwenden, nicht seed/X, um zu vermeiden, dass eine zufällige ID auf ein gelöschtes Bild trifft
  • Weniger als 3 Werke: Möglich, mindestens 2 Werke funktionieren
  • Mehr als 8 Werke: In zwei Chargen aufteilen, zu viele Listenzeilen machen die Seite zu lang
  • Erstes Zeichen schwebend: .detail__prose p:first-of-type::first-letter auf der Detailseite verwendet die LiShu-Schrift — der erste Absatz muss mit chinesischen Zeichen beginnen (nicht mit <em> oder englischen Buchstaben)
  • Farbe aus Picsum entfernt: Bilder sollten farbig bleiben, kein filter: grayscale() im CSS hinzufügen

Individual skills in this repo

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

ARYAN2302/liquid_researcher

Chinese-market SaaS pricing page template — soft sky-blue glass-morphism, 4-tier card grid with one elevated "recommended" tier, monthly/annual toggle, FAQ accordion, ¥ pricing with Inter numerals, careful CJK linebreaking, ICP filing footer.

ARYAN2302/liquid_researcher

Premium calm-tech SaaS landing template — bilingual (CN/EN) literary voice over a dark forest-night palette with warm gold accent, Cormorant + Noto Serif SC, Three.js procedural forest hero, station-based scrolling narrative, custom cursor. Built for ambient-AI / creative-tool / philosophical SaaS, not loud commercial launch.

ARYAN2302/liquid_researcher

Pro-camera HUD mockup template — full-viewport black canvas wrapping a real video with monospace overlays (corner brackets, top status bar, side AF/exposure columns, bottom timecode + aperture/shutter/ISO row, vertical 8-filter wheel, animated reticle). For cinematographer portfolios, camera-app demos, LUT pack previews, filter-look auditions. NOT a TikTok/Reels mockup, NOT a storyboard, NOT a shot list, NOT a script document. The chrome wraps real footage — never a div placeholder.

ARYAN2302/liquid_researcher

Premium pre-launch waitlist page template — dark charcoal canvas with subtle vignette, drifting portrait video-thumbnail cards, fade-up cascades, glass nav, live-updating join counter, single email form with success/error states. Built for creative-tool / AI / niche-SaaS invite-only launches with hushed exclusive tone, not loud growth-marketing.

ARYAN2302/liquid_researcher

Route design-related HTML artifact tasks to the right artifact skill, reference, design system generation, or export skill.

ARYAN2302/liquid_researcher

Implement text-to-speech (TTS) capabilities using the z-ai-web-dev-sdk. Use this skill when the user needs to convert text into natural-sounding speech, create audio content, build voice-enabled applications, or generate spoken audio files. Supports multiple voices, adjustable speed, and various audio formats.

ARYAN2302/liquid_researcher

Implement AI-powered video generation capabilities using the z-ai-web-dev-sdk. Use this skill when the user needs to generate videos from text prompts or images, create video content programmatically, or build applications that produce video outputs. Supports asynchronous task management with status polling and result retrieval.

ARYAN2302/liquid_researcher

Implement specialized video understanding capabilities using the z-ai-web-dev-sdk. Use this skill when the user needs to analyze video content, understand motion and temporal sequences, extract information from video frames, describe video scenes, or perform video-based AI analysis. Optimized for MP4, AVI, MOV, and other common video formats.

Verwandte Skills