Communitygithub.com

Cetc2211/AcTR-app

中国風アトリエの作品集をシングルファイルHTMLで生成。横並びリストとホバー表示のインタラクション、漢字の隷書フォント、ライト/ダークテーマ、ハッシュルートの詳細ページを備える。

AcTR-app とは?

このスキルは、中国風アトリエ(工房・書房)のポートフォリオWebサイトを、1つの完全なHTMLファイルとして生成するためのものです。ユーザーが自然言語でスタジオの名前、主宰者、分野、作品情報を伝えると、SKILL.mdで定義されたワークフローに従って、`template.html`をベースにカスタマイズされたHTMLを出力します。特徴は、横並びの作品リストにマウスを乗せると右側にサムネイルが表示される「ホバー表示」、中国の隷書フォント「阿里妈妈刀隶体」のCDN読み込み、ライト/ダークテーマの切り替え、ハッシュルートによる作品詳細ページです。このスキルはClaude Code(ファイルシステムに書き出し)とGLMなどのオンラインチャット(HTMLコードブロックを出力)の両方で動作します。トリガーフレーズは「做个中式工作室作品集」「做个隶书作品集」「lishu-portfolio-gen ...」などで、ユーザーがスキルフォルダをチャットにドラッグしても起動します。生成されるファイルは自己完結型で、画像はURL(picsum.photosなど)を参照し、オフラインでもそのまま開けるようになっています。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Cetc2211/AcTR-app/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 のような横並びリストのWebサイトを作って」
  • 「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 — 都市,年份·工艺/规格(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組の役職/名前

ユーザーが一言だけ/ストーリーを与えなかった場合 → 自分で創作する:作品のタイトルと種類に基づき、作品の性格に合ったリードと散文を書く。トーンは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 の場合、詳細ページは自動で <img> の代わりに <video autoplay muted loop> を使用する。モデルは cover URL に動画パスを指定するだけでよい。

9. 報告

モードA:一言報告。

已生成 ~/Desktop/baiwu-portfolio.html — 6 件作品,hover 行查看缩略图,点击进入详情页。Light/Dark 在左下,列表/画册在顶部居中。

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

把上面这段保存成 index.html 双击打开。鼠标移到任意作品名上看右侧浮现的缩略图,点击跳详情页。要换图把 picsum URL 换成你的图片地址。

強制保持(変更不可)

  • フォントのインポート:@font-face で阿里妈妈刀隶体の 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 の5つの固定配置要素

よくあるミス クイックチェック

  • 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:二回に分けることを推奨、リスト行が多すぎるとページが長くなる
  • 最初の文字ドロップキャップ:詳細ページの .detail__prose p:first-of-type::first-letter は刀隶体で — 最初の段落は中国語で始まること(<em> や英字で始めない)
  • picsum のカラー削除:画像はカラーを維持し、CSSで filter: grayscale() を追加しない

Individual skills in this repo

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

Cetc2211/AcTR-app

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.

Cetc2211/AcTR-app

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.

Cetc2211/AcTR-app

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.

Cetc2211/AcTR-app

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

Cetc2211/AcTR-app

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.

Cetc2211/AcTR-app

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.

Cetc2211/AcTR-app

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.

関連スキル