Communitygithub.com

diegosouzapw/awesome-omni-skill

採用につながるGitHubポートフォリオを構築します。厳選した3~5のプロジェクト、魅力的なREADME、ライブデモのデプロイ、リポジトリ間での一貫したストーリー展開、AIネイティブ開発職への適応を支援します。就職活動に向けてGitHubを準備するとき、ピン留めするリポジトリを決めるとき、公開プロフィールを監査するときに使用します。

awesome-omni-skill とは?

このスキルは、採用担当者が一目で「この候補者に会いたい」と思わせるGitHubポートフォリオ戦略を提供します。単なるコード置き場ではなく、厳選された展覧会としてGitHubを再定義するための具体的なガイドラインが含まれています。主な内容は、品質と量のトレードオフ、リポジトリ間で一貫したストーリーを紡ぐ方法、ピン留めする最適なリポジトリ構成、30秒でプロジェクトを売り込むREADMEの書き方、ライブデモの重要性とデプロイ方法、コントリビューショングラフの適切な見せ方、AIネイティブ開発職に特化したポートフォリオ調整方法です。特に、AIエージェントを使ったポートフォリオレビューを依頼する「パワームーブ」のプロンプト例も含まれており、Claude Code, Cursor, CodexなどのAIエージェントと連携して実際にフィードバックを得る方法が示されています。チェックリスト形式の監査項目も豊富で、即座に実行可能な改善アクションを提供します。

対応✓Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add https://github.com/diegosouzapw/awesome-omni-skill/tree/HEAD/skills/tools/portfolio-strategy

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

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

ドキュメント

ポートフォリオ戦略

基本原則

あなたのGitHubは、未完成プロジェクトの墓場ではありません。厳選された展示会です。ピン留めされた各リポジトリは、採用担当者があなたについて抱く一つの質問に答えるべきであり、そのすべての答えが面接を予約したいと思わせるものでなければなりません。

印象的なポートフォリオと平凡なポートフォリオの違い

平凡なポートフォリオ                    印象的なポートフォリオ
─────────────────                     ────────────────────
30リポジトリ、ほとんどがフォーク        5リポジトリ、すべてオリジナル
READMEなし                             各READMEがストーリーを語る
ライブデモなし                         すべてのプロジェクトがデプロイ済み
ランダムなチュートリアルのクローン      明確なテーマと進歩
最終コミット: 8ヶ月前                   一貫性のある最近の活動
リポジトリに説明なし                    各リポジトリに一言説明
"my-first-react-app"                   "AI搭載コードレビューツール"

違いは才能ではありません。厳選です。優れたポートフォリオは、計画を持った誰かのように見えます。触れたものすべてをコミットする人のようではありません。


量より質

3~5の洗練されたプロジェクトは、30の放棄されたリポジトリに勝ります。毎回です。

重要な計算

リポジトリ数README数デプロイ済み数採用担当者の印象
3020「物事を始めるが、完成させない」
1551「手を出すが、何が得意か不明」
554「集中している。出荷する。技術を熟知している」
333「触れるものすべてが完成度が高い」

クリーンアップのルール

何か新しいものを追加する前に、既存のものを監査しましょう:

1. 未完成で修正不可能なものはアーカイブまたは非公開にする。
2. 変更を加えていないフォークリポジトリは削除する。
3. 公開し続けるものにはREADMEを追加する。
4. すべての可視リポジトリに説明を設定する。
5. 残ったものは見せる価値があるものでなければならない。

自分の履歴書に載せたくないものは、公開GitHubに載せるべきではありません。


リポジトリ間でストーリーを紡ぐ

ピン留めしたリポジトリはランダムなサンプルではありません。章です。訪問者が物語を見られるように配置しましょう。

効果的なストーリー構造

スペシャリストの流れ:

「私はAI/MLを深く掘り下げ、それを証明できます。」

リポジトリ1: ドメイン固有タスク用にファインチューニングしたLLM
リポジトリ2: 評価フレームワークを備えたRAGパイプライン
リポジトリ3: ツールを使用したエージェントワークフロー
リポジトリ4: LangChain/LlamaIndexへのオープンソースコントリビューション

フルスタックビルダーの流れ:

「データベースからデプロイまで、完全な製品を構築します。」

リポジトリ1: フルスタックSaaSアプリ (Next.js + API + DB + Auth)
リポジトリ2: AI搭載CLIツール (バックエンド/システムスキルを示す)
リポジトリ3: オープンソースライブラリ (API設計思考を示す)
リポジトリ4: 個人用自動化ツール (自分のためにも構築することを示す)

