GitHub Repo Signals

GitHub Repository Signals

Extract high-intent leads from one or more GitHub repositories by analyzing every type of user interaction. This skill uses only free GitHub API data — no enrichment credits are spent.

When to Use

• User wants to find leads from open-source GitHub repositories
• User wants to identify people who interact with competitor or category repos
• User wants cross-repo interaction analysis to find high-intent prospects
• User asks for GitHub-based lead generation without paid enrichment
• User says their ICP, target audience, or buyers are developers, engineers, or technical people who are active on GitHub
• User describes prospects who use open-source tools, contribute to open source, or build with specific technologies — and those technologies have public GitHub repos
• User wants to find leads in a technical space (e.g., "real-time communication", "AI agents", "infrastructure") where the community congregates around GitHub repositories

Note: If the user describes their ICP as GitHub-active but hasn't identified specific repositories yet, this skill still applies. In that case, ask the user which repositories their ICP is likely to interact with, or help them identify relevant repos based on the technology/space they describe.

Prerequisites

• gh CLI authenticated (gh auth status to verify)
• Python 3.9+ with PyYAML installed
• Working directory: the project root containing this skill

Inputs to Collect from User

Before running, ask the user for:

1. Repositories (required): One or more GitHub repository URLs or owner/repo strings
2. User limit (required): How many top users to include in the output. Explain that more users = longer runtime due to GitHub profile fetching (~5,000 profiles/hour). Suggest 500 as a good starting point for testing.

Execution Steps

Step 1: Verify Environment

gh auth status

Step 2: Run the Tool

python3 ${CLAUDE_SKILL_DIR}/scripts/gh_repo_signals.py \
    --repos "owner1/repo1,owner2/repo2" \
    --limit <USER_LIMIT> \
    --output ${CLAUDE_SKILL_DIR}/../.tmp/repo_signals.csv

Replace the repos and limit with user-provided values.

The tool will:

1. Extract all interaction types per repo (stars, forks, contributors, issues, PRs, comments, watchers, commit emails)
2. Filter out bots and org members automatically (fetches org member lists and detects org email domains)
3. Score each user by interaction depth using these weights:
   • Issue opener: 5 points
   • PR author: 5 points
   • Contributor: 4 points
   • Issue commenter: 3 points
   • Forker: 3 points
   • Watcher: 2 points
   • Stargazer: 1 point
4. Rank users by (repos_interacted desc, total_score desc) — multi-repo users surface first
5. Fetch GitHub profiles for the top N users (name, email, company, location, blog, twitter, bio, followers)
6. Export two CSV files: _users.csv and _interactions.csv

Step 3: Review Output

The tool produces two CSV files:

repo_signals_users.csv — One row per person, deduplicated across all repos

repo_signals_interactions.csv — One row per user x repo combination

Phase 3: Analyze & Recommend

Once the CSV files are generated, do not stop. Immediately proceed to analyze the data and brief the user.

Step 5: Collect Company Context

Check if you already know the user's company and intent from prior conversation. If not, ask:

"Before I analyze these results, I need to understand who you're finding leads for:

1. What does your company/product do? (one-liner is fine)
2. Who is your ideal customer? (role, company size, industry, tech stack — whatever is relevant)
3. What's the goal for these leads? (outbound sales, partnership, hiring, community building, etc.)"

Do NOT proceed to analysis until you have this context. It directly shapes the recommendations.

Step 6: Analyze the Data

Read the generated .csv file and compute the following analysis. Present it to the user as a structured briefing.

6a. Overall Stats

• Total users in the sheet
• Score distribution (how many at 15+, 10-14, below 10)
• Email coverage: how many have any email (public or commit)
• Company coverage: how many have a company listed

6b. Multi-Repo Users (if multiple repos were scanned)

• How many users interacted with 2+ repos
• List the top 10 multi-repo users with their names, companies, and which repos they touched
• This is the highest-signal segment — call it out explicitly

6c. Top Companies

• Extract all company names from the Users sheet
• Group users by company (normalize company names — strip @, leading/trailing whitespace, lowercase comparison)
• List the top 15 companies by number of engaged users
• For each, note how many users, their average score, and which interaction types are most common
• Flag companies with 3+ engaged users as "organizational adoption signals"

6d. Interaction Patterns

• How many users are issue openers (highest intent)
• How many are PR authors (deep practitioners)
• How many are stargazer-only (lowest signal)
• Any notable patterns (e.g., a burst of recent stars, many forkers from one company)

6e. Data Gaps

• What percentage lack email — this determines enrichment priority
• What percentage lack company — affects ability to do company-level targeting
• How many have a blog/website or twitter that could help with manual research