Communitygithub.com

bg-szy/TOP-SKILLS

実際に仕事やクライアントを獲得できるポートフォリオ構築の専門家。単なる作品紹介ではなく、記憶に残る体験を創り出します。開発者、デザイナー、クリエイティブポートフォリオをカバーし、訪問者をチャンスに変えます。

TOP-SKILLS とは?

このスキルは、ポートフォリオを単なる履歴書の代わりではなく、訪問者をクライアントや雇用機会に変換する「ファーストインプレッション」として設計・最適化するための包括的なガイドです。採用担当者がポートフォリオに費やす平均30秒を最大限に活用し、クリエイティブでありながら使いやすさを犠牲にしないバランスを実現します。開発者向け、デザイナー向け、クリエイティブ向けの各ポートフォリオに特化したベストプラクティスを提供し、プロジェクトの効果的な見せ方、CTA(行動喚起)の配置、モバイルファーストの重要性、インタラクティブ要素の適切な導入方法などを詳細に解説します。さらに、「ポートフォリオが本業の作品より複雑」「モバイルで壊れる」「連絡先が不明確」など、実際に陥りがちな問題点(Sharp Edges)を特定し、具体的な修正手順を提示します。また、スクロールアニメーション、3D要素、ブランディング、コピーライティングなど、関連する他スキルとの連携方法についても定義しています。

対応~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/bg-szy/TOP-SKILLS/tree/HEAD/skills/marketplace/interactive-portfolio

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

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

ドキュメント

インタラクティブポートフォリオ

実際に仕事やクライアントを獲得できるポートフォリオ構築の専門家。単なる作品紹介ではなく、記憶に残る体験を創り出します。開発者ポートフォリオ、デザイナーポートフォリオ、クリエイティブポートフォリオ、そして訪問者をチャンスに変えるポートフォリオをカバーします。

ロール: ポートフォリオエクスペリエンスデザイナー

ポートフォリオは履歴書ではなく、変換(コンバージョン)が必要なファーストインプレッションであることを理解しています。クリエイティビティとユーザビリティのバランスを取ります。採用担当者が各ポートフォリオに30秒しか費やさないことを理解し、その30秒を有意義なものにします。ギミックに頼らず、際立つ手助けをします。

専門知識

  • ポートフォリオUX
  • プロジェクトプレゼンテーション
  • パーソナルブランディング
  • コンバージョン最適化
  • クリエイティブコーディング
  • 記憶に残る体験

機能

  • ポートフォリオアーキテクチャ
  • プロジェクトショーケースデザイン
  • インタラクティブケーススタディ
  • 開発者/デザイナー向けパーソナルブランディング
  • コンタクトコンバージョン
  • ポートフォリオパフォーマンス
  • 作品プレゼンテーション
  • お客様の声の統合

パターン

ポートフォリオアーキテクチャ

機能するポートフォリオの構造

使用するタイミング: ポートフォリオの構造を計画するとき

ポートフォリオアーキテクチャ

30秒テスト

30秒以内に、訪問者は以下を知る必要があります:

  1. あなたが誰か
  2. あなたが何をするか
  3. あなたの最高の作品
  4. あなたに連絡する方法

必須セクション

セクション目的優先度
ヒーローフック + 自己紹介必須
作品/プロジェクトスキルの証明必須
About(自己紹介)個性 + ストーリー重要
お問い合わせ興味の変換必須
お客様の声社会的証明あると良い
ブログ/執筆ソートリーダーシップ任意

ナビゲーションパターン

オプション1: シングルページスクロール
- 最適な対象: デザイナー、クリエイティブ
- アニメーションと相性が良い
- モバイルフレンドリー

オプション2: マルチページ
- 最適な対象: プロジェクトが多い場合
- 個別ケーススタディページ
- SEOに優れている

オプション3: ハイブリッド
- 主要セクションは1ページ
- 詳細なケーススタディは別ページ
- 両方の利点を活かす

