github-presence

GitHub での存在感

GitHub は、開発者がプロジェクトを試す前に評価する場所です。このスキルでは、README の最適化、プロフィール README、トピックや awesome リストを通じた見つけやすさ、マーケティングへの GitHub 機能の活用方法を扱います。

---

始める前に

1. .agents/developer-audience-context.md が存在する場合は読みます
2. 現在の GitHub での存在感（プロフィール、ピン留めしたリポジトリ、README）を監査します
3. GitHub は技術的な評価の最初の場となることが多いため、それに応じて最適化します

---

README の構成

優れた README の構成要素

セクション	目的	必須？
ロゴ／バナー	ブランド認知、視覚的な魅力	推奨
バッジ	信頼性やステータスをすばやく示す	推奨
一文での説明	何をするものかを一文で説明	必須
代表的な例	「どのようなものか」をすぐに示す	強く推奨
機能	代替手段ではなく、これを使う理由	必須
クイックスタート	2 分以内で実行できるようにする	必須
インストール	すべてのインストール方法	必須
使い方	基本的な使用例	必須
ドキュメント	ドキュメント全文へのリンク	必須
コントリビューション	貢献方法	推奨
ライセンス	法的な明確さ	必須

README テンプレート

<div align="center">
  <img src="logo.svg" alt="Project Name" width="200">
  <h1>Project Name</h1>
  <p><strong>One compelling sentence explaining what this does.</strong></p>

  
  <a href="https://github.com/org/repo/actions"><img src="https://github.com/org/repo/workflows/CI/badge.svg" alt="CI"></a>
  <a href="https://www.npmjs.com/package/name"><img src="https://img.shields.io/npm/v/name.svg" alt="npm version"></a>
  <a href="https://github.com/org/repo/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License"></a>
  <a href="https://discord.gg/invite"><img src="https://img.shields.io/discord/123456789" alt="Discord"></a>

  <br>
  <br>

  <a href="https://docs.example.com">Documentation</a> •
  <a href="https://example.com">Website</a> •
  <a href="https://discord.gg/invite">Discord</a>
</div>

---

## Why Project Name?

- **Feature 1** — Brief explanation
- **Feature 2** — Brief explanation
- **Feature 3** — Brief explanation

## Quick Start

```bash
npm install project-name

import { thing } from 'project-name';

const result = thing.doSomething();
console.log(result);

インストール

npm

npm install project-name

yarn

yarn add project-name

pnpm

pnpm add project-name

使い方

基本的な例

// Code example with comments

応用例

// More complex example

ドキュメント

ドキュメント全文は docs.example.com でご覧いただけます。

• はじめに
• API リファレンス
• 例

コントリビューション

コントリビューションを歓迎します！詳細は CONTRIBUTING.md をご覧ください。

ライセンス

MIT © Your Name

---

## Badges That Matter

### Trust Signal Badges

| Badge | What it shows | When to use |
|-------|--------------|-------------|
| CI/Build status | Code quality | Always |
| Version | Latest release | Always for packages |
| License | Legal clarity | Always |
| Downloads/installs | Adoption | When impressive |
| Coverage | Test quality | If > 70% |
| Security | Audit status | If you have it |

### Community Badges

| Badge | Source | Purpose |
|-------|--------|---------|
| Discord members | shields.io | Show active community |
| GitHub stars | shields.io | Social proof |
| Contributors | shields.io | Open source health |
| Last commit | shields.io | Project activity |

### Badge Services

| Service | URL | Best for |
|---------|-----|----------|
| Shields.io | shields.io | Most badges |
| Badgen | badgen.net | Fast, minimal |
| GitHub badges | Native | Actions, issues |

### Badge Examples

```markdown

