Communitygithub.com

mohammadNafia/portfolio

ライトグレーの「ピクセルディスプレイ」スタイルのポートフォリオサイト向けデザインシステムと構築ルール。新しいセクション、コンポーネント、ページを追加・編集する際は常にこのスキルを使用すること。

portfolio とは?

このスキルは、特定のビジュアル&モーションシステムに基づいたポートフォリオサイトの構築と拡張を強制するためのものです。主な特徴として、ピクセルフォントのセクションタイトル(手描き風の波線アンダーライン付き)、ノコギリ歯/破れた紙のようなセクション区切り、ファン状に広がるカードヒーローセクション、ぼかしスクロールリビール、ロゴマーキー、ケーススタディカルーセルなどがあります。デザインの一貫性を保つために、CSS変数として定義されたデザイントークン(色、タイポグラフィ、スペーシング、シャドウ)、再利用可能なコンポーネントパターン、モーションのガイドライン、そして新しいセクションを追加するためのテンプレートが用意されています。このスキルは、Claude Code、Cursor、CodexのようなAIエージェントで動作し、ユーザーが「セクションを追加」「同じ雰囲気で」「ضيف قسم」などと指示した場合や、画像をアップロードしてサイトに配置する場合に自動的に適用されます。既存のマークアップをスタイルの逸脱がないかレビューする際にも使用されます。要するに、後から追加されるすべての要素が、同じデザイナーによって同じ日にデザインされたかのように見えることを目的としています。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/mohammadNafia/portfolio/tree/HEAD/docs

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

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

ドキュメント

これはオリジナルのペーストであり、証明のために保持されています。作業用コピーではありません。

正式なシステムはdocs/pixel-portfolio-style/にあり、 4つのリファレンスファイルとassets/base.cssが含まれています。そちらを読んでください。

このファイルは、ビルドに依存する2つの追加事項よりも前に作成されました:ルール#0(システムをその場で適用し、動作していてテスト済みのアプリをスタイル適用のために書き換えない — 全面リスタイルを決定したルール)と、ルール#9およびreferences/rtl-and-locales.mdへのポインタです。代わりにこのコピーに従うと、両方を見逃すことになります。

ピクセルポートフォリオスタイル

完全なビジュアル+モーションシステム。文字通りに従ってください。ここでカバーされていない場合は、より控えめで、より丸みがあり、より幾何学的なオプションを選択してください — 新しい色、新しいフォント、新しい角丸、新しいイージングカーブを決して導入しないでください。

絶対条件(毎回読むこと)

  1. 2フォントのみ。 ピクセルディスプレイフォントをセクションタイトル+ヒーローワードに。幾何学的サンセリフをその他すべてに。
  2. アクセントカラーは1色のみ。 青 #0B8DF8。二次ボタン用に黒 #111。それ以外は不可。
  3. すべてのセクションタイトルは、大文字のピクセルフォント+手描きの波線SVGアンダーライン、中央揃え。
  4. すべてのセクションは、同じブラーアップトランジション(references/motion.md参照)でスクロール時にリビールされます。
  5. 角丸はピル型または20px。 4px、8px、または鋭い角は不可(ノコギリ歯の区切りを除く)。
  6. ボーダーはなし。 区切りは#F2F2F2の塗りつぶしとソフトシャドウによって行われ、1pxの線では行われません。
  7. 中央揃え、最大1080pxのコンテンツカラム。 余裕のある垂直リズム(セクション間120〜160px)。
  8. コピーは小文字を基本とし、自虐的/人間らしく、決して企業的ではありません。短い文章。

新しく何かを追加する際のワークフロー

  1. references/design-tokens.mdを読む → CSS変数を使用し、生のhexは決して使わない。
  2. references/components.mdを読む → 追加したいものがパターンとして既に存在するか確認する(ピル、タグ、カード、セクションヘッダー、マーキー、カルーセル、フォームフィールド)。それを再利用する。2番目のカードスタイルを発明しない。
  3. references/motion.mdを読む → 標準のリビール+ホバー動作を適用する。
  4. 完全に新しいセクションの場合は、references/section-recipes.mdを読み、「新セクションテンプレート」に正確に従う(スペーシング、ヘッダー、リビール、コンテナ)。
  5. --bg / --bg-heroでセクションの背景を交互にする。隣接する2つのセクションの背景が異なる場合は、その間にノコギリ歯の区切り線を配置する(直線は決して使わない)。
  6. セクションIDをナビのピルリンクに追加するのは、それがトップレベルの遷移先である場合のみ(ナビリンクは最大4つまで。5つ目を追加する場合は、どのリンクを削除するかユーザーに確認する)。
  7. 新しい画像スロットは、必要な正確なアスペクト比とともにassets/IMAGES.mdに追加し、ユーザーが何を提供すべきか分かるようにする。

終了前のセルフチェック

  • すべての新しい見出しがピクセルフォント+波線アンダーラインを使用しているか?
  • トークンリストにないhexコードはないか?削除する。
  • 999px、20px、16px、14px以外の角丸はないか?修正する。
  • 新しいブロックがblur(10px) → 0とy: 30px → 0でフェードインするか?
  • ホバー状態がscale(1.03)+シャドウリフト+250msを使用しているか?
  • モバイル:ファン/カルーセル/グリッドがreferences/components.mdのモバイルルールに従って折りたたまれているか?
  • セクションの垂直パディングをclamp(80px, 10vw, 160px)に保ったか?

リファレンスファイル

ファイルいつ読むか
references/design-tokens.md常に — 色、タイプスケール、スペーシング、シャドウ、フォント
references/components.mdUI要素(ナビ、カード、タグ、フォーム、マーキー、カルーセル、区切り線)を構築するとき
references/motion.mdアニメーション、リビール、ホバー、ページロードのコレオグラフィーすべて
references/section-recipes.md真新しいセクションまたはページを追加するとき
assets/base.cssすべてのトークン+プリミティブが既に実装されたドロップインスタイルシート
assets/IMAGES.mdサイトが必要とする画像とその比率

関連スキル