Communitygithub.com

MikeCheng1208/BattleTree

ミニマリズムとタイポグラフィに重点を置いたポートフォリオデザインシステム。ネオ・ブルータリズムとスイスデザインの原則に基づき、大胆なタイポグラフィ、余白、モノクロームカラースキームで開発者やデザイナーのポートフォリオをエレガントに演出します。

BattleTree とは?

このスキルは、ミニマリストデザインに基づくポートフォリオウェブサイトの作成をガイドします。タイポグラフィを主役とし、不要な装飾を排除したラジカルシンプリシティを追求します。黒、白、グレーのモノクロームパレットと8ptグリッドシステムを採用し、視覚的な階層とプロフェッショナルなプレゼンテーションを実現します。任意のアクセントカラー(例: テックブルー)を最小限で使用することで、CTAなどの重要な要素を強調できますが、純粋なモノクロームアプローチが最も推奨されます。このスキルは、個人のポートフォリオサイトを構築するすべての開発者やデザイナーに適しており、Claude Code、Coder、CursorなどのAIエージェントと連携して、デザインの一貫性を保ちながら迅速に実装できます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/MikeCheng1208/BattleTree/tree/HEAD/.agents/skills/minimalist-portfolio-design

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

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

ドキュメント

ミニマリストポートフォリオデザインスキル

このスキルは、ミニマリストな美学を持つ、クリーンでタイポグラフィに重点を置いたポートフォリオウェブサイトの作成をガイドします。ネオ・ブルータリズムとスイスデザインの原則に基づき、このアプローチは読みやすさ、視覚的階層、装飾要素よりもプロフェッショナルな表現を優先します。

コアデザイン哲学

デザイン原則:

  • タイポグラフィを主役に: 文字に最も重要な役割を任せる
  • ラジカルシンプリシティ: 必須でないものはすべて削除する
  • たっぷりとした余白: スペースはデザイン要素であり、空白ではない
  • モノクロームパレット: 黒、白、そしてグレーの階調
  • グリッドベースの精度: すべてが不可視のグリッドに整列する
  • 装飾なし: 形態は機能に従う
  • スイスデザインの影響: クリーンで非対称なレイアウトと明確な階層

このスタイルが「ある」もの:

  • 大胆で、自信に満ち、プロフェッショナル
  • クリーンで雑然としていない
  • タイポグラフィ駆動
  • 時代を超越し、エレガント
  • スキャンしやすく、ナビゲートしやすい

このスタイルが「ない」もの:

  • カラフルまたは遊び心がある(明るい色は使わない)
  • アニメーションが豊富(控えめなインタラクションのみ)
  • 散らかっていたり、ごちゃごちゃしている
  • 装飾的または装飾過多
  • 流行に左右されやすい

タイポグラフィシステム

フォントの選択

プライマリタイプフェースオプション(ネオ・グロテスク/ジオメトリックサンセリフ):

  1. Aeonik(リファレンスに示されている通り)- ネオ・グロテスク、幾何学的、モダン
  2. Inter - 汎用性が高く、画面での読みやすさに優れ、無料
  3. Satoshi - 幾何学的、クリーン、現代的な印象
  4. Supreme - ボールド、幾何学的、大きなディスプレイテキストに最適
  5. Space Grotesk - 個性のあるモダンな幾何学書体
  6. Neue Montreal - スイスにインスパイアされた、クリーンなライン
  7. General Sans - バランスが良く、プロフェッショナルで汎用性が高い

システムフォントスタック(フォールバック):

font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Roboto', 'Oxygen', 'Ubuntu', 'Cantarell', sans-serif;

タイプスケールと階層

ディスプレイ/ヒーローテキスト(「Hello」のような大きな挨拶):

  • デスクトップ: 8rem-12rem (128px-192px)
  • タブレット: 6rem-8rem (96px-128px)
  • モバイル: 4rem-6rem (64px-96px)
  • ウェイト: 400-500(レギュラーからミディアム)
  • 行の高さ: 0.9-1.0(タイト)
  • 文字間隔: -0.02em から -0.04em(タイト)

