Communitygithub.com

AiCurv/ADBCommander

自然言語のスタジオ説明から、作品を行リストで表示し、ホバーでサムネイルを表示、ハッシュルーティングで詳細ページを持つ、単一ファイルの中国風アトリエポートフォリオWebサイト(.html)を生成します。

ADBCommander とは?

このスキルは、自然言語によるスタジオの説明(名前、ディレクター、分野、作品など)から、洗練された中国風アトリエスタイルのポートフォリオWebサイトを単一のHTMLファイルとして生成します。デザインは、横一列の作品リスト、ホバーによるサムネイル表示、CDN経由のAlimama DaoLiTiフォントを使用した芸術的な隷書体のタイポグラフィ、ライト/ダークテーマ、ハッシュルーティングによる詳細ページという特徴を持ちます。Claude Code(ファイルシステムあり)とGLMなどのオンラインチャット(ファイルシステムなし)の両方で動作し、それぞれの環境に応じて出力方法が異なります。Claude CodeではHTMLファイルをデスクトップに書き出し、オンラインチャットではHTMLコードをインラインで出力します。このスキルは、template.htmlをベースに、reference.htmlから適切なトーンとデータ構造を学習し、完全に動作するポートフォリオサイトを生成します。

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

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

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

ドキュメント

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

一言でいうと

横並びテキスト行 + hoverで右側に大きな画像表示 + 阿里媽媽刀隷体のアート大字 + 白黒純色 + light/dark + hashルーティング詳細ページ + リスト/ギャラリーの二重ビュー。

他の作品集スキルとの違い

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

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

いつトリガーするか

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

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

そして、次のものを提供する場合:

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

ユーザーが作品タイトルを全く提供しなかった場合 → 少なくとも表示する作品がいくつあるか一度尋ねなければなりません。 ユーザーがタイトルのみ提供し詳細を提供しなかった場合 → 自分で作成します:各作品に対して1文のリード + 3段落の散文 + 6-8行のスペック + 3-6枚のpicsum画像 + いくつかのクレジット。トーンは作品のタイプに合わせます(本→製本 / フォント→フォント / 物→静物 / 展覧会→展示ビジュアル)。

二つの実行モード

モード 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作品見る:list項目の言い回し、proseのトーン、specsの語彙、JSONフィールドの密度
template.html空の骨格 — 同じCSS/JS/ルーティングシステム、2つのサンプル + 20個のSWAPマーカーこれをベースに変更し、最終的なHTMLを出力
README.mdユーザー向け使用説明モデルは見なくて良い
SKILL.mdモデル向けワークフロー(このファイル)必読

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

作業手順

1. 二つのHTMLを読む

  • まず reference.html を読んで「完成形がどのようなものか」を理解する(特に works-data JSONのフィールド密度とproseのトーン)
  • 次に 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 — 都市、年份 · 工芸/仕様(hover時に表示)
  • meta — 4つのキーと値のペア(詳細ページ4列概要)
  • lead — 30-70字の冒頭大文字、<em>キーワード</em> で一箇所強調可
  • prose — 3-4段落の散文、各段落80-150字
  • specs — 6-10行の仕様表(サイズ/紙/製本/フォント/印刷部数/印刷/工芸/価格など)
  • gallery — 3-6枚の画像、レイアウトは3択:g-wide / g-half / g-third
  • credits — 4-7組の役職/名前

ユーザーが一言だけ/ストーリーを提供しなかった場合 → 自分で作成:作品タイトルとタイプに基づき、作品の雰囲気に合ったleadとproseを書きます。トーンはreference.htmlを参考に — マーケティング的な言葉ではなく、「ミュージアムの展示解説文 + スタジオノート」のような感じ(抑制、具体的、ゆったり、手仕事の痕跡がある)。

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

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

各画像の (filename, w, h, aspect) を取得します。listのサムネイルには縦長の画像を優先します(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/WeChat公式アカウント)
18rotating creditSite by {WHO}(通常はスタジオ名)
19footer 3ブロック© / ICP / ソーシャルリンク
20works-data JSONN件の作品の完全な詳細データ(重要!)

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

各作品はJSON配列のエントリを持ち、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のよくある間違い ⚠️:

  • Chinese prose内で引用符を使用する場合 → 全角の 「...」 または "..."(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作品、hover行でサムネイル表示、クリックで詳細ページへ。Light/Darkは左下、リスト/ギャラリーは上部中央。

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

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

強制保持(変更不可)

  • フォントインポート:@font-face でAlimama DaoLiTiのwoff2 URLを読み込む(フォントソースは変更しない)
  • CSS変数システム:light/dark 二重テーマ
  • すべてのJS:theme toggle、view mode toggle、hover-rowインタラクション、rotating credit、詳細ページhashルーティング 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 五つの固定配置要素

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

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

Individual skills in this repo

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

AiCurv/ADBCommander

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.

AiCurv/ADBCommander

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.

AiCurv/ADBCommander

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.

AiCurv/ADBCommander

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

AiCurv/ADBCommander

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.

AiCurv/ADBCommander

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.

AiCurv/ADBCommander

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.

関連スキル