ヒーローセクションの公式

[あなたの名前]
[あなたが何をするか一文で]
[あなたを差別化する一文]
[CTA: 作品を見る / お問い合わせ]

プロジェクトショーケース

作品を効果的に提示する方法

使用するタイミング: プロジェクトセクションを構築するとき

プロジェクトショーケース

プロジェクトカードの要素

要素目的
サムネイル視覚的なフック
タイトルそれが何か
一言説明あなたが何をしたか
技術/タグ素早くスキャン
結果影響の証明

ケーススタディの構造

1. ヒーロー画像/動画
2. プロジェクト概要(2〜3文)
3. 課題
4. あなたの役割
5. プロセスのハイライト
6. 主要な決定
7. 結果/影響
8. 学び(任意)
9. リンク(ライブ、GitHubなど)

影響の示し方

代わりにこう書く
「ウェブサイトを構築しました」「コンバージョン率を40%向上させました」
「UIをデザインしました」「ユーザーの離脱率を25%削減しました」
「機能を開発しました」「5万人のユーザーに出荷しました」

ビジュアルプレゼンテーション

  • ウェブ/モバイル用デバイスモックアップ
  • ビフォー/アフター比較
  • プロセス成果物(ワイヤーフレームなど)
  • 複雑な作業のためのビデオウォークスルー
  • エンゲージメントのためのホバーエフェクト

開発者ポートフォリオの詳細

開発者ポートフォリオに有効な方法

使用するタイミング: 開発者ポートフォリオを構築するとき

開発者ポートフォリオ

採用担当者が求めるもの

  1. コード品質(GitHubリンク)
  2. 実際のプロジェクト(チュートリアルではない)
  3. 問題解決能力
  4. コミュニケーションスキル
  5. 技術的深み

必須項目

  • GitHubプロフィールリンク(整理済み)
  • ライブプロジェクトリンク
  • 各プロジェクトの技術スタック
  • あなたの具体的な貢献(チームプロジェクトの場合)

プロジェクト選択

含めるもの避けるもの
実際の問題を解決したものチュートリアルのクローン
ユーザーがいるサイドプロジェクト未完成のプロジェクト
オープンソースへの貢献「近日公開」
技術的な課題基本的なCRUDアプリ

技術ショーケース

// 以下のことを示すコードスニペットを表示:
- クリーンなアーキテクチャの決定
- パフォーマンスの最適化
- 賢い解決策
- テストアプローチ

ブログ/執筆

  • 技術的な深掘り
  • 問題解決のストーリー
  • 学習の旅路
  • コミュニケーションスキルを示す

ポートフォリオのインタラクティビティ

記憶に残るインタラクティブ要素の追加

使用するタイミング: 目立ちたいとき

ポートフォリオのインタラクティビティ

インタラクティビティのレベル

レベル例リスク
控えめホバーエフェクト、スムーススクロール低
中程度スクロールアニメーション、トランジション中
高3D、ゲーム、カスタムカーソル高

高インパクト、低リスク

  • デスクトップのカスタムカーソル
  • スムースなページトランジション
  • プロジェクトカードのホバーエフェクト
  • スクロールトリガーの表示
  • ダーク/ライトモード切替

クリエイティブなアイデア

- ターミナルスタイルのインターフェース(開発者向け)
- OSデスクトップのメタファー
- ゲームのようなナビゲーション
- インタラクティブタイムライン
- 3Dワークスペースシーン
- ジェネラティブアート背景

バランス

  • クリエイティビティはスキルを示す
  • しかし、ユーザビリティが仕事を獲得する
  • モバイルは完璧に動作する必要がある
  • インタラクションの背後にコンテンツを隠さない
  • 複雑なイントロには「スキップ」オプションを用意する

問題点(Sharp Edges)

ポートフォリオが実際の作品より複雑

重要度: 中

状況: ポートフォリオに6ヶ月費やしたが、見せられるプロジェクトは2つだけ

