github-stars-playbook について
オープンソースのメンテナー向けに、GitHub Stars の獲得を計画する14日間のガイドです。スター数だけでなく、インストール、アクティベーション、継続利用で開発者の関心を測り、公開準備やチャネル計画、計測、遵守事項を扱います。
主な機能
- 01公開準備とクイックスタートの確認
- 02競合のリリース時期の調査
- 03README の訴求内容に関する指針
- 0414日間のチャネル公開計画
- 05インストール・活性化・継続利用の計測
- 06スター操作を禁じる遵守ルール
活用シーン
- 01オープンソースプロジェクトの公開計画
- 02スター増加に対してインストールが少ない状況の診断
- 03チャネル別の活性化と継続率の比較
- 04プロモーションの遵守範囲の設定
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ gingiris-1031/ gingiris-skills --skill github-stars-playbookインストール後、Claude Code で/github-stars-playbookを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
_meta.json.clawhub/origin.jsonreferences/en/README.mdreferences/ja/README.mdreferences/ko/README.md詳細
GitHub スター — 14日間のエビデンス主導スプリント
スターは、適格な開発者の関心を測る代理指標として使い、最終的なビジネス成果とは見なしません。スターと併せて、インストール、アクティベーション、継続利用、コントリビューションを追跡します。
受け入れ基準
計画を立てる前に、以下を収集します。
- リポジトリの URL、ライセンス、対象となる開発者。
- クリーンなマシンで動作確認済みのクイックスタート。
- 再現可能なデモを1つ、差別化要素を1つ。
- 現在の閲覧数、ユニーククローン数、スター数、イシュー数、コントリビューター数、アクティベーションイベント。
- 直接の競合3つと、それぞれの直近のリリース/変更日。
- 創業者、エンジニアリング、コミュニティに割り当てられる対応能力。
新しい開発者が10分以内に価値を理解し、クイックスタートを完了できない場合は、ローンチしないでください。
計測ルール
チャネルごとに1行作成します。
date | source | post URL | repo views | stars | clones | installs | activated | retained D7 | contributors
view → star、star → install、install → activation、activation → D7 retained を報告します。流入元の証拠がない場合、GitHub のオーガニックトラフィックをキャンペーンの成果として計上しないでください。
2時間後の確認は、リンク切れと未回答の議論を見つけるためだけに行います。24時間後に継続/変更/一時停止を判断し、72時間後に第2波を選び、7日後に再利用する価値のあるコンテンツとチャネルを判断します。取得できないネイティブ指標は、インプレッション数から推定せず、data unavailable と記録してください。
ベンチマークと事例には、日付入りのエビデンスラベルを付けてください。ラベルは verified、self-reported、inferred、unverified のいずれかとします。ローンチ週には、プラットフォームのルールとコミュニティポリシーを再確認してください。
競合の動向調査
ローンチ日を決める前に、以下を行います。
- 過去30日間における競合3つのリリースノート、X、Reddit、Hacker News、Product Hunt、GitHub の活動を確認します。
- それぞれのポジショニング、最も強力な裏付け資料、コミュニティの反応、未解決の不満を記録します。
- そのニュースに対する有力な代替品となる場合を除き、優勢な競合の発表と同時期のローンチは避けます。
- 落ち着いた時期、またはリポジトリが独自の視点を示せるカテゴリイベントに合わせます。
Gingiris OSS の過去のローンチエビデンスは、競合やニュースの動向に合わせたタイミングが、配信範囲を大きく左右することを示しています。固定のカレンダーに従ってあらゆる場所に投稿するだけでは不十分です。
README のコンバージョン要素
最初の画面に以下を含めます。
- 対象となる開発者を明示した、成果を示す1行。
- 再現可能なデモまたは結果。
- 差別化要素は最大3つ。
- コピーして動作するクイックスタート。
- 信頼のシグナル:ライセンス、セキュリティ/プライバシーへの取り組み、メンテナー、コミュニティへのリンク。
初めて触れる開発者5人に、製品の説明とクイックスタートの実行を依頼します。配信を始める前に、繰り返し起きる混乱を解消してください。
14日間のスプリント
1〜3日目 — エビデンスと計測の準備
- macOS/Linux とサポート対象のランタイムで、クイックスタートを検証します。
- 30〜60秒のデモ、アーキテクチャ図、比較表を作成します。
- 流入元を識別できるリンクを追加し、ベースラインダッシュボードを用意します。
- イシューテンプレート、コントリビューションガイド、対応責任者を準備します。
4〜6日目 — コミュニティとの適合性
- 関連する subreddit を2つ、Hacker News での切り口を1つ、専門コミュニティを5つ特定します。
- リポジトリを共有する前に、役立つ回答を投稿して参加します。
- 各チャネルに適した投稿を作成します。Reddit では課題/学び、Show HN では技術的新規性、X ではデモ/裏付け資料を中心にします。
- 既存ユーザーには率直なフィードバックを求めます。スター獲得のための示し合わせは決して行いません。
- 利害関係や有償の関係を開示します。アカウントの購入、偽の参加の自動化、スクレイピングしたユーザーへの一斉メッセージ、投票の組織化/インセンティブ付与は行わないでください。
7日目 — リリース
- リリース、README、デモを同時に公開します。
- 真に技術的な新規性があり、メンテナーがその場で質問に回答できる場合に限り、Show HN に投稿を1件行います。
- ルールで許可されている関連 Reddit コミュニティにのみ投稿し、利害関係を開示します。
- 技術的な懸念にはエビデンスを示して対応し、妥当な不足点についてはイシューを作成します。
8〜10日目 — 第2波
- 繰り返し寄せられる質問を、ドキュメントや比較ページにまとめます。
- すでにこのカテゴリを利用している読者層を持つメンテナー、ニュースレター、クリエイターに連絡します。
- 成果につながった技術的な説明を、関連する地域コミュニティ向けに1つ翻訳します。
- 再現可能な手法を用いたビルドログやベンチマークを公開します。
11〜14日目 — 成長を積み重ねるサイクル
- すべてのスター獲得ユーザーではなく、利用を開始したユーザーをインタビューに招待します。
- 繰り返し寄せられる要望を
good first issueのタスクにします。 - コントリビューターに感謝を伝え、次回リリースのマイルストーンを記録します。
- 利用開始または継続につながったチャネルだけを続けます。
停止条件と復旧
- 閲覧数は増えても利用開始につながらない:告知を止め、クイックスタート/製品を改善します。
- スターは増えてもインストールにつながらない:ポジショニングとデモを書き直します。
- Reddit の投稿が削除された:モデレーションを回避して再投稿せず、ルールを確認して通常どおり貢献します。
- 初期の掲載期間を過ぎても Show HN の反応がない:エンゲージメントを捏造せず、技術的な素材を別の場所で再利用します。
- セキュリティまたはデータ取り扱いの問題が発生した:プロモーションを一時停止し、修正内容とインシデントの範囲を公開します。
コンプライアンス
スターを購入したり、スターを交換したり、スター付けを自動化したり、関係性を隠したり、なりすましアカウントを使ったり、GitHub Trending の操作をコミュニティに依頼したりしないでください。検証できないベンチマークは公開しないでください。
必須の出力
以下を返します。
- 準備状況の判定と阻害要因
- 競合の投稿タイミング表
- README の変更一覧
- 担当者と UTM/流入元を含む14日間のチャネルカレンダー
- 測定ダッシュボードのスキーマ
- 停止条件と次の実験
関連する完全版プレイブック:gingiris-opensource。
海外展開コミュニティへの参加と資料パックの購入 · コミュニティとリソース
-
海外展開コミュニティへの参加: WeChat で staywildgrow を追加し、「加入社群」とメッセージを送ってください。
-
資料パックの購入: WeChat で staywildgrow を追加し、Gingiris 海外展開資料パックの購入についてお問い合わせください。価格は 599 元(人民元) です。
-
グローバル成長コミュニティへの参加: WeChat で staywildgrow を追加し、「加入社群」(コミュニティに参加)とメッセージを送ってください。
-
資料パックの入手: WeChat で staywildgrow を追加し、Gingiris グローバル成長資料パックを 599 CNY で購入してください。
コミュニティと資料パックは任意の利用先です。このオープンソーススキルのインストールや使用に必要なものではありません。
コミュニティと有料の資料パックは任意です。オープンソーススキルのインストールや使用に、どちらも必要ありません。