github-profile

GitHub プロフィール最適化ツール

このスキルは GitHub プロフィールを監査し、最適化したプロフィール README と、メタデータ、ピン留めリポジトリ、統計ウィジェットに関する推奨事項を作成します。GitHub プロフィールは開発者のショーケースです。コードを一行も読む前に、相手に与える印象を左右します。

コードのレシピは AGENTS.md にあります。具体的な修正を実装する必要がある場合は、そちらを読んでください。このファイルにはワークフローと監査チェックリストが記載されています。

ワークフロー

1. プロフィールの背景情報を集める — この人／組織がどのような存在で、何をアピールしたいのかを把握します
2. 現在のプロフィールを監査する — プロフィールの公開情報を隅々まで評価します
3. プロフィール README を作成する — 洗練され、ざっと読みやすい README.md を作成します
4. メタデータと設定を推奨する — 自己紹介、ピン留めリポジトリ、設定、ウィジェットについて助言します
5. 確認する — 表示、バッジの URL を確認し、次の手順をまとめます

---

フェーズ 0：背景情報の収集

プロフィールの種類を判定する

明らかでない場合は、ユーザーに個人プロフィールか組織プロフィールかを尋ねます。仕組みは大きく異なります。

機能	個人プロフィール	組織プロフィール
README の場所	username/username/README.md	.github/profile/README.md
公開範囲の選択肢	公開のみ	公開＋メンバーのみ（.github-private リポジトリ経由）
ピン留めリポジトリ	最大 6 件	公開最大 6 件＋メンバーのみ最大 6 件
コントリビューショングラフ	あり	なし
アチーブメント	あり	なし

情報を集める

作成前に、ユーザー名、現在の役職／会社、主な技術、アピールしたい内容、トーン（プロフェッショナル／カジュアル／クリエイティブ／ミニマル）、対象読者（採用担当者／共同作業者／投資家／OSS コミュニティ）を集めます。

gh が利用可能な場合（gh auth status）、次の情報を自動で取得します。

• gh api user — 名前、自己紹介、会社、所在地、ブログ、Twitter
• gh api users/{username}/repos?sort=stars&per_page=10 — ピン留めの推奨に使う上位リポジトリ
• gh repo view {username}/{username} --json name 2>/dev/null — 特別なリポジトリが存在するか確認

---

フェーズ 1：監査

既存のプロフィールがある場合は監査します。新規に始める場合は、フェーズ 2 に進みます。次の 4 カテゴリを採点します（各 x/10、合計 x/40）。

プロフィール README（x/10）

• 存在するか？ README.md を含む username/username リポジトリがないのは、最も大きな見落としです。
• 構成 — 理想的な流れ：挨拶／プロフィール → 現在の取り組み → 技術スタック（バッジ）→ GitHub の統計 → 注目プロジェクト → ソーシャルリンク → 個人的な一面。
• 長さ — 400～800 語。200 語未満では内容が薄く感じられ、2,000 語を超えると雑然とします。
• 読みやすさ — 10 秒で要点をつかめますか？折りたたみ可能なセクションには <details> を使います。
• 最新性 — 動的コンテンツは更新され続けていますか？GitHub は、リポジトリが 60 日間非アクティブだと cron Actions を停止します。

プロフィールのメタデータ（x/10）

未入力の項目はすべて、機会を逃していることになります。

• 写真 — プラットフォーム間で統一された、鮮明な顔写真ですか？
• 自己紹介 — 入力されていますか（160 文字の上限）。役職＋主な技術＋特徴を示していますか？
• 会社 — @ プレフィックス付きでリンクされていますか？所在地、ウェブサイト — 入力されていますか？
• ソーシャルアカウント — Twitter/X、LinkedIn がリンクされていますか？相互リンクは信頼につながります。
• 代名詞 — 包括性を示します。ステータス — 現在の仕事や対応可能状況を示します。

ピン留めリポジトリ（x/10）

最大 6 件のリポジトリ（コントリビュートしたリポジトリも含む）：

• 6 枠すべて使っていますか？説明は入力されていますか？技術に幅がありますか？
• キャリア／ビジネスの目標に沿った、スターのあるリポジトリ（第三者からの評価）を優先します。
• ピン留めする各リポジトリには、洗練された README が必要です（ここでは github-repo スキルが役立ちます）。

