Communitygithub.com

ShaysFrame/my

ShaysFrame (M. Mahafuj Rahman) のポートフォリオとブランドシステム。このスキルは、Shay の個人ポートフォリオサイト、ブログ、プロジェクトページ、履歴書ページ、または自己宣伝用のWebコンテンツを構築、デザイン、改善する際に使用します。

my とは?

このスキルは、M. Mahafuj Rahman (ShaysFrame) の個人ポートフォリオサイト(shay.pub)のための包括的なブランド&ビルドシステムを定義しています。特に、フルスタック開発者としての幅広いプロジェクト実績を、技術リストではなく、深さと範囲、そして技巧を伝えるように設計します。このスキルは、Astro(SSG)フレームワーク、TypeScript、CSSカスタムプロパティを使用して、白黒のハイコントラストなエディトリアルデザインを実現します。モーションは必然的に感じられるべきであり、装飾的ではないという哲学に従い、CSSファーストのアニメーション(ビュートランジション、スクロール駆動アニメーション)を採用し、ヒーローセクションには1つの署名モーション効果のみを許容します。QifaやOpen RTMSなどの優先プロジェクトを深く掘り下げるための構造が定義されており、直接的で自信に満ちた文章スタイルが推奨されています。このスキルは、Claude Code、Cursor、CodexなどのAIエージェントがこのサイトのコンポーネントやページを生成・改善する際のガイドラインとして機能します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ShaysFrame/my/tree/HEAD/tools/portfolio-skill

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

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

ドキュメント

M. MAHAFUJ RAHMAN のポートフォリオ — ブランド&ビルドシステム

あなたは、モバイル、ウェブ、バックエンド、IoT、MLにわたる幅広いプロジェクトをリリースしてきたフルスタック開発者、M. Mahafuj Rahman の個人ポートフォリオを構築しています。ポートフォリオは、技術を列挙するだけでなく、深さ、範囲、そして技巧を伝えなければなりません。


アイデンティティ

名前: M. MAHAFUJ RAHMAN(オンラインでは Shay として活動) GitHub: ShaysFrame サイト: shay.pub
スタックの特徴: フルスタックジェネラリスト — Flutter, Vue, Astro, React, Django, PHP, Docker, YOLO/CV
キャリア目標: 実際にリリースした仕事を証明することで、トップテック企業でのポジションを獲得する


デザイン哲学

美学: エディトリアル。ハイコントラスト。タイポグラフィ中心。瞬時に注目を集める。
ムード: クリーンでエレガント — SaaSのランディングページではなく、雑誌の表紙のように。
基本原則: すべての要素は注意を引くか、削除されるかのどちらか。

カラーパレット

--color-bg:        #0a0a0a   /* ほぼ黒の背景 */
--color-surface:   #111111   /* カード、パネル */
--color-border:    #222222   /* 微妙な区切り線 */
--color-text:      #f5f5f5   /* 主要テキスト — オフホワイト、キツい純白ではない */
--color-muted:     #777777   /* 二次/メタデータテキスト */
--color-accent:    #ffffff   /* 純白 — 最大のコントラストのために控えめに使用 */
--color-highlight: #e8e8e8   /* ホバー状態、選択された項目 */

カラーアクセントはなし。グラデーションはなし。黒、白、コントラストがすべての役割を果たします。

タイポグラフィ

  • 表示 / ヒーロー: 1つの大胆なセリフ体またはハイコントラストなグロテスク表示フォント。 推奨: Playfair Display, Editorial New, PP Neue Montreal, Instrument Serif
  • 本文 / UI: クリーンな幾何学的サンセリフ体。Inter, DM Sans, または Geist
  • コード: JetBrains Mono または Geist Mono
  • ルール: フォントウェイトは少なく、意図的なサイズ設定。階層を作成するには、色ではなくスケールを使用します。

モーションとインタラクション

哲学: モーションは必然的に感じられるべきであり、装飾的であってはなりません。すべてのアニメーションは「なぜこれが動くのか」という問いに答える — 注意を向けるため、状態を知らせるため、またはスクロールに報いるため。

レイヤー1 — CSS(常に、依存関係なし)

  • ページ遷移: Astro 組み込みの <ViewTransitions /> を使用 — JSコストゼロ
  • ホバー状態: 不透明度の変更、下線の表示、微妙なスケール(1.0 → 1.02)
  • フォーカス状態: --color-accent を使用した可視リング
  • エントランス: ファーストビューコンテンツに CSS @keyframes fadeUp

レイヤー2 — スクロール駆動アニメーション(CSSファースト)

  • ブラウザがサポートする場合はネイティブ CSS animation-timeline: scroll() を使用
  • フォールバック: 小さな .ts ユーティリティの IntersectionObserver — ライブラリ不要
  • プロジェクトカード: ビューポートに入るときに fade + translateY(24px → 0) をずらして適用
  • セクション見出し: スクロール時に左からスライドイン

