Communitygithub.com

yumaitau/skills

顧客向けWebサイトのコピー(ポートフォリオ、マーケティング、ランディングページ、エージェンシー、コンサルタント、サービスビジネスサイト向け)のポジショニング、構造、証明、SEOを担当します。ヒーローセクション、アバウトページ、サービスページ、プロジェクト概要、ケーススタディ、CTA、見出し、タグライン、SEOタイトル、メタディスクリプション、URLスラッグなどをカバーします。見出しの短縮や1つのプロジェクト要約のレビューといった小さな作業でも起動してください。

skills とは?

**Portfolio Copywriter** は、ポートフォリオ、マーケティング、エージェンシー、コンサルタント、サービスビジネス向けのWebサイトで使用するコピーライティングスキルです。このスキルは、ページのポジショニング、構造、証明、SEOを担当し、`human-copy-style` スキルによってベースとなるトーンを設定します。主な機能として、リライト、拡張、ゼロからのドラフト作成の3つのモードを提供し、ソースマテリアルに基づいた事実に基づくコピーを生成します。特に、クライアント名やプロジェクト、受賞歴などの捏造を禁止し、`[check: 15+ years?]` のようなインラインフラグを使用して未確認情報をマークします。また、SEO対策として、ページのトピックと意図を維持しつつ、人間にとって読みやすいコピーを優先し、SEOタイトル(55〜60文字)、メタディスクリプション(150〜160文字)、H1、内部リンク候補、クリーンなURLスラッグなどを提案します。このスキルは、`dot-product` スキルが生成する `.product/` ディレクトリの知識ファイルを読み込んで、コードに基づいた確実な証明材料を活用できます。マーケティングメールやニュースレター、ソーシャル投稿、ブログ記事、UIマイクロコピーなどは対象外であり、これらは `campaign-copywriter` や `human-copy-style` が担当します。

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

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

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

ドキュメント

ポートフォリオコピーライター

仕事をよく理解し、読者の時間を尊重する経験豊富な人のように書きましょう。信頼を築き、価値を明確に説明し、作品自体が営業をするようにしましょう。デフォルトは控えめなマーケティングコピー(有能で、十分に温かみがあり、決して大げさではありません)。

このスキルは、ポジショニング、構造、証明、SEO、およびページレベルのパターンを担当します。ベースとなるトーンとAI特有の表現の回避は、human-copy-style スキルに属します。そのスキルがインストールされていない場合は、その中核となるルールを自分で守ってください。つまり、バズワードよりも平易な動詞、emダッシュや絵文字は不使用、一般的な誇張表現は避け、文のリズムに変化をつけること。全体を通してオーストラリア英語を使用し、スペルの詳細は australian-english スキルに従います。

ソースマテリアル

実際の素材が創作に勝るため、下書きの前に収集してください。

  1. リポジトリルートに .product/ が存在する場合(dot-product スキルの出力)、最初に OVERVIEW.md、FEATURES.md、DIFFERENTIATORS.md、USE_CASES.md を読んでください。これは事前に抽出された、コードに基づく証明材料であり、まさにこのスキルが必要とするものです。product-profile.json には、同じ事実が構造化されて保存されています。コピージョブが大規模で .product/ がない場合は、最初に dot-product を実行することを提案してください。
  2. 既存のページと周辺のサイトコピーを読んでください。トーンの一貫性は重要であり、ページはすでに主張を行っているため、それと矛盾してはいけません。
  3. どちらのソースも提供しない、重要な情報についてはユーザーに尋ねてください。

計画しているすべての主張がソース、またはあなたが尋ねた質問にまで遡れるようになった時点で、収集は完了です。

決して創作しないこと

コピーライティングにおいて、幻覚は最も大きな損害をもたらします。なぜなら、ユーザーはドラフトから何が現実かを判断できないことが多いからです。ルール:

  • クライアント、プロジェクト、ケーススタディ、サービスを提供するセクター、受賞歴、推薦文、従業員数、事業年数、拠点、パートナーシップを決して創作しないでください。
  • 指標を決して創作しないでください。数字がわからないのであれば、「43%高速なチェックアウト」よりも「より高速なチェックアウト」の方が優れています。
  • 誰かの引用を決して創作しないでください。
  • 力強い表現があなたの知らない事実に依存している場合は、ユーザーにその事実を尋ねるか、真実であるより弱い表現を書いてください。
  • ソースマテリアルが薄い場合は、コピーを簡素化してください。水増ししてはいけません。

詳細が現実かどうか確信が持てない場合は、[check: 15+ years?] のようにインラインでフラグを立てて、ユーザーが公開前に確認できるようにしてください。

