Communitygithub.com

direcao-visual

プロジェクトごとにビジュアルコンセプト、配色、タイポグラフィ、動きを定義します。あらゆるウェブサイト、ランディングページ、スライドの構築前に呼び出し、3方向の比較案を提示し、ルールとアンチAIリストに基づいて完成ページをレビューします。

direcao-visual とは?

**/direcao-visual** は、AIエージェント向けのアートディレクションスキルです。このスキルは、Claude Code、Cline、Cursor、GitHub Copilot、Codex CLI など、SKILL.md をサポートするすべてのプラットフォームで使用できます。 **なぜ必要か** AIが方向性なしに生成するデザインは、やや退屈で平均的なものになりがちです。このスキルは、プロジェクトごとに固有のビジュアルコンセプトを定義するプロセスを強制します。色、フォント、動きは毎回変わりますが、その決定を導くルールは変わりません。 **どのように機能するか** このスキルは、まずプロジェクトの約束、コピー、構造が固まっていることを確認します。次に、物理的なリファレンス(ウェブサイトではなく)に基づいた概念を定義します。そして、3方向の比較用HTMLを生成し、ユーザーが選択します。選択後は、すべてのトークン、タイポグラフィ、リズム、動き、禁止事項を詳細に記した `DIRECAO.md` 方向性シートを作成します。構築は用意された CSS/JS コードベース(`codigo/` ディレクトリ)から始まり、最後に固定ルールとアンチAIリストに対する厳格なレビューが行われます。 **提供されるもの** - 3段階の納品レベル(ベース、シグネチャー、シネマティック) - パフォーマンス目標(モバイルPageSpeed 90以上、LCP 2.5秒未満) - ストーリーボードとユーザージャーニーの測定 - モバイルファーストのCSSフレームワークとビルド済みモーションエフェクト - アンチAIチェックリスト このスキルは、ビジュアルを約束の増幅器として捉え、見た目の装飾に過ぎないものとは明確に区別します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/arthurmkt/arthur-portfolio-mkt/tree/main/design/direcao-visual

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

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

ドキュメント

/direcao-visual: アートディレクター

なぜ存在するのか

AIが方向性なしに生成するものは、これまで見てきたものすべての平均です。Interフォント、紫色のグラデーション、3つのカードとアイコン、すべて中央揃え。成功するサイトは、すべての決定が選択的に行われたから成功します。見出し、カード、タイポグラフィは、決定する前にバージョンを並べてテストされています。

このスキルはそれをプロセスに変えます。色はプロジェクトごとに変わります。ルールは変わりません。

このスキルのファイル(段階に応じて読むこと)

ファイル読むタイミング
referencias/regras-fixas.md常に。プロジェクト間で変わらないルール
referencias/anti-ia.md何か(ビジュアルとテキスト)を納品する前に
referencias/futurista.mdリクエストがインパクト、テクノロジー、または「何か違うもの」を求めている場合、または選択した方向性に強い動きがある場合
codigo/movimento-base.css + .jsすぐに使えるモーションベース(単語ごとの表示、カスケード、マーキー、グロー、WebGL背景)。色を変更して再利用
codigo/base-estrutura.cssレベル1の完全な構造: トークン、ボタン、ナビ、証明付きヒーロー、数字、カード、「一般的×私たち」の比較、柱、タイムライン、創業者、フォーム、FAQ、カラーブロックフッター。ルートのみ変更。クラス名は上部コメントにリストされています。それらを使ってHTMLを構築します。フォントパスは /fonte.woff2 を指しています。プロジェクトのフォントをルートに配置するか、パスを変更してください
codigo/base-serifada.cssセリフ体+サンセリフ体のリファレンス、ウォームトーンのネームドパレット、モバイルカラム
codigo/rolagem-ancora.js固定時間でアンカーまでスクロール、バーの下で停止
codigo/rolagem-cinematografica.htmlレベル3のテンプレート: スクロールで制御されるフレームシーケンス
referencias/celular-e-tecnica.mdレベル2/3を構築する前、およびモバイルでレビューする前に。 モバイルでの構成、可読性、ボタン、読み込み、サウンド、ジェスチャー、診断、公開
codigo/teste-celular.mjs任意のサイズ(モバイル/デスクトップ)でページのスクリーンショットを撮り、横スクロールとエラーを警告し、--lento で4Gをシミュレート、ディスクにゴミを残しません。Node 18+ と Chrome が必要です(Linux/Windowsでは CHROME_PATH を設定)

階層: 約束がビジュアルに優先する

高度なビジュアルは増幅器です。強い約束を必然的に見せますが、弱い約束を救うことはできません。約束が曖昧なシネマティックサイトは、ただのきれいな動画です。

決して逆転しない順序:

  1. 約束: 人が得るもの、期間、数字。
  2. コピーと例外: 誰のためか、誰のためでないか(「こんなあなたには向いていません…」)、反論への回答、理由のあるルール。
  3. 構造: ブロックの順序。
  4. ビジュアルと動き: このスキル。

