Communitygithub.com

ARYAN2302/liquid_researcher

自然言語によるスタジオ情報から、横書き文字行+ホバーで右側にサムネイル表示、阿里媽媽刀隷体の大字、ライト/ダークテーマ、ハッシュルーティングの詳細ページを備えた、中国アトリエ風の単一ファイルポートフォリオWebサイト(.html)を生成するスキルです。Claude Code(~/Desktop に書き出し)とGLM/オンラインチャット(HTML インライン出力)の両方で動作します。

liquid_researcher とは?

このスキルは、ユーザーが自然言語で入力したスタジオ情報(名前、主宰者、分野、作品など)を解析し、中国アトリエ風の単一ファイルHTMLポートフォリオサイトを自動生成します。生成されるサイトは、横書き文字行のリストとホバーで右側に浮かび上がるサムネイル画像、阿里媽媽刀隷体(Alimama DaoLiTi)フォントをCDN経由で使用したアートタイポグラフィ、ライト/ダークテーマの切り替え、ハッシュルーティングによる作品詳細ページ、リストビューとギャラリービューの切り替えなど、洗練されたインタラクションを備えています。このスキルは、装丁、フォントデザイン、工芸、中国風スタジオなど、抑制の効いた典雅な雰囲気が求められるプロジェクトに最適です。Claude Code(ファイルシステムあり)では、画像の寸法を自動取得し、~/Desktop に単一の .html ファイルと画像フォルダを出力します。GLM などのオンラインチャット(ファイルシステムなし)では、完成したHTML文字列を直接出力し、picsum.photos のプレースホルダー画像を使用します。スキルの中核は template.html をベースに20箇所のSWAP箇所を置換することで、CSS、JS、ルーティングシステムは変更せず、テキストコンテンツとJSONデータのみを編集します。作品データは詳細なJSON構造に従い、lead文、散文段落、スペック表、ギャラリー、クレジットを含み、統一されたトーン(博物館の壁面テキスト+スタジオノート風)で記述されます。

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

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

portfolio-detail — 中式工作室 / 隷書作品集(詳細ページ付き)

一言で表すと

横書き文字行 + ホバーで右側に大きな画像が浮かび上がる + 阿里媽媽刀隷体のアート大字 + 白黒の純色 + light/dark + ハッシュルーティング詳細ページ + リスト/ギャラリーの2ビュー。

他のポートフォリオスキルとの違い

スキルコアモード対象者
portfolio-gen無限ドラッグキャンバス + タイル配置写真家 / グラフィックデザイナーがサンプルを展示
portfolio-museum-genヒーローカルーセル + ラージカード + ウォーターフォール + 詳細ページ(映像キュレーション感)映像 / メディアアート / インスタレーションアーティスト
industrial-archive-gen黒枠のページめくり表紙 + サイドバーアーカイブ + 北欧インダストリアル実物製品 / 器物 / ハードウェア
lishu-portfolio-gen横書き文字行 + ホバーで右側にサムネイル表示 + 隷書の大字 + 中国風の抑制装丁 / フォント / 工芸 / 中国風スタジオ

ユーザーのプロジェクトが「本 / フォント / 展覧会 / 静物 / 漢方薬 / 茶 / 陶器 / 木 / 紙 / 香」など、抑制の効いた典雅な雰囲気を必要とする場合は、こちらを使用してください。

いつトリガーされるか

ユーザーが次のように言った場合:

  • 「中国風 / 東洋風 / 古典的なポートフォリオを作って」
  • 「隷書スタイルのウェブサイト / スタジオホームページを作って」
  • 「白屋スタイルのポートフォリオを作って」 / 「Gurgel D'Alfonso のような横書きリストサイトを作って」
  • 「lishu-portfolio-gen ...」

そして、以下を提供する場合:

  • スタジオの説明(必須):名前、主宰者、都市、分野、何作品かのタイトルとストーリー
  • 作品画像(オプション):URL / アップロード / パス。なくても動作します(picsum でプレースホルダー)

ユーザーが作品のタイトルをまったく与えなかった場合 → 少なくともどの作品を表示するか、一度質問する必要があります。 ユーザーがタイトルだけで詳細を与えなかった場合 → 自分で作成する:各作品に1文のリード + 3段落の散文 + 6-8行のスペック + 3-6枚のpicsum画像 + いくつかのクレジットを生成します。トーンは作品のタイプに合わせます(本 → 装丁 / フォント → フォント / 物 → 静物 / 展 → 展覧会ビジュアル)。