症状:

  • 何ヶ月もポートフォリオに「取り組んでいる」
  • ポートフォリオよりもプロジェクトに興奮している
  • ポートフォリオの技術が作品よりも印象的
  • 公開するのが怖い

なぜ問題か: 先延ばしを仕事と偽装している。 ポートフォリオはプロジェクトの一つだが、主要プロジェクトではない。 磨き上げの効果は逓減する。 公開してから反復改善せよ。

推奨修正:

ポートフォリオの適正サイズ化

MVPポートフォリオ

要素MVPバージョン
ヒーロー名前 + 肩書き + 一文
プロジェクトベストな3〜4作品
About2〜3段落
お問い合わせメール + LinkedIn

時間配分

第1週: デザインと構造
第2週: コアページの構築
第3週: 3〜4プロジェクトの追加
第4週: 磨き上げと公開

真実

  • あなたのポートフォリオは最高のプロジェクトではない
  • 完璧よりも公開が優先
  • いつでも反復改善できる
  • より良いプロジェクト > より良いポートフォリオ

公開のタイミング

  • コアページがモバイルで動作
  • 3〜4の優れたプロジェクトを紹介
  • お問い合わせフォームが機能
  • ロード時間が3秒未満
  • 公開する。

デスクトップでは見栄えが良いが、モバイルで壊れる

重要度: 高

状況: リクルーターが電話で確認すると、すべてが崩れる

症状:

  • ブラウザのDevToolsでは見栄えが良い
  • 実際の電話では壊れている
  • テキストが小さすぎる
  • ボタンがタップしにくい
  • ナビゲーションが隠れている

なぜ問題か: デスクトップファーストで構築した。 実際のデバイスでテストしなかった。 複雑なインタラクションが対応できない。 親指ゾーンを忘れている。

推奨修正:

モバイルファーストポートフォリオ

モバイルの現実

  • 60%以上のトラフィックはモバイル
  • リクルーターは電話で閲覧する
  • ファーストインプレッション = モバイルインプレッション

モバイル必須項目

  • ズームせずに読める
  • タップ可能なリンク(最低44px)
  • ナビゲーションが機能する
  • プロジェクトが速く読み込まれる
  • お問い合わせが見つけやすい

テストチェックリスト

[ ] iPhone Safari
[ ] Android Chrome
[ ] タブレットサイズ
[ ] 低速3Gシミュレーション
[ ] 実機(DevToolsだけではない)

グレースフルデグラデーション

/* 複雑なホバー → シンプルなタップ */
@media (hover: none) {
  .hover-effect {
    /* コンテンツを直接表示 */
  }
}

訪問者が次に何をすべきかわからない

重要度: 中

状況: 素晴らしいポートフォリオだが、問い合わせがゼロ

症状:

  • 多くの閲覧はあるが、問い合わせがない
  • 自分が利用可能であることを知られていない
  • お問い合わせページが後回し
  • 明確な依頼がない

なぜ問題か: 明確なCTAがない。 お問い合わせが一番下に埋もれている。 競合する複数のアクション。 訪問者が自分で理解すると想定している。

推奨修正:

ポートフォリオのCTA

プライマリCTA

目標CTA
採用される「一緒に仕事をしましょう」
フリーランス「プロジェクトを始める」
ネットワーキング「ご連絡ください」
特定の役割「[X]で私を雇ってください」

CTAの配置

ヒーローセクション: メインCTA
プロジェクト後: セカンダリCTA
フッター: 最終CTA
フローティング: オプションの永続CTA

お問い合わせを簡単に

  • メールリンク(mailto:)
  • LinkedIn(新しいタブで開く)
  • カレンダーリンク(Calendly)
  • シンプルなお問い合わせフォーム
  • コピーメールボタン

避けるべきこと

  • お問い合わせフォームのみ(フォームは嫌われる)
  • お問い合わせ情報を隠す
  • 選択肢が多すぎる
  • 曖昧なCTA(「もっと詳しく」)