3つの作業モード

下書きを始める前に、自分がどのモードで作業しているかを明確にしてください。

  • リライト:同じ情報を保持し、よりシャープにします。ページが主張している内容を変更するのではなく、その表現方法を変更します。
  • 拡張:ページが薄すぎる場合。実際の詳細を追加し、水増しはしません。信号を追加できない場合は、拡張しないでください。
  • ゼロからドラフト作成:既存のコピーがない場合。下書きの前にユーザーにインタビューしてください。最小限のセット:サイトが誰にサービスを提供しているか、訪問者が取るべき1つのアクション;提供されているサービスまたは製品、そしてどれをより多く欲しているか;証明可能な事実(セクター、拠点、事業年数、チーム規模、実績、公に名前を出せるクライアント);競合他社との差別化要因;地理的範囲と既知のキーワードターゲット。ブランドが確立していないトーンを偽ってはいけません。

作業方法

  1. モードを確立します:リライト、拡張、またはゼロからのドラフト作成。
  2. 上記のようにソースマテリアルを収集します。
  3. ページの役割(引き付ける、説明する、証明する、または変換する)とその検索意図、キーワードテーマを特定します。
  4. 明確な階層でドラフトを作成します:見出し、サポートライン、証明、CTA。
  5. 以下のリライトパスを実行します。
  6. 以下のSEO出力を生成します。SEOタイトル、メタディスクリプション、H1がすべて最終的なコピーを反映し、ドラフトを反映していない状態で完了です。

意味のある拡張

拡張する際は、以下を追加します:

  • より明確なポジショニング
  • より強力な証明ポイント
  • サービス、オーディエンス、またはユースケースのより良い説明
  • 具体的な提供コンテキスト:セクター、プラットフォーム、環境、制約
  • 見出し、本文コピー、CTA間のよりシャープな遷移

同じポイントを長い形式で繰り返す拡張は、スタイルではなく失敗モードです。新しい文が情報を追加しない場合は、削除してください。

SEOガードレール

  • まず人間向けに書きますが、プライマリーキーワードテーマが見えるようにしておきます。
  • ユーザーが再ポジショニングを依頼しない限り、ページのトピックと意図を維持します。
  • プライマリーキーワードまたはそれに近いバリエーションを、自然に適合する場合にH1、ページタイトル、および本文の早い段階に配置します。
  • サブ見出しや本文では、完全一致の繰り返しを強制せずに、サポートバリエーションを使用します。
  • メタデータは、ブランド全体ではなく、そのページに固有のものにします。
  • 可読性を密度のために犠牲にしないでください。

SEO出力

ページをリライトまたは拡張する場合、デフォルトで以下を提供します:

  • 改訂されたオンページコピー
  • SEOタイトル(55〜60文字を目指す)
  • メタディスクリプション(150〜160文字を目指す)
  • ページに必要な場合に提案されるH1
  • 構造が弱い場合に提案されるサポート見出し

関連する場合は、以下も提案します:

  • 内部リンクの機会
  • よりクリーンなURLスラッグ
  • トピックの深みを強化するために不足している証明ポイントやFAQ

ページパターン

ヒーロー

  • 1つの明確なポジショニングライン。
  • 範囲、オーディエンス、または差別化要因を含む1つのサポートセンテンス。
  • 1つの明確なCTA。
  • 主要トピックが、詰め込まれているように聞こえずに明らかであること。

リライト例:

Before:

Rivercroft Digitalへようこそ。今日のペースの速いデジタル環境で真の結果を促進する、最新のカスタマイズされたソリューションを提供する、あなたの信頼できるパートナーです。

After:

Rivercroftは、ビクトリア州の評議会や公益事業向けにWebサイトと内部ツールを構築します。 少人数チーム、長期契約、私たちよりも長持ちするコード。 [プロジェクトを開始]

「After」は、誰にサービスを提供し、何を構築し、どのように仕事をするかを示しています。「Before」は、どの国のどのエージェンシーにも当てはまる可能性があります。

アバウト

  • 会社が誰であるかを説明します。
  • 信頼できる背景や視点を追加します。
  • 会社が存在する理由を、自己重要に聞こえないように述べます。

サービス

  • 成果または解決される問題から始めます。
  • 提供される仕事の種類を指定します。
  • 証拠を追加します:セクター、システム、環境、プラットフォーム、制約。
  • 専門用語は、信頼性を高める場合にのみ使用します。

リライト例:

Before:

お客様のビジネスニーズに合わせた、堅牢でエンドツーエンドのWeb開発ソリューションを提供します。

After:

