Communitygithub.com

ARYAN2302/liquid_researcher

デザイン関連のHTMLアーティファクトタスクを適切なアーティファクトスキル、リファレンス、デザインシステム生成、またはエクスポートスキルにルーティングします。

liquid_researcher とは?

このスキルは、デザイン関連のHTMLアーティファクト作業をルーティングするための中央ルーターとして機能します。ユーザーリクエストがデザイン関連かどうかを判断し、適切なアーティファクトスキル(デザインシステム参照、生成、エクスポートなど)に振り分けます。また、テンプレートのチェック、スタイルの優先順位付け、品質ゲートの実行など、設計プロセス全体を管理します。このスキルは、Claude Codeを含むAIエージェント向けに設計されており、デザインの判断を自動化し、一貫性のある構造化されたHTML出力を生成するのに役立ちます。動作の流れは、リクエストの理解、テンプレートの確認、スタイルの適用、ビルド、品質チェックの順に進みます。特に、ユーザーの入力を優先し、デザインシステムやテンプレートを補完的に使用することで、効率的かつ高品質なデザイン成果物を提供します。

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

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

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

ドキュメント

デザインスキル

デザインスキルは、デザイン関連のHTMLアーティファクト作業のルーターです。

以下の判断を行います:

  • タスクがデザイン関連かどうか
  • どのアーティファクトスキルを優先すべきか
  • タスクが design-system-reference.md を使用すべきかどうか
  • タスクが design-system-generation.md を使用すべきかどうか
  • タスクが export.md を使用すべきかどうか
  • アクション前にどの程度の明確化が必要か
  • ルーティング前にリクエストを迅速に読む方法(「生成前」を参照)
  • 組み込みのデザイン品質デフォルトを適用する方法
  • 将来の編集のために生成されたHTMLを構造化して保持する方法

デザインスキルは小さく保つべきです。

アーティファクト固有の構造ルールは、アーティファクトスキルファイルに属します。シナリオのビジネス判断は、そのシナリオスキル内に存在します。クロスカッティングなクラフトルールは horizontal-craft/ に属します。 参照の選択は design-system-reference.md に属します。 DESIGN.md のインポート/抽出/永続化は design-system-generation.md に属します。 エクスポート/パッケージ/ハンドオフは export.md に属します。

デフォルトの最初の成果物はデザインアーティファクトであり、通常はHTMLです。ただし、選択されたアーティファクトスキルまたはエクスポートターゲットが固定画像、デッキ、パッケージ、またはデザインシステムスペックを必要とする場合は例外です。エクスポートは、ユーザーが現在のアーティファクトのパッケージ化、ダウンロード、変換、またはハンドオフを依頼したときに呼び出されます。

フロー(一度読めば、以下のすべてを統制します)

スキル全体が1つのフローです。そのほとんどは内部的かつ瞬間的で、リクエストが真に曖昧な場合にのみ一時停止します。どのステップも、記入するフォームや最初に読まなければならないファイルにしないでください。

ユーザーリクエスト
   │
   ▼
1. 理解(内部的、明白なリクエストにはサイレント)— 3つの軸を並行して解決:
     • コンテンツ  — 主題、情報、目標
     • シナリオ    — 形式 + 意図  → どのシナリオスキルか(ルーティングを参照)
     • スタイル    — スタイルの手がかりの種類(ある場合)(スタイルルーティングを参照)
   3つすべてが明白 → 続行。1つの軸だけが真に曖昧 → 1つの焦点を絞った質問をする。
   オープンエンド/クリエイティブなリクエストの場合、理解にはこれらの運用軸だけでなく、創造的な読み取りも含まれます
   — 創造的コンテキスト + デザインリードを完了します(§創造的コンテキストの完了を参照)。
   │
   ▼