セクションヘッダー(「Colors」「Typography」など):

  • デスクトップ: 4rem-6rem (64px-96px)
  • タブレット: 3rem-4rem (48px-64px)
  • モバイル: 2.5rem-3rem (40px-48px)
  • ウェイト: 400-500
  • 行の高さ: 1.1
  • 文字間隔: -0.02em

サブ見出し/ラベル(「Primary」「Secondary」など):

  • サイズ: 1.25rem-1.5rem (20px-24px)
  • ウェイト: 400-500
  • 行の高さ: 1.4
  • 文字間隔: 0

本文テキスト(「Colors」の下の説明など):

  • サイズ: 1rem-1.125rem (16px-18px)
  • ウェイト: 400
  • 行の高さ: 1.6-1.7
  • 文字間隔: 0
  • 最大幅: 65ch(文字数)で読みやすく

小さなテキスト/ラベル(「Scroll down ↓」など):

  • サイズ: 0.875rem-1rem (14px-16px)
  • ウェイト: 400
  • 行の高さ: 1.5
  • 文字間隔: 0.01em

ナビゲーションリンク:

  • サイズ: 1rem-1.125rem (16px-18px)
  • ウェイト: 400-500
  • 文字間隔: 0

タイポグラフィのルール

  • 1つのフォントファミリーをサイト全体で使用する(多様性よりも一貫性)
  • 階層を作成するにはフォントのウェイトを使用し、複数のフォントは使わない
  • 大きなディスプレイテキストにはタイトな文字間隔
  • 本文テキストには標準的な文字間隔
  • 読みやすい本文テキストには余裕のある行の高さ(1.6-1.7)
  • ディスプレイテキストにはタイトな行の高さ(0.9-1.1)
  • 左揃えのテキスト(中央揃えは特定のヒーロー要素を除いて使用しない)
  • 本文テキストではオールキャップスは使用しない(小さなラベルに必要な場合のみ)

カラーシステム

モノクロームパレット(主要アプローチ)

これがコアとなる美学です - 黒、白、グレーのみ。

カラーパレット:

--color-black: #222222;        /* プライマリ - リッチブラック、純粋な黒ではない */
--color-gray-dark: #7B7B7B;    /* セカンダリ - ミディアムグレー */
--color-gray-light: #F8F8F8;   /* ターシャリ - オフホワイトの背景 */
--color-white: #FFFFFF;        /* ピュアホワイト */
--color-gray-50: #FAFAFA;      /* 最も薄いグレー */
--color-gray-100: #F5F5F5;     /* 非常に薄いグレー */
--color-gray-200: #EEEEEE;     /* 薄いグレー */
--color-gray-300: #E0E0E0;     /* ボーダーグレー */
--color-gray-400: #BDBDBD;     /* 無効状態 */
--color-gray-500: #9E9E9E;     /* ミッドグレー */
--color-gray-600: #757575;     /* テキストグレー */
--color-gray-700: #616161;     /* ダークテキストグレー */
--color-gray-800: #424242;     /* ほぼ黒 */
--color-gray-900: #212121;     /* 最も濃いグレー */

カラーの使用法:

  • 背景: #F8F8F8 または #FFFFFF(ライトモード)/ #0A0A0A(ダークモード)
  • テキストプライマリ: #222222(ライトモード)/ #F8F8F8(ダークモード)
  • テキストセカンダリ: #7B7B7B(両方のモード)
  • ボーダー: #E0E0E0(ライトモード)/ #2A2A2A(ダークモード)
  • カード/サーフェス: #FFFFFF(ライトモード)/ #1A1A1A(ダークモード)
  • ホバー状態: わずかに暗く/明るくする(10-15%の不透明度変化)

アクセントカラーオプション(最小限の使用)

絶対に必要な場合のみ - 1つのアクセントカラーを控えめに使用する:

  • CTAのみに(「Book A Call」ボタン)
  • キー要素のホバー状態に
  • アクティブリンクインジケーターに
  • 決して背景や広い領域には使用しない