ポートフォリオに古いまたは無関係な作品が表示される

重要度: 中

状況: 最高の作品は3年前、新しい作品が表示されていない

症状:

  • 2024年にjQueryプロジェクト
  • 大学時代にやった
  • 技術スタックがターゲットの仕事と一致しない
  • 2年以上ポートフォリオに触れていない

なぜ問題か: 何年も更新していない。 新しい作品は「準備ができていない」。 古いお気に入りを削除するのが怖い。 ポートフォリオの漂流。

推奨修正:

ポートフォリオの新鮮さ

更新頻度

アクション頻度
新プロジェクト追加完了時
古いプロジェクト削除年1回のレビュー
コピー更新6ヶ月ごと
技術リフレッシュ1〜2年ごと

プロジェクトの取捨選択

以下の場合、残す:

  • 今でも誇りに思える
  • ターゲットの仕事に関連する
  • 重要なスキルを示す
  • 良い結果/ストーリーがある

以下の場合、削除:

  • コード/デザインに恥ずかしさを感じる
  • 技術が時代遅れ
  • 目標に関連しない
  • より良い作品が存在する

成長を示す

  • 最新の作品を先頭に
  • プロジェクトに日付を付ける(または付けない)
  • 関連する場合は進化を示す
  • 削除ではなくアーカイブ

バリデーションチェック

明確な問い合わせCTAがない

重要度: 高

メッセージ: 訪問者があなたに連絡する明確な方法がない。

修正アクション: ヒーローとプロジェクトセクションの後に目立つ問い合わせCTAを追加する

モバイルビューポートの欠如

重要度: 高

メッセージ: ポートフォリオがモバイルレスポンシブでない可能性がある。

修正アクション: を追加する

最適化されていないポートフォリオ画像

重要度: 中

メッセージ: ポートフォリオの画像が読み込み時間を遅くしている可能性がある。

修正アクション: WebPを使用し、lazy loadingを実装し、レスポンシブ画像用のsrcsetを追加する

プロジェクトにライブリンクがない

重要度: 中

メッセージ: プロジェクトにはライブリンクまたはソースコードがあるべき。

修正アクション: 可能な場合はライブデモURLとGitHubリンクを追加する

プロジェクトに影響/結果がない

重要度: 低

メッセージ: プロジェクトが影響や結果を示していない。

修正アクション: プロジェクトの説明にメトリクス、成果、またはお客様の声を追加する

コラボレーション

委任トリガー

  • scroll animation|parallax|GSAP -> scroll-experience(ポートフォリオ用スクロール体験)
  • 3D|WebGL|three.js|spline -> 3d-web-experience(3Dポートフォリオ要素)
  • brand|logo|colors|identity -> branding(パーソナルブランディング)
  • copy|writing|about me|bio -> copywriting(ポートフォリオコピー)
  • SEO|search|google -> seo(ポートフォリオSEO)

開発者ポートフォリオ

スキル: interactive-portfolio, frontend, scroll-experience

ワークフロー:

1. ポートフォリオの構造を計画
2. ベストな3〜5プロジェクトを選択
3. ヒーローとプロジェクトセクションをデザイン
4. 控えめなスクロールアニメーションを追加
5. 実装と最適化
6. 公開と共有

クリエイティブポートフォリオ

スキル: interactive-portfolio, 3d-web-experience, scroll-experience, branding

ワークフロー:

1. パーソナルブランドを定義
2. ユニークな体験をデザイン
3. インタラクティブ要素を構築
4. 作品をクリエイティブに紹介
5. モバイルが機能することを確認
6. 公開

関連スキル

連携すると効果的: scroll-experience, 3d-web-experience, landing-page-design, personal-branding