AIネイティブ開発者の流れ:

「AIを使うだけでなく、AIで構築し、AIのために構築します。」

リポジトリ1: エージェントワークフロー / マルチエージェントシステム
リポジトリ2: プロダクショングレードアプリでのLLM統合
リポジトリ3: AIを活用した開発者ツール (リンター、レビュアー、ジェネレーター)
リポジトリ4: AIフレームワークまたはツールチェーンへのコントリビューション

成長のシグナル

採用担当者は、リポジトリが成長を示していることに気づきます:

シグナル示すもの
初期リポジトリ: 単純なCRUDアプリどこかから始めた
中期リポジトリ: テストとCIを備えたAPIエンジニアリングプラクティスを学んだ
最近のリポジトリ: 評価機能付きAIエージェント最先端で構築している
主要OSSプロジェクトへのコントリビューション大規模コードベースで作業できる

何をピン留めするか、そしてその理由

ピン留めできるのは6つまでです。戦略的に使いましょう。

理想的なピンレイアウト

スロットピン留めするもの理由
1フルスタックプロジェクト完全な製品を構築できることを証明する
2AI/MLプロジェクト最先端で作業していることを示す
3オープンソースコントリビューション実際のコードベースで協力できることを証明する
4開発者ツールまたはCLI自分自身の問題を解決できることを示す
5ドメインプロジェクト (専門分野)対象職種に対する深さのシグナル
6ワイルドカード — 個人またはクリエイティブ個性と真の好奇心を示す

ピン留めのルール

ピン留めすべきもの:
  - ライブデモまたはデプロイリンクがあるプロジェクト
  - 徹底したREADMEとスクリーンショットがあるリポジトリ
  - 応募している職種にマッチする仕事
  - 最も最近の、最も洗練された作品

ピン留めすべきでないもの:
  - 実質的に変更していないフォークリポジトリ
  - チュートリアルのフォローアロング (完了していても)
  - READMEがないリポジトリ
  - 面接で説明できないもの

ポートフォリオのピッチとしてのREADME

ピン留めした各リポジトリには、30秒でプロジェクトを売り込むREADMEが必要です。採用担当者は、読み続けるかどうかを決める前に、それよりも短い時間しか費やしません。

ポートフォリオリポジトリのREADME構造

# プロジェクト名
何をするのか、なぜ重要なのかを一文で説明。

## デモ
[ライブデモへのリンク] | [ビデオウォークスルーへのリンク]

アプリの動作を示すスクリーンショットまたはGIF。

## 問題
これはどのような問題を解決しますか?誰がこの問題を抱えていますか?

## 仕組み
アーキテクチャの概要。主要な技術的決定。
システムに複数のコンポーネントがある場合は図。

## 使用技術
使用したテクノロジーのリスト — ただし意味のあるものだけ。
HTML/CSSはリストしないでください。AI統合、データベース、デプロイ先はリストしてください。

## 主な機能
- 機能1 — なぜ技術的に興味深いか
- 機能2 — 構築する上で何が難しかったか
- 機能3 — 次に何を改善するか

## はじめに
明確なセットアップ手順。誰かが5分以内で実行できるように。

## 学んだこと
最も困難な技術的課題と、それをどのように解決したかについての簡単な考察。

READMEのアンチパターン

悪いREADME良いREADME
「Reactアプリ」「録音をアクションアイテムに変えるAI搭載の議事録要約ツール」
スクリーンショットなしページの上部にヒーロースクリーンショットまたはGIF
セットアップ: 「clone and run」セットアップ: 前提条件をリストしたステップバイステップ
アーキテクチャの説明なしコンポーネントの接続を示すシステム図
すべてのnpmパッケージをリスト重要事項である3~4のテクノロジーを強調

ライブデモとデプロイリンク

コードは仮説です。デプロイされたアプリは証拠です。

デプロイが重要な理由

採用担当者がデモのないリポジトリを見る:
  「面白いコードだ… 実際に動くのか?」

採用担当者がライブリンクのあるリポジトリを見る:
  「試してみよう。」→ 2分後 → 「この人は出荷できる人だ。」

プロジェクトタイプ別のデプロイオプション

プロジェクトタイプ無料デプロイ先適しているもの
フルスタックWebアプリVercel, Railway, Fly.ioプロダクション感のあるアプリ
API / バックエンドRailway, Renderバックエンドスキルの表現
静的サイト / ドキュメントGitHub Pages, Netlifyドキュメント、ランディングページ
AI/MLデモHugging Face Spaces, Streamlit Cloudモデルデモ、データアプリ
CLIツールnpm publish, Homebrew tap配布のシグナル

