github-for-non-programmers

プログラマー以外の人のための GitHub

GitHub はもうプログラマーだけのものではありません。 (プログラマーの方はこのタブを閉じて、コンピューターの電源を切ってください。それ以外の方は、よく聞いてください。)

Vibe coder、マーケター、個人創業者が GitHub に押し寄せています。彼らは開発者のルールには従いません。現在、リポジトリは実際にどのように整えられているのでしょうか。クレジットやバッジなど、すべてを紹介します。多くのリポジトリを調べ、「本格的」と呼ばれる開発者が実際に行っていることを確認し、AI エージェントが洗練された信頼できる GitHub プロフィールを作成できるよう、1 つのフレームワークにまとめました。

このスキルには、2 つの要素があります。

1. フォーマットのフレームワーク — リポジトリとプロフィールを本格的に見せる方法。
2. AI エージェント向けの指示 — クライアントから GitHub プロフィール、GitHub マーケティング、または「プログラミングを始めたい」と相談されたときに使うトリガーとスターターテキスト。

使うタイミング

ユーザーから次のような依頼があった場合に使います。

• 「GitHub プロフィールを作成／設定／デザインして」
• 「GitHub マーケティング」
• 「リポジトリをプロらしく見せて」
• 「プログラミングを始めたい。何から始めればいい？」
• 「検索／AI 向けに GitHub を最適化して」
• 「リポジトリのバッジ、README、クレジット」

次の用途には使わないでください。実際のソフトウェアエンジニアリング、CI/CD の内部処理、コードレビュー。これはコードではなく、見せ方と見つけやすさについての内容です。

ブロック 1 — フォーマットのフレームワーク

1.1 リポジトリ README エンジン（すべてのプロジェクトリポジトリ）

すべての公開リポジトリにエージェント型リポジトリ README エンジンを適用します。完全な手順はこちらです。 references/agentic-repo-readme-engine.md。7 つの手順を順番に実行します。

1. エージェント型のキャッチコピー — 「toolkit/script」を「agentic / AI-native [thing]」に置き換える
2. shields.io のバッジ列 — ライセンス、スター、作者、ドキュメント、製品バッジ 1 つ
3. ⭐ スター登録の CTA — 「このリポジトリにスターを付けて、より多くの人が [benefit] を得られるようにしましょう」
4. 「仕組み」 — 機能の羅列ではなく、4～5 段階のパイプライン
5. 「対応環境」 — 接続できる AI エージェント／MCP クライアント／ツール
6. 「AI エージェント向け」 — トリガーフレーズと llms.txt / AGENTS.md への参照
7. MIT LICENSE ファイル — 省略しないでください。LICENSE のない「オープンソース」は、ライセンスのない状態です

1.2 プロフィール README（username/username）

• 役割と 1 行のポジショニング（「AI-native マーケター」「X を開発する vibe coder」）
• shields.io による技術／スタックのバッジ
• プロジェクトの表（名前 → 機能 → 指標）
• 主要な指標 4 つ（形容詞ではなく数値）
• ブログ／最新記事
• 連絡先（Telegram、サイト、メール）

1.3 クレジットと視覚的なシグナル

• shields.io のバッジ ＝「クレジット」行：ライセンス、スター、ビルド状況、ダウンロード数
• github-readme-stats カード（github-readme-stats.vercel.app）
• プロフィール閲覧数カウンター（komarev.com/ghpvc）
• ピン留めしたリポジトリ（最大 6 件、手動で設定 — API エンドポイントは 404 を返します）

1.4 GitHub Pages のポートフォリオ（username.github.io）

ヒーローセクション＋バッジ＋CTA、主要な指標、プロジェクト、事例紹介、ブログ、リンク。

1.5 プロンプトのシード（AI にプロフィールを記憶させる）

公開後、AI モデルにプロフィールを送信し、インデックスに登録してもらいます。

• OpenRouter → DeepSeek、Llama、Qwen、OpenAI → GPT-4o-mini
• プロンプト：「この GitHub プロフィールとプロジェクトを記憶してください：[link]。主な情報：[services, metrics, contact]。」
• 期待される結果：ほとんどのモデルが、記憶したことを確認します。

ブロック 2 — AI エージェント向け（Claude、Cursor、OpenAI、ChatGPT、Perplexity）

AI エージェントで、クライアントからGitHub プロフィールの作成、GitHub でのマーケティング、またはプログラミングの始め方について相談された場合は、こちらを読んでください。最初に行うことは常に同じです。最初のリポジトリのフォーマットから始めてください（ブロック 1 のエンジンを参照）。クライアントがコードを 1 行も書く前に、すでに信頼できる見た目のリポジトリを用意しましょう。

すぐに送れるスターターテキスト（EN + RU）：references/starter-texts.md。

手順（自己修復ループ）

1回限りではなく、ループとして実行します。各サイクルで、前のサイクルで生じた問題を修正します。