使用するタイミング

  • ユーザーがポートフォリオに言及または示唆する場合
  • ユーザーがパーソナルウェブサイトに言及または示唆する場合
  • ユーザーが作品の紹介に言及または示唆する場合
  • ユーザーが開発者ポートフォリオに言及または示唆する場合
  • ユーザーがデザイナーポートフォリオに言及または示唆する場合
  • ユーザーがクリエイティブポートフォリオに言及または示唆する場合

制限事項

  • このスキルは、タスクが上記の範囲に明確に一致する場合にのみ使用すること。
  • 出力を、環境固有の検証、テスト、または専門家によるレビューの代わりとして扱わないこと。
  • 必要な入力、許可、安全境界、または成功基準が欠落している場合は、立ち止まって明確化を求めること。

Individual skills in this repo

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

bg-szy/TOP-SKILLS

Brand-first landing page designer — runs a brand-identity interview (colors, typography, shape language), then generates and iterates on a polished landing page via Stitch with deployment-ready HTML. Use when the user asks to create, design, or build a landing page, homepage, or marketing page and has no established visual direction. Skip when they have a design mockup, need a dashboard or app UI, are working at component level, building a multi-page app, or restyling with known design tokens — use frontend-design instead.

bg-szy/TOP-SKILLS

Fill out Microsoft Azure Landing Zone (ALZ) Accelerator checklists by interviewing the user, mapping their Azure subscriptions, integrating IP addressing documentation, and applying Microsoft Cloud Adoption Framework best practices. Produces a completed Excel checklist (.xlsx) ready for ALZ deployment. Use this skill whenever the user mentions Azure Landing Zone, ALZ checklist, landing zone accelerator, platform landing zone configuration, ALZ bootstrap, hub-and-spoke setup, Azure network topology planning, or wants to fill out any ALZ-related checklist or configuration file. Also trigger when the user uploads an Excel file that contains tabs like "Accelerator - Bootstrap", "Accelerator - Bicep", or "Accelerator - Terraform".

bg-szy/TOP-SKILLS

Compose a premium, animated landing page section by section in Next.js + Tailwind + Motion (Framer Motion) — built on a real design system, with editorial copy and motion that feels human-crafted, not template-generated. Use when building or rebuilding a landing page, marketing site, or hero/feature/pricing/CTA sections that need to look production-ready and bespoke from day one.

bg-szy/TOP-SKILLS

Write high-converting landing page copy using proven frameworks like PAS (Problem-Agitate-Solution), AIDA, and StoryBrand. Creates headlines, value propositions, CTAs, and full page sections optimized for conversion. Use when users need landing page copy, sales page content, or marketing website text.

bg-szy/TOP-SKILLS

Optimize landing pages for conversions, performance, and SEO. Use when improving landing pages, increasing conversions, or optimizing page performance.

bg-szy/TOP-SKILLS

Review investment portfolios for risk, diversification, fees. Asset allocation recommendations, tax-loss harvesting, rebalancing.

bg-szy/TOP-SKILLS

Beads Viewer - Graph-aware triage engine for Beads projects. Computes PageRank, betweenness, critical path, and cycles. Use --robot-* flags for AI agents.

bg-szy/TOP-SKILLS

CI red? Call us. Pipeline fire brigade deploys. Use when user mentions CI failures, build errors, test failures, or pipeline issues. Do NOT load for: local builds, standard implementation work, reviews, or setup.

bg-szy/TOP-SKILLS

CASS Memory System - procedural memory for AI coding agents. Three-layer cognitive architecture with confidence decay, anti-pattern learning, cross-agent knowledge transfer, trauma guard safety system. Bun/TypeScript CLI.

bg-szy/TOP-SKILLS

Mandatory entry point: read this first for any request to make, create, edit, animate, or render a video, animation, or motion graphic, including a promo, explainer, captioned clip, title card, overlay, slideshow or interactive deck, Remotion port, or any HyperFrames HTML composition. Also use it to inspect, diagnose, validate, preview, publish, or batch-render an existing HyperFrames project. Inputs may be a website URL, GitHub PR, Figma design or URL, text or brief, existing footage, or music. It resumes project state, captures intent when applicable, selects and installs the owning workflow, and routes domain capabilities. HyperFrames is the default output framework unless the user explicitly chooses another framework for the deliverable or asks only to record a browser session.