2つの動作モード

モード A · Claude Code / ローカル(ファイルシステムあり)

  • Bash でフォルダを一覧表示し、sips で各画像の幅と高さを取得
  • 出力先:~/Desktop/{slug}-portfolio.html(単一ファイル、すべての画像はURL経由)
  • ユーザーがローカル画像を与えた場合:~/Desktop/{slug}-portfolio-images/ にコピーし、src を相対パスに変更

モード B · GLM / オンラインチャット(ファイルシステムなし)

  • ユーザーがzipをドラッグ&ドロップして解凍すると、4つのファイルが見える
  • 完全なHTML文字列のみを出力し、```html コードブロックで囲む
  • ユーザーが画像をアップロードしたがURLがない場合 → すべて https://picsum.photos/id/{id}/{w}/{h} のプレースホルダーを使用(存在が確認されているIDを使う)
  • ローカルファイルへのアクセスやコマンドライン操作の提案はしない

判断基準:もしRead でローカル画像を見ることができない場合 → デフォルトでモード B を選択。

ファイルの役割分担

ファイル役割使い方
reference.html完全な完成品の参考 — 白屋 BAIWU の6作品参照:リスト項目の言い回し、散文のトーン、スペックの語彙、JSONフィールドの密度
template.html空のスケルトン — 同じCSS/JS/ルーティングシステム、2つのサンプル作品 + 20箇所の SWAP マークこれをベースに変更し、最終的なHTMLを出力
README.mdユーザー視点の使用説明モデルは見る必要はない
SKILL.mdモデル向けワークフロー(本ファイル)必読

コアルール:すべての変更は template.html をベースに行う;reference.html からは書き方(トーン、文字数、タグの語彙)を学び、具体的な内容はコピーしない。

作業手順

1. 2つのHTMLを読む

  • 最初に reference.html を読み、「完成後がどのようなものか」を理解する(特に works-data JSON のフィールド密度と散文のトーン)
  • 次に template.html を読み、20箇所の SWAP 位置を見つける

JSは変更しない / CSSは変更しない / 詳細ページのルーティングシステムは変更しない / フォントの読み込みは変更しない。 SWAP はすべてHTMLテキストとJSONデータ内にあります。

2. ユーザー入力を解析して情報を抽出

抽出するもの:

  • ATELIER_NAME_ZH — スタジオの中国語名(2-4文字が最適、例「白屋」「素園」「墨記」「青廬」「拙軒」)
  • PINYIN — ピンイン(5-6文字の英字、すべて大文字:BAIWU / SUYUAN / MOJI)
  • CHAR — ロゴに使用する一文字(通常はスタジオ名の最初の文字:白 / 素 / 墨 / 青 / 拙)
  • CITY — 都市
  • DIRECTOR_ZH / DIRECTOR_EN — 主宰者の名前 + ピンイン
  • DISCIPLINE — 3つの分野の単語(「装幀 · フォント · 静物」)
  • TAGLINE — 一言で表すポジショニング(20-40文字、楷書体の雰囲気)
  • YEAR_FOUNDED — 設立年(干支を使用可能:乙未冬 / 甲辰春)

各作品から抽出:

  • slug — URL ID、小文字の英数字とハイフン(kong-shan-ji / wu-ming-shu)
  • title_zh — 中国語タイトル(2-5文字が最適、簡潔であるほど風格が出る)
  • title_en — 英語サブタイトル(書名スタイル:An Anthology of Empty Mountains)
  • year — 年または干支年(甲辰 / 2024 / 2025 / 乙巳 / 2025)
  • tag — 上部のカテゴリー、角括弧で囲む、例 [ 詩集 · 装幀設計 ] / [ 字体設計 · 中薬草図譜 ]
  • cover — 詳細ページの大きな画像URL
  • list 行の location — 都市、年 · 技法/仕様(ホバー時に表示)
  • meta — 4つのキーと値のペア(詳細ページの4列サマリー)
  • lead — 30-70文字の開幕の大文字、<em>キーワード</em> で一箇所強調可能
  • prose — 3-4段落の散文、各段落80-150文字
  • specs — 6-10行のスペック表(判型/用紙/製本/フォント/刷部数/印刷/技法/価格など)
  • gallery — 3-6枚の画像、レイアウトは g-wide / g-half / g-third から選択
  • credits — 4-7組の役職/名前

もしユーザーが一言/ストーリーを与えなかった場合 → 自分で作成する:作品のタイトルとタイプに基づき、作品のトーンに合ったリードと散文を書きます。トーンは reference.html を参考に — マーケティング的な言葉ではなく、「博物館の壁面テキスト + スタジオノート」のような感覚(抑制が効いていて、具体的で、ゆっくりとしていて、手作りの痕跡がある)。

3. 作品をリストアップし、寸法を調べる(モード A のみ)

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

各画像の (filename, w, h, aspect) を取得します。リストのサムネイルには縦長の画像を優先して選びます(4:3 コンテナ、縦長画像の方が見栄えが良い)。

4. 20箇所の SWAP を置換

SWAP位置内容
1<title>{ATELIER_NAME} {PINYIN} — {DIRECTOR}作品集 / Studio
2meta description一言のサイト概要
3curtain の一文字スタジオ名の最初の文字(例「白」)
4logo SVG 内の一文字SWAP-3 と同じ
5logo SVG 内のピンイン{PINYIN} 大文字
6メインナビゲーションの li通常3項目:作品 / について / お問い合わせ
7brand-block の中国語名{ATELIER_NAME} を文字間にスペースを入れて(例 白&nbsp;&nbsp;屋)
8brand-block の英語{PINYIN} Studio · {CITY}
9tagline楷書体の一言ポジショニング、20-40文字、<br> での改行可能
10list 項目 N 件各作品 <a class="item" href="#work/{slug}"> に num/project-name/en-name/location/photo-thumb を含む
11gallery 項目 N 件同じ N 件の作品、よりコンパクトなグリッド — slug は list と一致させる必要がある
12概要タイトル関&nbsp;于&nbsp;{name}<span class="en">About</span>
13概要段落1-3段落の楷書体(設立背景 / 主宰者 / デザイン観)、各段落60-120文字
14概要の事実テーブル4-6項目の li (Founded/Location/Discipline/Director/Hours)
15お問い合わせタイトル来&nbsp;信<span class="en">Get in Touch</span>
16お問い合わせ段落1-2段落の連絡を促す文章 + 返信期間の約束
17お問い合わせの事実テーブル4-6項目 (E-mail/Phone/Address/Instagram/公众号)
18rotating creditSite by {WHO}(通常はスタジオ名)
19footer の3ブロック© / ICP / ソーシャルリンク
20works-data JSONN 件の作品の完全な詳細データ(最重要!)

5. works-data JSON を書く(最も重要なステップ)

各作品は JSON 配列内に1つのエントリーを持ち、slug は list/gallery カードの href #work/SLUG と完全に一致している必要があります。

JSON フィールド:

{
  "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": "初版 320 部"},
    {"label": "Format / 判型", "value": "130 × 195 ミリ"}
  ],
  "lead": "三十六首の山についての詩。私たちが作りたかったのは——読者が開いたとき、まず<em>風の音</em>を聞き、それから文字を読む、そんな本。",
  "prose": [
    "段落一:詩稿の出所 / デザインのコンテクスト。80—150 字。",
    "段落二:制作における重要な決定 — フォント、用紙、製本の選択。",
    "段落三:最終的な姿 / 読者に残る印象。"
  ],
  "specs": [
    ["判型 / Format", "130 × 195 ミリ"],
    ["ページ数 / Pages", "144 ページ"],
    ["用紙 / Paper", "本色綿紙 90gsm"],
    ["製本 / Binding", "四つ目綴じ"],
    ["フォント / Typeface", "老宋(タイトル)· 楷書体(本文)"],
    ["印刷 / Printing", "単色凸版印刷"],
    ["刷部数 / Edition", "初版 320 部"],
    ["価格 / Price", "¥ 388"]
  ],
  "gallery": [
    {"src": "...", "layout": "g-wide", "caption": "表紙"},
    {"src": "...", "layout": "g-half"},
    {"src": "...", "layout": "g-half"},
    {"src": "...", "layout": "g-third"},
    {"src": "...", "layout": "g-third"},
    {"src": "...", "layout": "g-third"}
  ],
  "credits": [
    ["デザイン / Design", "周墨白"],
    ["手製本 / Binding", "陳漱石(杭州·訂書坊)"]
  ]
}

JSON の注意点 ⚠️:

  • 中国語の散文内で引用符を使う場合 → 全角の 「...」 または 『...』(U+201C / U+201D)を使用する必要があり、ASCII の " は使用不可(JSON が壊れる)
  • JSON 文字列内に実際の改行を入れないでください;段落を分けたい場合は prose 配列に項目を追加してください
  • lead 内の <em>語</em> はHTMLタグとしてそのまま記述——レンダリング時に innerHTML として出力されます
  • gallery の layout は3つのうちから選択:g-wide(横幅いっぱい)/ g-half(半分の幅)/ g-third(1/3の幅)

6. 画像ソースの選択

  • picsum プレースホルダー:seed/X 形式ではなく id/X 形式を使用(より安定)。推奨ID:0, 20, 40, 51, 64, 76, 88, 91, 96, 119, 121, 130, 143, 145, 158, 164, 165, 175, 177, 180, 187, 195, 200
  • 同じ作品の cover / gallery には連続したIDを使用することで、一貫した色調を生み出せます
  • ?grayscale パラメータは使用しないでください(ユーザーはカラー画像を期待しています)

7. 中国風スタジオ名のインスピレーション(ユーザーが指定しなかった場合)

もしユーザーが「自分で決めて」と言った場合 → 2文字で古風なものを選ぶ:

  • 物名類:白屋 / 素園 / 墨記 / 青廬 / 拙軒 / 聴雨 / 一勺 / 半畝
  • 字行類:素白 / 子衿 / 硯池 / 半山 / 尋常 / 浮雲
  • 「工作室 / 設計 / Studio」のような機能語は避け、名前自体が詩であるようにする

8. 動画サポート

作品の cover が .mp4 / .webm / .mov の場合、詳細ページは自動的に <video autoplay muted loop> を <img> の代わりに使用します。モデルは cover URL に動画のパスを指定するだけで構いません。

9. レポート

モード A:一言でレポート。

~/Desktop/baiwu-portfolio.html を生成しました — 6作品、行にホバーしてサムネイルを表示、クリックで詳細ページへ。Light/Dark は左下、リスト/ギャラリーは上部中央。

モード B:完全なHTMLコードブロック + 一行の説明を直接提供。

上記を index.html として保存し、ダブルクリックして開いてください。マウスを作品名に移動すると右側に浮かび上がるサムネイルが表示され、クリックで詳細ページにジャンプします。画像を変更するには、picsum URL をあなたの画像アドレスに置き換えてください。

強制保持(変更不可)

  • フォントの読み込み:@font-face で阿里媽媽刀隷体の woff2 url を読み込む(フォントソースを変更しないこと)
  • CSS 変数システム:light/dark の二重テーマ
  • すべての JS:テーマ切り替え、ビューモード切り替え、ホバー行のインタラクション、rotating credit、詳細ページのハッシュルーティング applyRoute()、renderDetail()
  • <script id="works-data"> ノードは保持する必要がある
  • <main id="detail-root"> は保持する必要がある(詳細ページのマウントポイント)
  • body[data-view="home/detail"] および body[data-mode="list/gallery"] ステートシステム
  • #logo / #main-menu / .theme-toggle / #project-view / #svp-credit の5つの固定配置要素

よくある間違いとチェックリスト

  • slug の不一致:list 項目の #work/kong-shan-ji ↔ gallery 項目の #work/kong-shan-ji ↔ JSON の "slug": "kong-shan-ji" —— 3箇所が完全に一致している必要がある
  • JSON の引用符:中国語の内容内の引用符は必ず全角の「」または『』を使用し、ASCII の " は使用しない
  • gallery が多すぎる:各作品の画像は最大6枚まで、超えるとレイアウトが崩れる
  • prose が長すぎる:各段落80-150文字、200文字を超えると読みやすさが低下する
  • list / gallery の同期不足:同じ作品セットを含む必要がある(一対一対応)
  • picsum seed:id/X を使用し seed/X は使わない。ランダムIDで削除済み画像に当たるのを避けるため
  • 作品が3点未満:問題ない、最低2点から動作する
  • 作品が8点超:2回に分けることを推奨、リスト行が多すぎるとページが長くなる
  • 頭文字のドロップキャップ:詳細ページの .detail__prose p:first-of-type::first-letter に刀隷体を使用——最初の段落は中国語で始まる必要がある(<em> や英語で始めないこと)
  • picsum のカラー削除:画像はカラーを保持する必要があり、CSS で filter: grayscale() を追加しないでください

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.

関連スキル