デプロイできない場合は、デモを録画する

すべてをクラウドで実行できるわけではありません。ローカル専用ツール、CLIアプリ、複雑なシステムの場合:

1. 60~90秒のビデオウォークスルーを録画する。
2. YouTubeにアップロードする (限定公開で構わない)。
3. 主要な操作のGIFを作成する。
4. 両方をREADMEに配置する。

ビデオデモは、デモがない場合の10倍効果的です。


コントリビューショングラフ

一貫性が示すもの

採用担当者はあなたのコントリビューショングラフを一目見ます。彼らが実際にそこから読み取るものは次のとおりです:

パターン解釈
ほとんどの日、安定した緑「この人は定期的にコードを書いている。良い習慣だ。」
プロジェクト周辺に集中「集中したスプリントで作業している。正常だ。」
平日のみ緑「仕事がありながらも、個人の作品も出荷している。」
自身のリポジトリとコントリビューションの混合「協力的だ。個人プロジェクトだけではない。」

操作がどのように見えるか

経験豊富なレビュアーはこれらを瞬時に見抜けます:

危険信号:
  - 完全に均一な緑 (毎日、同じ強度)
  - READMEの編集や空白の変更のみのコミット
  - 空のリポジトリへの1日500コミット
  - 1週間で作成された数十のリポジトリ、すべて単一コミット
  - 自動生成されたコミットボット

グラフを操作することは、ギャップがあることよりも悪いです。それは必死さと判断力の欠如を示します。本当の一貫性とは、ギャップがあっても、自分が気にかけていることに定期的なリズムで取り組むことを意味します。

本物のグラフを構築する

偽装する代わりに:
  1. 1つのプロジェクトを選び、毎日30分取り組む。
  2. オープンソースにコントリビュートする — ドキュメント、テスト、バグ報告でも構わない。
  3. メモや実験をコミットする学習用リポジトリを維持する。
  4. 実際に使うツールを構築する。自然と改善し続けることになる。

ポートフォリオを希望する職種に合わせる

ポートフォリオは、採用された場合に行う仕事のプレビューのように見えるべきです。ターゲットに合わせて調整しましょう。

AIネイティブ開発職

これらの職種は、AI で 構築し、AI のために 構築できることを証明することを求めています:

シグナル例示リポジトリ
ワークフローにおけるAIツールの使用.claude/ 設定、AI支援コミット、Claude Codeスラッシュコマンドを含むプロジェクト
エージェントワークフロー調査、計画、タスク実行を行うマルチステップエージェント
LLM統合構造化出力、プロンプトエンジニアリング、モデルルーティングを備えたアプリ
RAGと検索埋め込み検索と評価指標を備えた知識ベース
評価とテストLLM出力評価フレームワーク、プロンプト回帰テスト
AI支援開発AIツールがどのように開発を加速したかを文書化したプロジェクトREADME

職種別ポートフォリオターゲット

対象職種必須リポジトリあると良いもの
AI/MLエンジニアファインチューニングモデル、評価フレームワーク、データパイプライン論文実装、モデル比較
フルスタックAI開発者LLM統合アプリ、RAGシステム、デプロイ済みSaaSオープンソースコントリビューション、CLIツール
プラットフォーム / インフラエンジニアCI/CDパイプライン、IaCリポジトリ、監視設定パフォーマンスベンチマーク、OSSコントリビューション
開発者ツール / DXエンジニアCLIツール、SDK/ライブラリ、VS Code拡張機能ドキュメントサイト、開発者コミュニティツール

ポートフォリオレビューチェックリスト

就職活動のたびにこの監査を実行してください。正直に。

第一印象 (30秒)

  • プロフィール写真がプロフェッショナルである (または意図的に特徴的である)
  • 自己紹介に、自分が何をするのか、何を求めているのかが書かれている
  • ピン留めされたリポジトリの説明が、見知らぬ人にも理解できる
  • 少なくとも3つのピン留めリポジトリに、README内にスクリーンショットまたはデモリンクがある
  • 最初のページに恥ずかしいリポジトリ名が見えない

深さチェック (2分)

  • 各ピン留めリポジトリに、何を、なぜ、どのように説明するREADMEがある
  • 少なくとも1つのプロジェクトにライブデモまたはデプロイリンクがある
  • ピン留めリポジトリのコード品質が現在のスキルレベルを反映している
  • コミット履歴が実際の開発を示している (単一の「initial commit」ブロブではない)
  • 少なくとも1つのリポジトリがテストまたはCI/CDを示している