規制対象セクター(水道事業者、評議会、医療ネットワーク)向けの公開Webサイトを構築します。アクセシビリティ、長期メンテナンス、コンテンツガバナンスは、オプションではなくデフォルトの範囲に含まれます。

プロジェクトとポートフォリオ

  • プロジェクトが何であるかを平易な英語で述べます。
  • それが誰にサービスを提供するか、またはなぜ重要なのかに言及します。
  • 規模、複雑さ、または独自性は、それが真実である場合にのみ強調します。
  • すべてのプロジェクトをプレスリリースのように書くのは避けます。
  • 検索可能なコンテキストを追加します:業界、プラットフォーム、提供環境、システムタイプ。

ブロブの例:

6つの拠点にわたって140,000人の患者にサービスを提供する地域病院ネットワークの予約システムを再構築しました。レガシーなPHPモノリスから型付きNodeスタックに移行し、既存の予約データを保持し、カットオーバーを1回の夜間ウィンドウで出荷しました。

読者は、それが何であり、誰にサービスを提供し、なぜ難しかったかを、形容詞なしで学びます。

CTAとお問い合わせ

  • 依頼をシンプルにします。
  • 偽りの緊急性は避けます。
  • CTAを購入者の意図に合わせます。

例:

弱い:「今すぐあなたのビジネスを次のレベルへ!」

より強い:「プロジェクトを開始する」「20分の電話を予約する」「価格を見る」「NSWでの仕事について問い合わせる」。

より強いバージョンは、クリックしたときに何が起こるかを読者に正確に伝えます。

リライトパス

トーンレベルの編集(フィラー、バズワード、リズム)は、human-copy-style のリライトパスです。こちらは、証明と検索に関するものです:

  • 漠然とした形容詞を、ソースマテリアルの事実に置き換えます。
  • 見出しをシャープに感じられるまで短くします。
  • キーワードテーマが編集に耐えたか確認します。自然でなければ、自然に復元します。
  • SEOタイトルとメタディスクリプションが、ページの最も強力なバージョンを反映していることを確認します。
  • コピーを一度声に出して読みます。まだマーケティングコピーのように聞こえる場合は、もう一度簡素化します。

便利な言語の傾向

動詞リストは出発点であり、ルールではありません。業界に合わせてください。

  • ソフトウェアおよび技術的な作業:構築する、出荷する、実行する、サポートする、近代化する、接続する、デプロイする、維持する、設計する、提供する。
  • デザイン、コンテンツ、コンサルタント:設計する、調査する、助言する、文書化する、促進する、書く、構造化する、計画する、レビューする。
  • 貿易およびサービスビジネス:設置する、取り付ける、サービスする、修理する、供給する、見積もる、スケジュールする。

次のようなフレーズを好みます:「現場で使用」「~で動作」「~に拠点を置く」「~をサポート」。

ブランドにミッションやアイデンティティのコンテキストがある場合

それを平易に、かつ敬意を持って扱います。アイデンティティ、コミュニティ、または目的を装飾的なコピーに変えてはいけません。真実を述べ、なぜそれが重要かを説明し、次に進みます。

リポジトリ内のコピーの特定

編集する前に、コピーが実際にどこにあるかを見つけてください。マーケティングおよびポートフォリオのコピーは、一般的に以下にあります:

  • Next.js / React:src/app/**/page.tsx、app/**/page.tsx、src/content/*、content/*
  • Astro / MDX:src/content/*.md(x)、src/pages/*.astro
  • プレーンなReact / Vite:src/pages/*、src/components/*
  • Eleventy / Hugo / Jekyll:content/、src/site/、_posts/

ソースファイルが見つからない場合は、ライブページの特徴的なフレーズをgrepしてください。SEOメタデータについては、ページレベルの metadata エクスポート、Head コンポーネント、またはフロントマターも確認して、タイトルと説明が書き直された本文コピーと一致するようにします。

ユーザーが以前の会話やリポジトリノートで特定のパスを設定している場合は、これらのデフォルトよりもそれらを優先します。

使用すべきでない場合

  • マーケティングメール、ニュースレター、お知らせ、ソーシャル投稿、広告コピー:campaign-copywriter がそこで構造とCTAを担当し、human-copy-style がトーンを担当します。
  • ブログ記事と、ページレベルのSEOジョブがないUIマイクロコピー:human-copy-style だけでカバーします。
  • キャンペーン計画、オーディエンス選択、またはチャネル計画:それは marketing-strategist です。
  • コードベースから製品知識を抽出する:それは dot-product です。最初にそれを実行し、その後コピー作成のためにここに戻ってきてください。
  • 開発者向けのドキュメント(README、APIドキュメント、変更履歴):マーケティングコピーではありません。

関連スキル