実践的に: 約束とコピーが存在しないか曖昧な場合、このスキルは停止し、 3方向を提示する前にそれらを求めます。レベル3では、ジャーニースクリプトの各シーンは約束の一部を伝えます: シーンは装飾のためではなく、何かを証明するために存在します。


納品レベル

レベル1が下限です。 いかなるプロジェクトもこれ以下にはなりません。プロジェクト間で再利用されるのはエンジニアリングであり、見た目ではありません:

  • モバイルとデスクトップでの体験
  • 解決されたタイポグラフィ
  • 少数でよくできたセクション
  • 出口クリックポイント(適切な場所のボタンとWhatsApp)
  • あらゆるモバイルでの品質

色、画像、アイデンティティはプロジェクトごとに変わります。クライアントの支払いによって追加されるものが決まり、追加投資はジャーニーに向かいます: シーンごとに物語として語られるページ。

レベル1・ベースレベル2・シグネチャーレベル3・シネマティック
対象あらゆるプロジェクト(広告LPを含む)地域の競合他社と差別化したい場合美しい物理的製品と、差別化に価値を置くクライアント
ディレクションcodigo/base-estrutura.css + movimento-base 上のプロジェクトトークン; 1提案3方向の比較 + ディレクションシート3方向 + ジャーニースクリプト(下記参照)
タイポグラフィ1ファミリー内のウェイトコントラスト(300/800)コンセプトに合わせて選ばれたペア(ディスプレイ + テキスト)選ばれたペア + 見出しのキネティックタイポグラフィ
動きcodigo/movimento-base すべて: 単語ごとの表示、カスケード、マーキー、グロー、WebGL背景ベース + 1つのオーダーメイドシグネチャーエフェクト(画像歪み、ループ動画、ページ間遷移)スクロールで制御される画像シーケンス(codigo/rolagem-cinematografica.html)、1~3シーン、固定セクション(GSAP)
画像クライアントの写真(独自処理)ディレクション付きの撮影または生成画像スタジオで生成または撮影されたオブジェクト + AI動画→フレーム
ページ数1(LP)最大約5ページ、ページ間遷移ありメインのショーケース + レベル2のサポートページ
常にフォーム、トラッキング(GTM、リードウェブフック)、LGPD、少ない動き、360px同左同左 + 専用モバイルバージョンと重量予算

各レベルは前のレベルを含みます。このスキルは価格を提案しません。

ジャーニースクリプト(レベル3、および該当する場合はレベル2)

画像や動画を生成する前に、ページをストーリーボードとして書きます: 各シーン = 表示内容 + 読む内容 + 感じる内容。4シーンのモデル:

  1. 到着: 製品が全体表示。2~5単語の見出し。
  2. 詳細: オブジェクトが開き、回転し、または組み立てられ、誰も見たことのないもの(成分、メカニズム、仕上げ)を見せる。
  3. 証明: 数字、実際のクライアント、プロセス。
  4. 行動喚起: オブジェクトが全体に戻り、ボタンが表示される。

動画はスクリプトから生成され、その逆ではありません。どんなに美しくても、ストーリーに貢献しないシーンはカットされます。

画面時間は手段であり、目的ではありません。 ジャーニーは、人が約束を理解し信じるまで引き留めます。目標はコンバージョン(より安い販売)であり、ページ上の分数ではありません。すべてのシーンはボタンへの可視パスで終わります。広告LPでは、ボタンはシーン1ですでに表示され、消えません。

品質目標(レベル3、およびレベル1/2も)

指標目標測定方法
モバイル PageSpeed≥ 90pagespeed.web.dev、3回実行
LCP(ヒーローが表示)< 2.5 秒(4G)同じレポート
CLS(レイアウトシフトなし)< 0.1同左
INP(タップ応答性)< 200 ミリ秒同左
スクロールのカクつきなし60fps実機iPhone(Safari)+ 低価格Android実機、シミュレーターだけでなく

ジャーニーの測定(改善点を示すもの)

  • シーンごとのイベントをGA4/GTMに(cena_1_vista … cena_4_vista)+ シーンごとのボタンクリック: どのシーンで人が離脱するかを示します。
  • Microsoft Clarity(無料): セッション録画とスクロールマップ。変更のたびにモバイル録画を20件確認。
  • 一度に一つずつ変更し、コンバージョン率とCPLを同じ前年度期間と比較します。ページ上の時間だけを決して比較しないでください。

プロセス

1. 描く前に理解する(不足分だけを一度のメッセージで質問する)

  • 納品レベル: 1、2、または3。誰も言わなければ、1。
  • 何か: サイト、LP、スライド、制作物。どこで見られるか(広告のモバイル、会議画面、印刷物)。
  • 誰に向けて、見た後に何をすべきか。
  • ブランド: 既存のロゴ、色、フォント。ブリーフィング、クライアント資料、または承認済みコピーがあれば、事前に読んでください。
  • 何に見えてはいけないか。 これが最も決定的な質問であることがよくあります。