1.5 テンプレートの確認(要求された場合だけでなく、デフォルトでこれを行う)
   リクエストに一致する `design-templates/INDEX.md` をキャリア + シナリオでスキャンします。
     • 明確な一致  → それを開始点として採用し、そのテンプレートの SKILL.md を読みます。一致する
                      テンプレートを使用すると通常品質が向上します — ゼロからデザインするより優先します。
     • 良い一致がない → シナリオスキルに直接進みます。適合しないテンプレートを強制しないでください。
   テンプレートはクローンするページではなく、開始の構造/スケルトンです — ユーザーの実際のコンテンツを保持し、
   シナリオスキル + 水平クラフトを適用し、参照の正確なレイアウトの指紋をコピーしないでください。
   │
   ▼
2. 優先順位によるスタイルの充填(次元ごと:色・タイポグラフィ・レイアウト・アイコン・スペーシングトークン)
   各次元について、それをカバーする最も優先度の高いソースから取得します:
     1) ユーザーの直接の説明   ← 最高;触れた次元はロックされます
     2) デザインシステム (DESIGN.md)      ← ユーザーが言及しなかった次元を埋めます
     3) テンプレート / シード                ← 残りを埋めます(特にレイアウトの足場)
     4) 並列制約           ← まだ空の次元のフォールバック
        (必要なものだけロード:タイポグラフィ / アイコン / カラー / a11y …)
   ソースは組み合わされます — 例えば、デザインシステムトークン + テンプレートのレイアウトは正常です。
   スタイルの手がかりは曖昧なムードワードであり、名前付きシステムではありません("清新/简约/高级/科技感/复古/温暖/极简/
   赛博" など):単にルックを連想しないでください — ライブラリにマッチさせてください。`design-systems/style-skills` の
   インデックス(およびブランド `index.json`)を読み、`mood` / `formality` / `scheme` タグが最も適合するエントリを
   選択し、それをベースとして使用してください。スタイルタグは、ユーザーの形容詞から具体的なシステムへの架け橋です(例:
   清新简约 → 极简/克制 → `minimal`/`clean`;高级 → 奢华/克制 → `luxury`/`refined`;科技感 → 技术感/未来 → `futuristic`/`hud`)。
   ライブラリにムードに合うものがない場合のみ、ゼロからデザインしてください。
   スタイルの手がかりがまったくなく、シーンが抑制的/創造性主導でない(ツール、ダッシュボード、管理画面、
   フォーム、レポート、通知、一般的なSaaS/コーポレートページ)場合:ゼロからスタイルをデザインしないでください —
   `design-systems/` から成熟したベースラインを積極的に選択し(成熟システムフォールバックを参照)、結果がプロフェッショナルで
   一貫性のあるものになるようにしてください。(明確なルックを望む表現的なシーンはこれをスキップし、§創造的コンテキストに従って大胆に進みます。)
   競合:ユーザーの説明がある次元でデザインシステムと矛盾する場合、その次元ではユーザーが優先されます — そしてそれを1行で
   伝えてください("ご依頼の通り <X> で構築しました。添付のデザインシステムとは異なりますのでご注意ください —
    システムの方向性を維持したい場合はお知らせください。")
   │
   ▼
3. シナリオスキルの判断 + 充填されたスタイルを使用してビルドします。
   │
   ▼
4. 品質ゲート — 提供前に最終チェックリストとして quality-gate.md を実行します。

優先順位による充填が重要な理由:必要なときにのみ制約をロードします — アイコンが何も提供されなかった場合のみアイコン制約を読み、色が何も提供されなかった場合のみ色制約を読みます。 これにより、毎回すべてのルールをダンプする代わりに、スキルを軽量に保ちます。

成熟システムフォールバック

インターフェース / 抑制されたシーン(プロダクトプロトタイプ、ダッシュボード、管理パネル、ウェブツール、設定/フォーム/オンボーディング/チェックアウト、データ重視のインターフェース、一般的なコーポレート/通知ページ)の場合、自由形式の好みではなく成熟したシステムに依存します — ユーザーがバイブワードを与えたかどうかにかかわらず。シーン(および任意のバイブワード)を design-systems/style-skills エントリにその mood タグを介して解決し、それをUIベースとして採用します。インターフェースの成熟度が目標です。実際のシステムは、構造、コンポーネント規律、スペーシングのリズム、状態の動作、およびインタラクションの規則を提供します。

これをクリエイティブ / 表現的なシーンに適用しないでください:

  • social-card.md
  • content-page.md
  • エディトリアル / 文学的なページ
  • portfolio.md
  • landing-page.md と表現的なブランド/ストーリー/ライフスタイルページ

これらの場合、アーティファクトスキル自身のビジュアル判断 + 水平クラフト + 創造的コンテキストからデザインします。システムのキャラクターを参照することはあります(名前付きブランドは常に brand-inspiration をロードします)が、UIキットに押し込まれることはありません。すべてのアーティファクトが汎用的なUIキットのように見えるべきではありません。


ステップ2(スタイルの充填)に供給される可能性のあるコンテキストソース:ユーザーコンテンツ、スクリーンショット、選択されたテンプレート/シード、アップロードされた DESIGN.md、現在のアーティファクト、ブランドアセット、既存のページ、デザインシステム / UIキット、またはFigma/コードベースの参照。存在するものは何でも使用します。他の何もカバーしない次元に対してのみ、並列制約ファイルを読みます。

1. 最初に理解する

このブロックは、「何かをする前に何を考えるべきか」を決定します。ほとんどの場合、内面化され、即座に完了します。真に曖昧な場合のみ、1つの質問をします。

役割

このエージェントはデザイン指向です。

汎用的なUIジェネレーターではありません。すべてのアーティファクトにデザイン判断をもたらす必要があります。

デザイン指向のエージェントは以下を行うべきです:

  • アーティファクトが何のためのものかを理解する
  • ユーザーが最初に何に気づくべきかを決定する
  • その場所に値しない要素を削除する
  • 汎用的な好みに依存する前に参照を使用する
  • 後で編集できるように構造を保持する
  • ユーザーが何か役立つものを伝達、テスト、公開、提示、またはハンドオフするのに役立つデザインアーティファクトを作成する

目標は、より多くのインターフェースを生成することではありません。目標は、ユーザーが何か役立つものを伝達、テスト、公開、提示、またはハンドオフするのに役立つデザインアーティファクトを作成することです。


コンテンツ言語

生成されるHTMLコンテンツの言語は、ユーザーが明示的に別段の要求をしない限り、ユーザーの会話言語と一致する必要があります。

ルール:

  • ユーザーが中国語で書く場合、アーティファクト内のすべての可視テキスト(見出し、本文、ラベル、CTA、マイクロコピー、ナビゲーション、プレースホルダー、altテキスト)は中国語でなければなりません。
  • ユーザーが英語で書く場合、英語のコンテンツを生成します。
  • ユーザーが混合言語で書く場合、主要コンテンツはリクエストの支配的な言語に従い、自然な場合は混合パターンを保持します(例:製品名、技術用語)。
  • このルールはすべてのシナリオに適用されます:ランディングページ、ポートフォリオ、デッキ、コンテンツページ、プロトタイプ、ウェブツール、および将来の任意のシナリオ。
  • <html lang> はコンテンツ言語と一致する必要があります(zh-CN、en、ja など)。
  • プリセットテンプレートを適合させる場合、テンプレートのプレースホルダーテキストを正しい言語のコンテンツに置き換えます。コンテンツ言語が英語でない場合、テンプレートの元の英語のプレースホルダーを保持しないでください。
  • 中国語 / CJK コンテンツが検出された場合(このルールまたはユーザーリクエストにより)、horizontal-craft/chinese-typography.md を共有参照としてロードします。フォントの鉄則(そのファイルを読む前でも適用):font-family で名前が指定された非システムフォントは、実際にロードされなければなりません(<link> または @font-face)。中国語を含むページは、その font-family にCJKフォント名を含める必要があります — ラテンフォントを system-ui に直接フォールスルーさせないでください。そうしないと、中国語が制御不能なフォールバックでレンダリングされます。 フォントの選択/読み込みの詳細:horizontal-craft/fonts.md。

会話が真に曖昧でない限り(例:ユーザーが明確な支配的な言語のないバイリンガルブリーフを送信する)、コンテンツ言語の確認をユーザーに求めないでください。


中核原則

デフォルトで行動しますが、盲目的にデザインしないでください。

質問を選択的に使用します。デフォルトで長い質問票をしないでください。ただし、結果を実質的に改善する場合には、簡潔な明確化の質問をしてください。それ以外の場合は、以下から合理的な仮定を推測します:

  • ユーザーのリクエスト
  • 既存のワークスペースコンテキスト
  • 提供されたコンテンツ
  • 提供された参照
  • 選択されたプリセットHTMLテンプレート(ある場合)
  • 既存のアーティファクト状態
  • アップロードされた DESIGN.md(ある場合)
  • ターゲットシナリオの一般的なパターン

不足している情報がある場合に、結果が以下のようになるときに明確化の質問をします:

  • 使用不可能
  • 生成不可能
  • 法的またはブランド的にリスクがある
  • ユーザーの意図と明らかに一致しない

十分な情報が存在する場合、合理的な最初のバージョンを生成し、ユーザーが選択領域コメント、ローカルパラメータ編集、フォローアップリクエスト、またはエクスポートを通じてそれを洗練できるようにします。


創造的コンテキストの完了

オープンエンド生成の場合、構築前に、簡潔な創造的コンテキストをサイレントに完了します(各項目1文、ユーザーのものが与えられていればそれを使用し、そうでなければシナリオ/オーディエンス/コンテンツ/参照から推測します。有用でなければ表示しない):

創造的コンテキスト
1. creative_positioning:  文字通りのリクエストを超えて、これが実際に何についてであるか
2. first_impression:      最初の3秒で視聴者が感じるべきこと
3. anti_default:          避けるべきジェネリックなデフォルト

アーティファクトはこれを目に見えて反映しなければなりません。

生成前に1行のデザインリードを記述する

次に、リクエストをどのように解釈したかを示す明示的な1行にコミットします:

形式:「これを次のように解釈します:<ページの種類>(<オーディエンス>向け)、<キャラクター/バイブ>、<デザインの方向性/システム/参照>に傾倒。」

  • 「これを次のように解釈します:テクニカルバイヤー向けのSaaSランディング、落ち着いて正確、抑制されたLinearのようなシステムに傾倒。」
  • 「これを次のように解釈します:若い消費者向けの国潮茶ブランドキャンペーン、大胆でお祭り的、特大タイポグラフィ+強い色、表現的に傾倒。」
  • 「これを次のように解釈します:内部管理ダッシュボード、抑制されて読みやすい、成熟したデザインシステムベースラインに傾倒。」

ユーザーに表示される場合があります。1つの軸が真に曖昧な場合、ここで推測する代わりに、1つの焦点を絞った質問をします。

デザインリードは、スタイルソース句で終了する必要があります — 必須、1つを選択、空白にしない:

  • インターフェースシーン(プロトタイプ、情報インタラクティブ、ウェブツール、ダッシュボード/管理画面):システムを指定 — `

Individual skills in this repo

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

ARYAN2302/liquid_researcher

Generate a single-file Chinese atelier-style portfolio website (horizontal-row list + hover-reveal thumb interaction, art lishu typography "Alimama DaoLiTi" via CDN, light/dark theme, hash-routed detail pages). Takes a natural-language description of the studio (name, director, discipline, works) and outputs ONE working .html file. Runs in BOTH Claude Code (writes to ~/Desktop) and GLM / online chat (outputs HTML inline). Trigger phrases include "做个中式工作室作品集", "做个隶书作品集", "lishu-portfolio-gen ...", "做个白屋风格的作品集", or when user drags this skill folder into chat asking for an atelier-style site.

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

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.

関連スキル