Communitygithub.com

maumoya/pro-portfolio-dev

ユーザーのパブリックGitHubリポジトリから開発者ポートフォリオのランディングページを計画、構築、公開します。GitHub Pages上にSEO、JSON-LD、llms.txt、サイトマップ、1200×630のシェア画像、8テーマ、10言語、プロジェクト・スキル・経験のスマート検索、オプションの静かなサウンドを備えてライブ公開します。実際のリポジトリ情報のみを使用します。「/pro-portfolio-dev」「ポートフォリオ作って」「GitHubからポートフォリオを」「ポートフォリオランディングページ」「リポジトリをWebサイトに」「開発者ポートフォリオサイト」「GitHub Pagesに公開」「新しいリポジトリでポートフォリオを更新」などの発言で利用できます。

pro-portfolio-dev とは?

このスキルは、ユーザーのGitHubアカウントから実際の公開リポジトリ情報を取得し、開発者向けポートフォリオランディングページを自動計画・構築・公開するためのツールです。主な特徴として、8つのテーマ、10言語対応(UI文字列内蔵)、プロジェクト・スキル・経験に対するスマート検索、SEO対策(JSON-LD、llms.txt、サイトマップ、1200×630シェア画像)、そしてオプションの静かなサウンド機能を備えています。処理の流れは「取得(fetch)→計画(plan)→構築・チェック(build/check)→公開(publish)→測定・報告(measure/report)」の5ステップで構成され、各ステップは専用スクリプトで自動化されています。特に、ユーザーがプロジェクトを選択し、正直で簡潔なコピーを書くことに集中できるよう設計されており、架空の数値や成果を絶対に使用しないという厳格なルールに従います。Claude CodeやCodexなどのエージェント上で動作し、最終的なURLがライブになったことを確認して報告します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/maumoya/PRO-Portfolio-DEV/tree/HEAD/skills/pro-portfolio-dev

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

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

ドキュメント

PRO Portfolio DEV

GitHubユーザーを入力すると、ライブポートフォリオが出力されます。スクリプトが取得、構築、チェック、公開を行います。 あなたがすべきことは、スクリプトにできない唯一のこと、つまりプロジェクトを選び、正直で簡潔なコピーを書くことだけです。 パスはこのスキルのフォルダからの相対パスです。作業はスクラッチフォルダ(例:portfolio/)で行ってください。

1 · 取得(事実のみ)

python3 scripts/fetch.py USER --out portfolio/repos.json(パブリックAPI呼び出し2回、トークン不要)。 トップリポジトリを出力します。これらが使用できる唯一の事実です。星、ユーザー、結果を決して捏造しないでください。

2 · 計画(確認してから portfolio/plan.json を書く)

1回のメッセージで確認し、ユーザーが「go」と言えば受け入れられるデフォルトを提示します。

  • 誰が、誰のために: 名前、役割、対象者(採用担当者、クライアント、同僚)。デフォルト:GitHub名とbio。
  • プロジェクト: 最強の4~9個を提案(星の数、直近のプッシュ、ホームページの有無、明確な説明)。ユーザーが選びます。
  • スキルと経験: 検索可能にする(オプション)、連絡先リンク。
  • 配置場所: USER.github.io(ルート)またはリポジトリの docs/ フォルダ。URLは最終的なものでなければなりません。

次に plan.json を書きます(スキーマとコピールールは references/plan.md を参照)。コピールールの要約:見出しは8語以内、タグラインは「何を+誰のために」を示す。各プロジェクトには1行のピッチ(利点であり、スタックではない)と、そのリポジトリのREADMEまたはGitHubデータ内にある数値を引用するオプションの proof 行。決して捏造しないでください。

言語: 10言語のUI文字列は scripts/ui.json に同梱されています。ユーザー自身のコピーを翻訳するには、plan.t.<言語> を追加し、ネイティブライターがその言語で言うであろう意味に合わせて翻訳します。文字通りの逐語訳ではなく(references/plan.md、「翻訳」を参照)。その後、各言語をネイティブの読者として一度読み直し、直訳的に聞こえる部分を修正します。

3 · 構築とチェック

python3 scripts/build.py portfolio/repos.json portfolio/plan.json --out portfolio/site
python3 scripts/check.py portfolio/site

check.py は PASS を出力しなければなりません。公開前にブラウザで portfolio/site/index.html を開いて見てください。 タイプミスでの検索を試し、アラビア語(右から左)とダークテーマに切り替えてみてください。

4 · 公開(外部へ:まず確認)

ユーザーにページとターゲットを表示し、同意を得ます。次に: bash scripts/publish.sh portfolio/site REPO_CLONE URL [--folder root|docs] --yes コミット、プッシュ、必要に応じてPagesを有効にし、新しいビルドがライブになるまでポーリングし、LIVE … in N s と出力します。

5 · 測定と報告

4行以内で報告:ライブURL、LIVE 時間、check.py のスコア、PageSpeed Insights(pagespeed.web.dev、無料)またはインストールされているローカルの lighthouse によるLighthouse SEO / アクセシビリティ / パフォーマンス。

完了条件

  • check.py がビルドされたサイトに対して PASS を出力している。
  • ページ上のすべてのプロジェクトがユーザーの実際のリポジトリであり、すべての数値がGitHubデータまたはREADMEに遡れる。
  • ライブURLが新しいビルドを返している(publish.sh が LIVE を出力した)、またはユーザーが公開しないことを選択した。

絶対にしないこと

  • プロジェクト、指標、雇用主、推薦文を捏造すること。代わりに尋ねること。
  • ユーザーの同意なしにプッシュ、公開、Pagesの有効化を行うこと。
  • トラッカー、分析、Cookie、外部スクリプトを追加すること。このページはサードパーティへのリクエストを行いません。
  • 既存のサイトを、何が変わるかを示さずに上書きすること(--yes なしの publish.sh はドライランです)。

関連スキル