推奨アクセントカラー(1つを選択):

  • テックブルー: #0066FF(IBMブルー、プロフェッショナル)
  • サクセスグリーン: #00B386(控えめで信頼性が高い)
  • ウォームレッド: #FF3B30(Appleレッド、注意を引く)
  • 黒をキープ: アクセントカラーなし(最もピュアなアプローチ)

カラー適用ルール

  1. ライトモードデフォルト: 白/オフホワイトの背景(#F8F8F8 から #FFFFFF)
  2. ダークモードオプション: ダークグレー/黒の背景(#0A0A0A から #121212)
  3. テキストコントラスト: 本文テキストは最低4.5:1、大きなテキストは3:1
  4. グラデーションなし: ソリッドカラーのみ
  5. シャドウなし(または非常に控えめな1-2pxシャドウ): 代わりにボーダーを使用する
  6. ホバー状態: 不透明度の変更(0.7-0.8)または背景色のシフト
  7. 写真: 白黒または彩度を下げる(リファレンスのポートレートのように)

ダークモードの考慮事項

ダークモードを実装する場合:

  • 背景: #0A0A0A から #121212(純粋な黒ではない)
  • サーフェス: #1A1A1A から #222222
  • テキスト: #F8F8F8 から #FFFFFF
  • ボーダー: #2A2A2A から #333333
  • 同じモノクロームアプローチを維持する
  • ピュアホワイトをピュアブラックの上に置くのは避ける(目の疲れの原因になる)

レイアウトとスペーシングシステム

グリッドシステム

コンテナ幅:

  • 最大コンテンツ幅: 1440px-1600px
  • コンテンツパディング: 5-10% 左右(レスポンシブ)
  • モバイルパディング: 24px-32px 左右

グリッド構造:

  • 柔軟性のための12カラムグリッド
  • ヒーロー用: 非対称の60/40または50/50分割(テキスト/画像)
  • 余裕のあるガター: 32px-48px カラム間

スペーシングスケール(8ptグリッド)

すべてのスペーシングは8の倍数:

4px (0.25rem)   - 最小ギャップ
8px (0.5rem)    - タイトなスペーシング
16px (1rem)     - 小さなスペーシング
24px (1.5rem)   - ミディアムスペーシング
32px (2rem)     - 標準スペーシング
48px (3rem)     - 大きなスペーシング
64px (4rem)     - XLスペーシング
96px (6rem)     - セクションスペーシング(モバイル)
128px (8rem)    - セクションスペーシング(タブレット)
160px (10rem)   - セクションスペーシング(デスクトップ)
192px (12rem)   - ヒーロースペーシング

垂直リズム

セクション間:

  • モバイル: 96px-128px
  • タブレット: 128px-160px
  • デスクトップ: 160px-192px

セクション内:

  • 見出しとコンテンツの間: 32px-48px
  • 段落間: 24px-32px
  • リストアイテム間: 16px-24px

コンポーネントスペーシング:

  • ナビゲーションパディング: 上下24px-32px
  • カードパディング: 内部32px-48px
  • ボタンパディング: 左右16px-32px、上下12px-16px

レスポンシブブレークポイント

/* モバイルファーストアプローチ */
mobile: 320px-640px
tablet: 641px-1024px
desktop: 1025px-1440px
xl: 1441px+

/* Tailwind 同等 */
sm: 640px
md: 768px
lg: 1024px
xl: 1280px
2xl: 1536px

ポートフォリオのレイアウトパターン

ヒーローセクション(全ビューポート)

レイアウト: 50/50分割(左にテキスト、右に画像)
高さ: 100vh(全ビューポート高)
垂直方向の配置: 中央

左側:
- 大きな挨拶テキスト: "Hello"
- サブタイトル: "— [Name]です。[役割]です"
- 統計(オプション): "+200 プロジェクト完了"
- スクロールインジケーター: "Scroll down ↓"
- 縦書きテキスト(オプション): "Product designer"

右側:
- 大きなポートレート写真
- 白黒または彩度を下げたもの
- プロフェッショナルで自信に満ちたポーズ
- 背景なし(または微妙なグラデーション)

ナビゲーション:

  • 位置: 絶対配置上部または固定上部
  • 高さ: 80px-100px
  • ロゴ: 左上(端から24px-32px)
  • リンク: 上部中央または右
  • CTA: 右上(「Book A Call」と矢印)
  • 背景: 透明、またはスクロール時に微妙な backdrop-blur
  • ボーダー: なし、または下部に1pxボーダー(#E0E0E0)

アバウト/情報セクション

レイアウト: シングルカラム、中央寄せコンテンツ
最大幅: 800px-900px(読みやすさのため)
見出し: 左揃え、大きめ
本文: 左揃え、快適な行長

ポートフォリオグリッド

デスクトップ: 3カラム
タブレット: 2カラム
モバイル: 1カラム
ギャップ: 32px-48px
カードアスペクト比: 4:3または16:9

余白の哲学

スペースが多いほど = よりプレミアムに

  • 空のスペースはデザイン要素である
  • すべてのピクセルを埋め尽くさない
  • コンテンツに呼吸するスペースを与える
  • 余白を使って視線を誘導する
  • バランスが鍵: まばらすぎず、混雑しすぎず

余白チェックリスト:

  • すべての要素の周りに呼吸するスペースはありますか?
  • 視線がセクションを簡単に識別できますか?
  • レイアウトは落ち着いていて、整理されているように見えますか?
  • 関連するアイテムは、より少ないスペースでグループ化されていますか?
  • 関連のないアイテムは、より多くのスペースで区切られていますか?

コンポーネントデザインパターン

ナビゲーションバー

構造:

[ロゴ]                    [About Me] [Portfolio] [Services] [Blog]                    [Book A Call →]

仕様:

  • 高さ: 80px-100px
  • 位置: backdrop-filter blur 付きで上部固定、または絶対配置
  • 背景: 透明 → スクロール時に半透明
  • ロゴ: シンプルなワードマークまたはアイコン(24px-32pxサイズ)
  • リンク: 16px-18px、ミディアムウェイト
  • リンク間隔: 32px-48px
  • CTAボタン: アウトラインまたは塗りつぶし、右揃え
  • ホバー: 不透明度0.7または控えめな下線(1-2px)

モバイルナビゲーション:

  • ハンバーガーメニュー: シンプルな3線アイコン(24px)
  • メニュー: 全画面オーバーレイまたはスライドインメニュー
  • リンク: より大きなテキスト(24px-32px)、縦積み
  • アニメーション: スムーズ、200-300ms、イーズ

ボタン

プライマリボタン(CTA):

上下14px-16px、左右28px-32pxのパディング
border-radius: 4px-8px(控えめ、ピル型ではない)
font-size: 16px-18px
font-weight: 500
background: #222222(またはアクセントカラー)
color: #FFFFFF
border: none または 1-2px ソリッド
hover: opacity: 0.9 または transform: translateY(-2px)

セカンダリボタン:

プライマリと同じサイズ
background: transparent
color: #222222
border: 1-2px ソリッド #222222
hover: background: #222222, color: #FFFFFF

テキストリンク:

背景なし、ボーダーなし
下線: 1px ソリッド(ホバー時のみ)または常時表示
ホバー: opacity: 0.7

カード(プロジェクトカード)

構造:

┌──────────────────────────┐
│                          │
│      プロジェクト画像    │
│      (16:9比率)         │
│                          │
├──────────────────────────┤
│  プロジェクトタイトル    │
│  短い説明...             │
│  [タグ] [タグ] [タグ]    │
└──────────────────────────┘

仕様:

  • 背景: #FFFFFF または #FAFAFA
  • ボーダー: 1px ソリッド #E0E0E0 または控えめなシャドウ
  • ボーダーラジアス: 8px-12px(控えめ)
  • パディング: 0(画像は端から端まで)+ 下部24px-32px
  • 画像: 幅いっぱい、固定アスペクト比
  • ホバー: Scale 1.02 またはシャドウでリフト、またはボーダーカラー変更
  • トランジション: 200-300ms、イーズ

カードコンテンツ:

  • タイトル: 20px-24px、ミディアムウェイト
  • 説明: 16px、レギュラー、最大2-3行
  • タグ: 12px-14px、パディング6px-12px、rounded-full、ボーダー1px

統計表示(「+200 プロジェクト完了」)

スタイル:

数字: 3rem-4rem (48px-64px)、ミディアムウェイト
ラベル: 1rem (16px)、レギュラーウェイト、グレーカラー
レイアウト: 縦積み
スペーシング: 数字とラベルの間は8px

配置:

  • ヒーローテキストの近く
  • 控えめに、メインメッセージと競合しない
  • 複数の統計を横並びにできる(32px-48pxのギャップ)

写真/画像

ポートレート写真(ヒーロー):

  • 白黒または大幅に彩度を下げる
  • プロフェッショナルで、まっすぐな視線
  • クリーンな背景(ソリッドカラーまたは微妙なグラデーション)
  • 高品質: シャープで、適切な照明
  • アスペクト比: ポートレート(3:4)またはスクエア(1:1)
  • サイズ: 大きく、ビューポートの40-50%を占める

プロジェクト画像:

  • 高品質: モックアップまたはスクリーンショット
  • すべてのプロジェクトで一貫したアスペクト比
  • 考慮事項: 16:9(横長)または4:3
  • ホバー: わずかなズーム(scale 1.05)または効果なし
  • Altテキスト: アクセシビリティのため常に含める

アイコン

アイコンスタイル:

  • ミニマル: ラインアイコンのみ(塗りつぶしアイコンは使用しない)
  • ストロークウェイト: 1.5px-2px
  • サイズ: 標準で20px-24px、特集で32px-40px
  • カラー: テキストカラーに合わせる(#222222 または #7B7B7B)
  • 例: 矢印(→)、メニュー(≡)、閉じる(×)、ソーシャルアイコン

アイコンの使用法:

  • ナビゲーション: ハンバーガーメニュー、CTAの矢印
  • ソーシャルリンク: GitHub、LinkedIn、Twitter/X、Email
  • 矢印: リンク、ボタン、スクロールインジケーター用
  • ミニマルに保つ: アイコンを使いすぎない

フォーム(お問い合わせフォーム)

入力フィールド:

padding: 16px
border: 1px solid #E0E0E0
border-radius: 4px-8px
background: #FFFFFF or #FAFAFA
font-size: 16px
focus: border-color: #222222, outline: none

ラベル:

font-size: 14px-16px
font-weight: 500
margin-bottom: 8px
color: #222222

レイアウト:

  • シングルカラム、全幅
  • フィールド: 名前、メール、メッセージ(最大3フィールド)
  • スペーシング: フィールド間24px
  • 送信ボタン: 全幅または右揃え

スクロールインジケーター

テキストスタイル:

"Scroll down ↓"
font-size: 14px-16px
color: #7B7B7B
position: 下部中央または下部左
animation: 控えめなバウンス(オプション)

代替案:

  • アニメーションする線/矢印
  • ホイールアニメーション付きマウスアイコン
  • 控えめでミニマルに保つ

ポートフォリオページ構造

1. ヒーローセクション(The Foldの上)

目的: 即時のインパクト、明確なアイデンティティ

コンテンツ:

  • 大きな挨拶: "Hello"(またはバリエーション)
  • 名前と役割: "— [Name]です。[役割]です"
  • 統計(オプション): "+200 プロジェクト完了" "+5000万 スタートアップ調達"
  • スクロールインジケーター: "Scroll down ↓"
  • ポートレート写真: 右側、白黒、プロフェッショナル

レイアウト:

  • 全ビューポート高(100vh)
  • 50/50分割(左にテキスト、右に写真)または60/40
  • 垂直方向に中央寄せされたコンテンツ
  • 白またはオフホワイトの背景
  • 上部のミニマリストナビゲーション

タイポグラフィ:

  • "Hello": デスクトップ10rem-12rem、モバイル6rem
  • サブタイトル: 1.25rem-1.5rem、グレーカラー(#7B7B7B)

...

[翻訳のため省略]

前提条件とセットアップ

必要なもの

  • コードエディタ: VS Code、Cursor、または任意のエディタ
  • Webフレームワーク: Next.js(推奨)、Nuxt.js、Astro、または純粋なHTML/CSS/JS
  • AIエージェント: Claude Code、Coder、またはCursor(このスキルに従うため)
  • タイプフェース: デプロイするために選択したフォントの適切なライセンス
  • 画像: 高解像度のポートレート写真とプロジェクト画像(白黒または彩度低め)

セットアップ手順

  1. プロジェクトを初期化する

    • 選択したフレームワーク(例:npx create-next-app@latest my-portfolio)を使用する
    • または、index.html を持つシンプルなフォルダから始める
  2. デザインシステムを適用する

    • このガイドからCSS変数(カラー、スペーシング、タイポグラフィ)をコピーする
    • この文書のルールに従ってレイアウトを実装する
  3. コンテンツを追加する

    • プロフィール情報、プロジェクト、経歴を挿入する
    • ヒーロー画像とプロジェクト画像を追加する(白黒または彩度低め)
  4. テストとデプロイ

    • モバイルとデスクトップのブレークポイント間でレイアウトが崩れないことを確認する
    • Vercel、Netlify、GitHub Pages、または任意のホストにデプロイする

このスキルは、ネオ・ブルータリズムとスイスデザインの原則に触発されたタイポグラフィファーストのポートフォリオ体験を作成するために設計されています。個々のスタイルに合わせて自由に調整してください。

Individual skills in this repo

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

MikeCheng1208/BattleTree

Index-based file discovery using ABOUTME headers. Use INSTEAD of grep or Explore agent when searching for files by purpose or feature. Faster and more accurate than scanning code. Invoke this skill when user asks "which files handle X", "where is Y implemented", or when you need to find files related to a feature or task.

MikeCheng1208/BattleTree

Factor modeling and portfolio construction (Markowitz, Black-Litterman, constraints, turnover).

MikeCheng1208/BattleTree

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

MikeCheng1208/BattleTree

Analyze the CustomGPT.ai Labs Innovation workbook and cost tracking data to surface portfolio-level insights, trends, and recommendations for where to focus Innovation efforts.

MikeCheng1208/BattleTree

Personal meta-skill for Arach. Use this as the entry point to understand arach's projects, conventions, and available skills. Activates on "arach's projects", "what does arach work on", or when working in any arach/* repo.

MikeCheng1208/BattleTree

High-converting landing pages. Copy + design + implementation. Triggers: landing page, conversion page.

MikeCheng1208/BattleTree

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios,...

MikeCheng1208/BattleTree

Automate Klipfolio tasks via Rube MCP (Composio). Always search tools first for current schemas.

MikeCheng1208/BattleTree

Portfolio allocation and rebalancing optimizer. Manages asset allocation across stocks/cash/bonds, performs periodic rebalancing, and ensures diversification according to market regime and risk tolerance.

MikeCheng1208/BattleTree

Optimize project portfolio selection under constraints using mathematical optimization

MikeCheng1208/BattleTree

Detect and explain risk drift in lending portfolios over time using vintage analysis, migration matrices, and concentration metrics. Use when monitoring portfolio credit quality trends, preparing board risk reports, conducting stress testing, or when risk metrics deviate from appetite thresholds.

MikeCheng1208/BattleTree

Build a GitHub portfolio that gets you hired — curate 3-5 polished projects, craft compelling READMEs, deploy live demos, tell a coherent story across your repos, and align everything to AI-native development roles. Use when preparing your GitHub for job searches, deciding what to pin, or auditing your public presence.

関連スキル