ストーリーチェック (5分)

  • ピン留めリポジトリがスキルに関する一貫したストーリーを伝えている
  • 古いプロジェクトから新しいプロジェクトへの目に見える進歩がある
  • ポートフォリオがターゲットとする職種に合致している
  • すべてのピン留めリポジトリを60秒のエレベーターピッチで説明できる
  • このGitHubを見て、自分自身を採用したいと思う

究極のテスト

シークレットウィンドウで自分のGitHubを開いてください。あなたに会ったことのない採用担当者になったつもりで。60秒間見てください。この候補者を次のラウンドに進めますか?

答えが即座に「はい」でなければ、反復を続けてください。


アンチパターン

アンチパターンなぜ悪いか修正方法
変更のないフォークリポジトリ水増しのように見える削除または非公開にする
チュートリアルのクローン ("todo-app", "weather-app")構築できることを示すのではなく、指示に従ったことを示すフォークして、チュートリアルをはるかに超えて拡張する
空のリポジトリまたはREADMEのみのリポジトリ放棄されたアイデアを示すアーカイブまたは削除する
公開リポジトリにREADMEがない「自分の仕事について連絡しない」公開し続けるすべてのものにREADMEを追加する
厳選されていない50以上の可視リポジトリ圧倒的なノイズ、シグナルなし積極的にアーカイブし、戦略的にピン留めする
古いピン留めリポジトリ (2年以上前)「最近何も構築していない」最近の作品を示すためにピンをローテーションする
自動生成された統計情報のみのプロフィールREADME非人間的、努力不足自分の焦点と目標を書いた実際の自己紹介を書く
"test", "temp", "asdf" という名前のリポジトリ不注意名前を変更または削除する

パワームーブ

「[あなたのGitHub URL] にある私のGitHubポートフォリオをレビューしてください。AIネイティブ開発職の採用担当者として評価してください。各ピン留めリポジトリを、READMEの品質、技術的深さ、デプロイ状況、AI/ML職への関連性についてスコアリングしてください。その後、優先順位付けされたアクションプランを提示してください: 何をアーカイブすべきか、何を改善すべきか、何が欠けているか、そして最大の違いを生むであろう新しいプロジェクトは何か。」

エージェントがあなたのポートフォリオ評論家となり、GitHubをコードの墓場からキャリア資産に変えるために必要な、正直で具体的なフィードバックを提供します。

関連スキル

スキル使用タイミング
github-profileGitHubプラットフォームの仕組み(プロフィールREADME、リポジトリピン留め、トピック、アクティビティグラフ)を実装するとき
career-resumeキャリアライフサイクル全体(就職活動、面接、オンボーディング、業績評価)をカバーするとき

Individual skills in this repo

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

diegosouzapw/awesome-omni-skill

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

diegosouzapw/awesome-omni-skill

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

diegosouzapw/awesome-omni-skill

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

diegosouzapw/awesome-omni-skill

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.

diegosouzapw/awesome-omni-skill

Optimize project portfolio selection under constraints using mathematical optimization

diegosouzapw/awesome-omni-skill

Rapidly build, prototype, and deploy full-stack software using AI "text-to-app" tools. Use this when you need to create a greenfield application, build a high-fidelity working prototype for user testing, or bypass traditional engineering bottlenecks for internal tools.

diegosouzapw/awesome-omni-skill

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,...

diegosouzapw/awesome-omni-skill

Minimalist, typography-focused portfolio design system inspired by neo-brutalist and Swiss design principles. Emphasizes bold typography, generous whitespace, monochromatic color schemes, and elegant simplicity for developer/designer portfolios.

diegosouzapw/awesome-omni-skill

Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my site against best practices".

diegosouzapw/awesome-omni-skill

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

diegosouzapw/awesome-omni-skill

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.

diegosouzapw/awesome-omni-skill

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.

diegosouzapw/awesome-omni-skill

Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my site against best practices".

diegosouzapw/awesome-omni-skill

Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my site against best practices".

diegosouzapw/awesome-omni-skill

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.

diegosouzapw/awesome-omni-skill

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.

diegosouzapw/service-website-generator

Orchestrates automated service-based website generation with local SEO optimization. Creates 200+ service+location pages using parallel agents, Unsplash images via Jina AI, NextJS with dynamic routing, and PostgreSQL database. Use when building service business websites (plumbers, electricians, pressure washing, HVAC, etc.) targeting multiple locations.

関連スキル