コントリビューション活動（x/10）

• グラフ — 適度に活動していますか？完全に空だと疑問を持たれます。
• プライベートコントリビューション — 設定で「プライベートコントリビューションを含める」が有効になっていますか？
• アチーブメント — Starstruck、Pull Shark、Arctic Code Vault Contributor は信頼性を高めます。

フェーズ 2：プロフィール README の作成

監査結果に基づいて（またはゼロから）、プロフィール README を作成します。詳しい手順については、AGENTS.md をお読みください。

プロフィール README は、ざっと目を通しやすく、個性があり、目的に沿ったものにします。各セクションは、その人の目標に役立つ内容にしてください。対象読者に合わせて、トーンや構成を調整します。

AGENTS.md のセクション：個人プロフィール README のテンプレート、統計ウィジェット、技術スタックとソーシャルリンクのバッジ、自動更新コンテンツ、組織プロフィール README、プロフィール生成ツール。

---

フェーズ 2.5：メタデータと読みやすさの確認

1. metadata-check スキル — GitHub の自己紹介文（160 文字）と、書き換えた固定表示リポジトリの説明文に実行します。冒頭への重要情報の配置、具体性、能動態、表示の切り詰めへの適合性を確認します（GitHub のプロフィールカードでは約 100 文字が表示されます）。
2. readability-check スキル — プロフィール README の本文に実行します。プロフィール README は流し読みされるため、受動態の文や長い文が一つあるだけでも目立ちます。

修正は直接適用します。重点を置くのは、（1）自己紹介文／README の冒頭の一文（影響が特に大きい）、（2）各セクションの最初の一文（流し読みの入り口）、（3）受動態（自分を語る内容では印象が平板になります）です。

---

フェーズ 3：推奨事項

更新するメタデータ

具体的に提示します。「自己紹介文を次の内容に設定します：[160 文字未満のテキスト]」「上位のリポジトリに次のトピックを追加します：[リスト]」「ステータスを次の内容に設定します：[提案]」。

固定表示リポジトリの選定方針

固定表示する 6 つのリポジトリと、その理由を推奨します。技術の多様性、スター数（社会的な裏付け）、README の品質、目標との一致を考慮します。固定表示するリポジトリの README が不十分な場合は、先に改善するよう提案します（github-repo スキル）。

---

フェーズ 4：確認

• README が正しく表示されることを確認します（Markdown 構文、バッジ URL、画像リンクを確認）
• すべての shields.io バッジ URL が有効であることを確認します（正しいロゴ名、16 進カラーコード）
• 統計ウィジェットの URL で正しいユーザー名が使われていることを確認します
• ローカルで生成する場合、まだ作成していなければマジックリポジトリ（username/username）を作成し、そこに README をプッシュするようユーザーに案内します
• 次の手順をまとめます。コミット／プッシュする内容、GitHub の設定で手動変更する内容

---

出力形式

スコア表（4 カテゴリ、それぞれ x/10、合計 x/40）→ カテゴリ別の調査結果 → 生成または変更したファイル → 次の手順（設定変更、固定表示するリポジトリ、GitHub での手動設定）。

---

主な原則

• 網羅性より、流し読みのしやすさを重視します。 プロフィールは 10 秒で流し読みされます。掲載する価値のない内容は削除します。
• テンプレートより、個性を重視します。 その人の目標や対象読者に合わせて、トーン、構成、内容を調整します。クリエイティブな開発者とスタートアップの創業者では、適したプロフィールが異なります。
• すべての項目を埋めます。 メタデータの未入力項目、固定表示するリポジトリの不足、空欄の説明文は、機会を逃すことになります。
• 価値がある部分には動的コンテンツを活用します。 統計画像（lowlighter/metrics 経由）と、必要に応じて自動更新されるブログフィードを使うと、プロフィールを新鮮に保てます。通常はそれぞれ 1 つで十分です。予測不能に 502 エラーを返すサードパーティホストのウィジェットは避けてください。AGENTS.md を参照してください。
• すべてを相互にリンクします。 GitHub、LinkedIn、Twitter/X、個人サイトなど、各プロフィールからほかのプロフィールへリンクします。