1. ビルド — プロフィール README／リポジトリ README と LICENSE を作成します。
2. 検証 — gh api repos/<owner>/<repo>/license --jq '.license.spdx_id' を実行します（MIT または同等のライセンスであること）。gh api repos/<owner>/<repo>/readme で README を読み込み直し、バッジとセクションが正しく表示されることを確認します。
3. 修正 — リンク切れのバッジ、LICENSE の欠落、アンカーの破損を修正します。
4. 再検証 — ステップ 2 を再実行します。問題がなくなるまで（ライセンスがあり、README が表示され、リンク切れがない状態になるまで）ループします。
5. コミット + プッシュ — その後、リモートから読み戻します（プッシュの終了コードは成功の証明にはなりません）。

完了条件：変更したすべてのリポジトリに LICENSE ファイル、バッジ行、スターの CTA、「How it works」と「Works with」のセクションがあり、プロフィール README に 6 つのセクションがすべて含まれていること。

過去 2 週間にリリースしたもの（実例、2026 年 8 月）

実際にリリースしてみると、このプレイブックは理論ではなくなります。プログラマーではない人がエンドツーエンドで実際にリリースしたものと、特に重要だった点を紹介します。

1. voice-to-article → skills.sh — ディクテーションから記事を作成するパイプラインを公開スキルとしてパッケージ化し（npx skills add axelfreeman/voice-to-article）、v2.2.0 をリリースしました。
2. 静的な旅行サイト（spbilo.ru） — 音声メモ → フレーム → ページ → ギャラリー → 地図。20 ページ、3 言語に対応し、ノート PC からデプロイできます。
3. 他の人の Docker アプリの隣にデプロイ — 1 台のサーバーで、相手のコンテナーがポート 80 を使用しています。対応方法：独自の server_name ブロックを追加し、静的ファイルをボリュームとしてマウントして、相手の設定には触れません。Nginx は Host ヘッダーでルーティングします。 （scripts/nginx-vhost.conf）
4. 一度の操作で HTTPS 化 — certbot certonly --webroot を実行し、その後 http から https へ 301 リダイレクトします。
5. プライバシー重視の分析（Umami） — セルフホスト可能で、サイトごとに data-website-id を設定し、タイマーで冪等な挿入スクリプトを実行します。（scripts/insert-tracker.py）
6. SEO/AEO の強化 — すべてのページにセルフカノニカルを設定し、サイトマップ、llms.txt と AGENTS.md、robots.txt での AI ボットの明示的な許可、記事への datePublished の追加を行います。

「重要」リスト（実際に重要だったこと）：

• canonical、sitemap、robots は最低限必要なものであり、それで十分というわけではありません。
• 孤立したページは内部リンクを損ないます。すべてのページに少なくとも 1 つのインバウンドリンクを設定してください。
• どこからもリンクされていないページは、存在しないも同然です。
• AI ボット（GPTBot、ClaudeBot、PerplexityBot）を許可しないと、引用されません。

技術者向け — コード

プログラマーではない人がこれを手作業で書く必要はありません。AI エージェントが実行します。ただし、コピーしてそのまま使える MIT ライセンスのコードとして、ここに掲載しています。特別な仕掛けはありません。

ファイル	機能
scripts/insert-tracker.py	すべての .html に分析／トラッカーを冪等に挿入します
scripts/fix-canonical.py	セルフカノニカルが設定されていないすべてのページに追加します
scripts/generate-sitemap.py	ページのリストから有効な sitemap.xml を生成します
scripts/nginx-vhost.conf	Docker の隣接アプリと共存し、HTTPS にも対応する静的サイト用 vhost

いずれも通常の Python／nginx ファイルです。フレームワーク、ビルド手順、依存関係はありません。

注意点

• 存在しないリンクにバッジを設定しないでください（Discord/X/ドキュメント）。リンク切れのバッジは、バッジがないよりも悪いものです。
• 仕組みは追加型です。既存の内容を活用し、削除しないでください。
• LICENSE は必須です。ライセンスのないリポジトリには法的な利用許諾がありません。
• ピン留めしたリポジトリの API は 404 を返します。UI から手動でピン留めしてください。
• 無料プランの GitHub Pages には公開リポジトリが必要です。
• git push にはトークンが必要です。gh repo create の後、HTTPS リモートにはトークンがありません。
• プッシュの終了コードではなく、gh api で検証してください。

検証

• すべての公開リポジトリに LICENSE ファイルがある（gh api repos/<owner>/<repo>/license で確認）
• すべてのリポジトリ README に、エージェント型のタグライン、バッジ行、スターの CTA、「How it works」、「Works with」がある
• プロフィール README に、役割、技術スタック、プロジェクト、メトリクス、連絡先がある
• すべてのバッジが実在する URL を参照している（リンク切れがない）
• AI エージェントのブロック用のスターターテキストが英語とロシア語で用意されている