![CI](https://github.com/org/repo/workflows/CI/badge.svg)


[![npm](https://img.shields.io/npm/v/package-name.svg)](https://www.npmjs.com/package/package-name)


[![Downloads](https://img.shields.io/npm/dm/package-name.svg)](https://www.npmjs.com/package/package-name)


[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)


[![Discord](https://img.shields.io/discord/SERVER_ID?color=7289da&logo=discord&logoColor=white)](https://discord.gg/invite)


[![GitHub stars](https://img.shields.io/github/stars/org/repo?style=social)](https://github.com/org/repo)

---

プロフィール README

プロフィール README の設定

1. ユーザー名と同じ名前のリポジトリを作成します（例：github.com/yourname/yourname）
2. README.md ファイルを追加します
3. これがプロフィールページに表示されます

プロフィール README の構成

# Hi, I'm [Name] 👋

[One sentence about what you do]

## What I'm Working On

- 🔭 Building [project] — [brief description]
- 🌱 Learning [technology]
- 💬 Ask me about [expertise areas]

## Projects

| Project | Description | Stars |
|---------|-------------|-------|
| [Project 1](link) | Brief description | ![Stars](badge) |
| [Project 2](link) | Brief description | ![Stars](badge) |

## Recent Blog Posts





## Connect

[![Twitter](https://img.shields.io/badge/-Twitter-1DA1F2?style=flat&logo=twitter&logoColor=white)](https://twitter.com/handle)
[![LinkedIn](https://img.shields.io/badge/-LinkedIn-0077B5?style=flat&logo=linkedin&logoColor=white)](https://linkedin.com/in/handle)

## GitHub Stats

![Your GitHub stats](https://github-readme-stats.vercel.app/api?username=yourusername&show_icons=true)

プロフィール README のベストプラクティス

すること	しないこと
ざっと読めるようにする	段落形式で書く
代表的なプロジェクトを紹介する	すべてを列挙する
現在の取り組みを含める	内容を古いままにする
連絡方法を記載する	連絡しにくくする
個性を表現する	ありきたりにする

---

見つけやすさ

GitHub トピック

トピックは、リポジトリを見つけてもらうためのものです。検索向けに最適化しましょう。

トピックの戦略	例
テクノロジー	javascript、rust、python
フレームワーク	react、nextjs、django
用途	cli、api、testing
カテゴリー	developer-tools、devops
課題	authentication、caching

トピックを追加する：リポジトリの設定 → Topics（最大 20 個）

検索の最適化

GitHub の検索では、次の項目が考慮されます。

1. リポジトリ名 — 主なキーワードを含めます
2. 説明 — 350 文字以内で、キーワードを豊富に含めます
3. README の内容 — 全文がインデックス化されます
4. トピック — カテゴリーの一致
5. 言語 — 自動検出

Awesome リスト

Awesome リストに掲載されると、トラフィックと信頼性の向上につながります。

手順	アクション
1	関連する awesome リストを探します（「awesome + [topic]」で検索）
2	リストの要件（品質、活動状況、ドキュメント）を確認します
3	プロジェクトが基準を満たしていることを確認します
4	リストのガイドラインに従って PR を送ります
5	気長に待ちます — 選定には時間がかかります

開発者ツール向けの人気の awesome リスト：

• awesome-cli-apps
• awesome-selfhosted
• awesome-nodejs
• awesome-python
• awesome-go
• awesome-rust
• awesome-devops

---

マーケティングに活用する GitHub Actions

README の自動更新

# .github/workflows/readme-update.yml
name: Update README

on:
  schedule:
    - cron: '0 0 * * *'  # Daily
  workflow_dispatch:

jobs:
  update:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      # Example: Update blog post list
      - uses: gautamkrishnar/blog-post-workflow@master
        with:
          feed_list: "https://yourblog.com/feed"

      - name: Commit changes
        run: |
          git config --local user.email "[email protected]"
          git config --local user.name "GitHub Action"
          git add -A
          git diff --quiet && git diff --staged --quiet || git commit -m "Update README"
          git push

指標と統計

# Auto-update GitHub stats image
- uses: lowlighter/metrics@latest
  with:
    token: ${{ secrets.METRICS_TOKEN }}
    filename: github-metrics.svg

リリースのお知らせ

# Tweet on new release
name: Release Announcement
on:
  release:
    types: [published]

jobs:
  announce:
    runs-on: ubuntu-latest
    steps:
      - name: Tweet
        uses: ethomson/send-tweet-action@v1
        with:
          status: "🚀 ${{ github.repository }} ${{ github.event.release.tag_name }} released! ${{ github.event.release.html_url }}"
          consumer-key: ${{ secrets.TWITTER_CONSUMER_KEY }}
          # ... other secrets

---

GitHub Sponsors

Sponsors の設定

1. GitHub Sponsors に参加します（github.com/sponsors）
2. 魅力的な支援プランの説明を作成します
3. リポジトリに funding.yml を設定します

funding.yml の例：

github: [yourusername]
patreon: yourpatreon
open_collective: yourproject
ko_fi: yourkofi
custom: ["https://buymeacoffee.com/you"]

効果的なスポンサー向けティア

ティア	価格	提供内容
サポーター	$5/mo	感謝のメッセージ＋README に名前を掲載
支援者	$15/mo	README にロゴを掲載＋Discord ロール
スポンサー	$50/mo	優先サポート＋機能への投票
エンタープライズ	$200+/mo	専任サポート＋相談

---

プラットフォーム固有の推奨事項と禁止事項

推奨事項

1. 推奨 第一印象を高めるように README を最適化します
2. 推奨 信頼性をすばやく示すためにバッジを使います
3. 推奨 関連するトピックを追加します（最大 20 個）
4. 推奨 プロフィールの README を最新の状態に保ちます
5. 推奨 Issue と PR に速やかに対応します
6. 推奨 最も優れたリポジトリをピン留めします
7. 推奨 明確なインストール手順を記載します
8. 推奨 関連する awesome リストに登録します

禁止事項

1. 禁止 README をおろそかにしないでください。README はランディングページです
2. 禁止 バッジを使いすぎないでください（見づらくなります）
3. 禁止 Issue を未対応のまま放置しないでください
4. 禁止 ライセンスファイルを忘れないでください
5. 禁止 低品質な画像や壊れた画像を使わないでください
6. 禁止 構成なしに長文を並べないでください
7. 禁止 コントリビューションガイドラインを無視しないでください

---

成果の測定

追跡する GitHub の指標

指標	わかること	目標
スター	関心・ブックマーク	時間とともに増加
フォーク	実際の利用状況	量より質
クローン	試している人の数	インストール前の関心
トラフィック	プロフィール／リポジトリの閲覧数	認知度
リファラー	トラフィックの流入元	チャネルの効果
コントリビューター	コミュニティの健全性	プロジェクトの持続可能性

トラフィックの分析情報

次からアクセスできます：Repository → Insights → Traffic

• 閲覧数とユニークビジター数
• 人気のコンテンツ（どのファイルか）
• リファラーサイト
• クローンのアクティビティ

---

ツール

ツール	用途
Octolens	GitHub で、プロジェクトや競合他社への言及、関連する議論を監視します。解決する問題について話している人がいれば、アラートを受け取れます。
Shields.io	ステータスバッジを生成
GitHub Readme Stats	プロフィール用の動的な統計
Carbon	美しいコードのスクリーンショット
readme.so	README ジェネレーター
Metrics	高度なプロフィール統計

---

README 監査チェックリスト

• 明確でキーワードを含む名前と説明
• CI の状態、バージョン、ライセンスを示すバッジ
• 何をするものかを一文で説明
• 2 分以内に実行できるクイックスタート
• コピーして貼り付けられるコード例
• すべてのリンクが機能し、HTTPS を使用
• 画像に alt テキストがある
• モバイルでも読みやすい書式
• ライセンスファイルがある
• コントリビューションガイドラインがある
• トピックが設定されている（最大 20 個）
• ソーシャルプレビュー画像がアップロードされている

---

関連スキル

• developer-audience-context — リポジトリを評価する人を把握する
• hacker-news-strategy — HN ユーザーは賛成票を投じる前に GitHub を確認する
• reddit-engagement — Reddit ユーザーは GitHub を通じて評価する
• dev-to-hashnode — README からコンテンツにリンクする