2. コンセプト(色の前に)

3行で書く:

  • 制作物が何であるかを一文で。 例: 宗教的なオーディエンス向けの出会い系アプリの場合:「信じる者同士の真剣な交際。教会のような慎み深さ、アプリのような軽薄さはありません。」
  • 異なる方向に引っ張る3つの形容詞(例: 温かい・落ち着いた・親密)。
  • インターネット以外の物理的なリファレンス 一つ。パレットとテクスチャを引き出すため: 金とワインの古い聖書の紙。オレンジの灯りが一つのコンサルティング会社の夜のオフィス。

「他のサイト」をリファレンスにするとコピーになります。物理的なリファレンスはアイデンティティになります。

3. 3方向の比較

単一の比較用HTML(プロジェクトフォルダ内の direcoes.html)を、3方向をカラムまたはブロックで生成します。それぞれが同じ実際のコンテンツを、ダミーテキストなしで表示します:

  • 上部(見出し + サブ見出し + ボタン)
  • 証明または数字のセクション
  • 動くシグネチャー

3つは本当に異なるものでなければなりません: フォントファミリー、色温度、密度を変更するだけでなく、アクセントの色合いだけ変えるのではありません。そのうちの一つは最も大胆なものにすることができます(futurista.md を参照)。

それぞれの下に3行: それが伝えるもの、そのリスク、そしてそれが効果を発揮した場所。

ブラウザで開く(またはArtifactとして公開する)か、ユーザーが選択します。選択なしで進めないでください。 混在(「1のフォントと3の色」)も有効な回答です。

4. ディレクションシート(プロジェクトフォルダ内の DIRECAO.md)

選択後、構築が従うシートを書きます。1ページ:

CONCEITO        フレーズ + 3つの形容詞 + 物理的なリファレンス
CORES           ストーリーを語る名前の付いたトークン(tinta, brasa, marfim, ouro...)
                背景 · 浮上 · 表面 · テキスト100/72/46 · 線 · アクセント · アクセント-明背景用
TIPOGRAFIA      ディスプレイ + テキスト(最大2ファミリー) · 最大ウェイト · clamp()を使用したスケール
RITMO           最大幅 · セクション間の間隔 · セクション背景の順序
IMAGEM          ヒーローとは(製品/実在人物) · 処理(例: 白黒 + カラーベール)
MOVIMENTO       1つのシグネチャー + 最大2つのサポート · イージング · 持続時間
PROIBIDO        この制作物がしない5つのこと

5. シートに従って構築する

  • 動きが同じ語彙である場合は codigo/ を出発点とし、再発明しない。
  • シートの名前を使用して ルート にトークンを設定。CSSの途中に色をばらまかない。
  • 実際のコンテンツ、各ブロックの理由を添えて: エグゼクティブだが、決して不透明ではない。

6. 納品前にレビューする

  1. referencias/anti-ia.md を項目ごとに確認。指摘するだけでなく、修正する。
  2. regras-fixas.md の技術チェック(「納品前に」セクション): 360px幅、コントラスト、少ない動き、フォント、ページ重量。
  3. ページが動作しているのを見る(ブラウザ/スクリーンショット)、コードだけでない。モバイルで最後までスクロール。codigo/teste-celular.mjs を使用して 393×852 と 375×667 でスクリーンショット。すべてのパーツを並べたシートを送信前に確認。
  4. パーツごとに表示、一度に一つのスクリーンショット、ページの順序で、それぞれの承認を待つ。最後に、承認者のモバイルでテスト(Wi-Fi + QR)または公開リンク。
  5. 各項目を変更するためのどのファイル/トークンを操作するかを伝えて納品。プログラミングしない人のことを考える。

レビューモード

完成したページが送られてきた場合(「このサイトをレビューして」): ステップ6にジャンプし、インパクトの順にルールとアンチAIリストに違反している箇所をリストアップし、それぞれの修正を提案します。依頼なしにページ全体を書き直さないでください。

スライド

同じシートを適応: 1スライド = 1つのアイデア。タイトルは結論であり、主題ではない(「LP変更でCPLが38%低下」であり、「結果」ではない)。可能であれば、表の代わりに大きな数字。スライドあたり最大1つのグラフ。形式としては、可能な場合はArtifactのスライドタイプを優先。.pptx はファイルが要求された場合のみ使用。

黄金律

制作物ごとに、一つの強力な決定。 あるサイトは背景が流れ、別のサイトはアプリの実際のカードが上部にある。すべてを同時に印象づけようとするものは、テンプレートのように見えます。

Individual skills in this repo

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

関連スキル