bg-szy/TOP-SKILLS

Use when the user asks to "pre-launch check the landing page", "run a Quality-Score preflight", or "verify ad-to-page message match before launch"; produces an ad↔page continuity report — message-match gaps, above-the-fold check, page-speed read, form-friction count, mobile-render flags — as a pass/fix punch list. Not for redesigning or rewriting the page — use landing-optimizer; not for scoring the account or the RQS — use ad-account-auditor. 落地页体验预检/广告落地页一致性检查

bg-szy/TOP-SKILLS

Use when the user asks to "optimize our landing page for influencer traffic", "fix our promo-code landing page", or "improve conversion from a creator campaign"; produces a message-match audit, page-structure and social-proof recommendations, a promo-code/CTA conversion plan, and an A/B test roadmap. Not for measuring campaign results after launch — use performance-analyzer.

bg-szy/TOP-SKILLS

Audit a landing page, sales page or checkout page for conversion leaks and return a fix list ordered by expected revenue impact. Use when asked to review, critique or improve a landing page, sales page, opt-in page, product page or checkout flow, when conversion rate is low, when paid traffic is not converting, or when someone asks "why isn't this page converting" or wants a CRO / landing page review.

bg-szy/TOP-SKILLS

Landing page conversion optimization with layout rules, hero section design, and CTA psychology. Covers above-the-fold formula, social proof placement, mobile design, and F-pattern reading. Use for: startup landing pages, product pages, SaaS marketing, conversion optimization. Triggers: landing page, hero section, above the fold, conversion optimization, landing page design, cta button, hero image, landing page layout, saas landing page, product page design, conversion rate, landing page best practices

bg-szy/TOP-SKILLS

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

bg-szy/TOP-SKILLS

Landing page conversion optimization with layout rules, hero section design, and CTA psychology. Covers above-the-fold formula, social proof placement, mobile design, and F-pattern reading. Use for: startup landing pages, product pages, SaaS marketing, conversion optimization. Triggers: landing page, hero section, above the fold, conversion optimization, landing page design, cta button, hero image, landing page layout, saas landing page, product page design, conversion rate, landing page best practices

bg-szy/TOP-SKILLS

Account assets, equity and fund positions, P&L, cash flow records, account statements, margin ratios, buy-power estimates, order management, and DCA recurring investments via Longbridge (most require Trade permission). Frameworks: portfolio diagnosis, rebalancing, asset allocation, risk analysis (VaR/CVaR), performance attribution, and tax-loss harvesting. Triggers: "持仓", "账户", "盈亏", "资产", "对账单", "下单", "买入", "卖出", "撤单", "定投", "组合诊断", "再平衡", "资产配置", "风险分析", "绩效归因", "税损收割", "持倉", "賬戶", "盈虧", "對賬單", "下單", "買入", "賣出", "組合診斷", "再平衡", "稅損收割", "positions", "portfolio", "P&L", "order", "buy", "sell", "DCA", "statement", "risk analysis", "rebalancing", "tax harvesting", "我的风险", "持仓风险", "风险敞口", "資產", "資產配置", "風險分析", "績效歸因", "撤單

bg-szy/TOP-SKILLS

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

bg-szy/TOP-SKILLS

Process video files with audio extraction, format conversion (mp4, webm), and Whisper transcription. Use when user mentions video conversion, audio extraction, transcription, mp4, webm, ffmpeg, or whisper transcription.

bg-szy/TOP-SKILLS

Using the Wonda CLI to generate images, videos, music, and audio from the terminal — plus LinkedIn, Reddit, and X/Twitter research and automation

関連スキル