レイヤー3 — ヒーローの「ワオ」要素(1つだけ、そして唯一つ)

  • ヒーローは1つの署名モーション効果を取得します。優先順位の高い順にオプション:
    1. 文字/単語のずらし表示 — ヒーロー名が1文字ずつアニメーション(CSSのみ)
    2. ノイズ/グレインオーバーレイ — 暗い背景の上にアニメーションCSSグレインテクスチャ(CSSのみ)
    3. 微妙な3D傾き — マウス移動時にプロジェクトカードがわずかに傾く(Vanilla JS、約15行)
    4. Three.js / React Three Fiber — 特定の3Dアセットが必要な場合のみ(例:回転する幾何学ロゴ)。3D-Animation-Creator または 3D-Website-Asset-Generator スキルを使用してアセットを個別に生成し、単一の独立したコンポーネントとして埋め込みます。

絶対にやってはいけないこと

  • 全ページThree.js背景(パフォーマンスを低下させ、コンテンツから注意をそらす)
  • ヒーロー以外でのループアニメーション
  • 弾むようなスプリング物理(エディトリアルな美学に合わないトーン)
  • テキストへのパララックススクロール
  • チュートリアルで使われていたからという理由だけでモーションを追加する

サイト構造

/                  → ヒーロー + 厳選されたプロジェクトティーザー + 簡単な自己紹介
/about             → Shay が誰か、背景、哲学、スキル概要
/projects          → スタックタグと短い説明付きの全プロジェクトグリッド
/projects/[slug]   → 個別プロジェクトの詳細(問題、解決策、スタック、リンク、スクリーンショット)
/resume            → インライン履歴書表示 + ダウンロード可能なPDFリンク
/blog              → ブログ記事一覧(Astroに既存)
/blog/[slug]       → 個別記事(既存)

テクノロジースタック

  • フレームワーク: Astro(SSG、Markdownファースト、デフォルトでJSゼロ、優れたSEO)
  • コンポーネント言語: Astroコンポーネント + インタラクティブアイランド用 React/Preact (.tsx)
  • 言語: すべてTypeScript — .ts, .tsx, .astro(型付きフロントマター)。.js や .jsx は使用しない
  • スタイリング: CSSカスタムプロパティ(ユーザーが明示的に要求しない限りTailwindは使用しない)
  • デプロイ: Vercel
  • コンテンツ: ブログ記事とプロジェクト用の Astro Content Collections

プロジェクト表示の優先順位

プロジェクトページを構築する際は、次の順序でこれらのプロジェクトを優先します(最も印象的なものから順):

  1. Qifa — マルチアプリエコシステム(クライアント、ショップ、オフィス、Docker、カスタムログダッシュボード、ChatWoot)
  2. Open RTMS — YOLO v8n 顔検出を使用したリアルタイムシステム(MLアングルは稀で印象的)
  3. XueHanYu — フルスタック(Vue + Django)、中国語学習プラットフォーム
  4. NoorConnect — アプリ + バックエンド + ファームウェア(IoT/組み込みはウェブ開発者には珍しい)
  5. Jidian Daojia — Flutter + PHP + uniapp、マルチプラットフォーム
  6. LittleLemon — Meta Professional Certificate キャップストーン(資格取得済みの仕事)

各プロジェクトページでは、次のようにコンテンツを構成します:

  1. 一行のフック(使用している技術ではなく、解決する問題)
  2. スタックバッジ
  3. 課題 / 何が面白かったか
  4. 行われた重要な決定
  5. リンク(GitHub、利用可能な場合はライブデモ)

文章のトーン

  • 直接的。自信に満ちている。余計な言葉は不要。
  • 適切な場合には一人称を使用(「I built...」、「I chose... because...」)
  • 避けるべき表現: 「passionate about」、「self-motivated」、「results-driven」、「leveraged synergies」
  • 漠然とした主張よりも技術的な詳細。 「worked on computer vision projects」ではなく「built a real-time face detection pipeline using YOLO v8n」と言う

コンポーネントガイドライン

このポートフォリオ用のAstroコンポーネントを生成する場合:

  • デフォルトのエクスポートスタイル: --- フロントマターを使用した .astro ファイル
  • 上記のパレットからCSSカスタムプロパティを使用
  • モバイルファーストのレスポンシブデザイン
  • セマンティックHTML(<article>, <section>, <nav>, <main> の適切な使用)
  • 動的な値を除いてインラインスタイルは使用しない
  • CSSによるアニメーション — global.css またはスコープ付き <style> ブロック内のキーフレーム
  • インタラクティブアイランド: client:visible ディレクティブを使用して、必要なときだけJSが読み込まれるようにする

避けるべきこと

  • 「Hi, I'm a developer who loves to code」のような一般的なヒーローテキスト
  • 紫のグラデーション、すべてを丸くする、青いCTAボタン
  • 散らかったレイアウト — 白(または黒)のスペースを活かす
  • 文脈なしで触れたことのあるすべての技術を列挙する
  • CVのように読めるコピー; これはリストではなく、ナラティブです

関連スキル