social-graph-ranker
affaan-m/ecc
Weighted graph-ranking engine for discovering warm intro paths and bridge value across X and LinkedIn.
What is social-graph-ranker?
A reusable ranking layer that scores your network connections by their ability to introduce you to target people or companies. Use this when you need the graph-ranking math itself, independent of broader outreach or network-maintenance workflows.
- Rank existing connections by intro value to a target set
- Map warm paths from your network to specific people or companies
- Score bridge value across first- and second-order connections
- Measure decay and responsiveness-adjusted ranking for intro prioritization
- Identify network gaps where no warm path exists to targets
How to install social-graph-ranker
npx skills add null --skill social-graph-ranker- Access to your X and/or LinkedIn graph data
- Target list or ICP definition
- Optional: weighting signals (role, industry, geography, responsiveness)
How to use social-graph-ranker
- 1.Define your target set (people, companies, or ICP criteria) and assign weights based on priority signals
- 2.Pull your current graph from X, LinkedIn, or both platforms
- 3.Configure traversal depth and decay factor (default 0.5 for each hop)
- 4.Run the ranking engine to compute bridge scores for direct and second-order connections
- 5.Review the output tiers: Tier 1 (warm intro asks), Tier 2 (conditional paths), Tier 3 (direct outreach or gap fill)
- 6.Use the recommended actions to decide intro strategy for each target
Use cases
- Rank mutuals by who can best introduce you to a target list
- Decide which prospects warrant warm intros versus cold outreach
- Map your graph against an ICP to find bridge opportunities
- Understand shortest-path and multi-hop bridge math for a priority set
- Identify high-value connectors in your network for specific industries or roles
- Sales and business development professionals
- Founders and investors doing warm outreach
- Recruiters mapping talent networks
- Anyone optimizing network-based introductions
social-graph-ranker FAQ
Use social-graph-ranker when you want the ranking engine itself. Use lead-intelligence for full lead generation and outbound sequencing, or connections-optimizer for network pruning and growth.
The default is 0.5, meaning each additional hop halves the contribution value. Adjust based on how much you trust second- and third-order paths.
Responsiveness or relationship strength is multiplied into the final score with a bonus factor (default 0.2), so highly responsive connections rank higher even if bridge distance is equal.
The output identifies network gaps and recommends either direct outreach or filling the gap by adding relevant connections to your graph.
Yes, you can pull graph data from either or both platforms and rank across a unified target set.
Full instructions (SKILL.md)
Source of truth, from affaan-m/ecc.
name: social-graph-ranker description: Weighted social-graph ranking for warm intro discovery, bridge scoring, and network gap analysis across X and LinkedIn. Use when the user wants the reusable graph-ranking engine itself, not the broader outreach or network-maintenance workflow layered on top of it. metadata: origin: ECC
Social Graph Ranker
Canonical weighted graph-ranking layer for network-aware outreach.
Use this when the user needs to:
- rank existing mutuals or connections by intro value
- map warm paths to a target list
- measure bridge value across first- and second-order connections
- decide which targets deserve warm intros versus direct cold outreach
- understand the graph math independently from
lead-intelligenceorconnections-optimizer
When To Use This Standalone
Choose this skill when the user primarily wants the ranking engine:
- "who in my network is best positioned to introduce me?"
- "rank my mutuals by who can get me to these people"
- "map my graph against this ICP"
- "show me the bridge math"
Do not use this by itself when the user really wants:
- full lead generation and outbound sequencing -> use
lead-intelligence - pruning, rebalancing, and growing the network -> use
connections-optimizer
Inputs
Collect or infer:
- target people, companies, or ICP definition
- the user's current graph on X, LinkedIn, or both
- weighting priorities such as role, industry, geography, and responsiveness
- traversal depth and decay tolerance
Core Model
Given:
T= weighted target setM= your current mutuals / direct connectionsd(m, t)= shortest hop distance from mutualmto targettw(t)= target weight from signal scoring
Base bridge score:
B(m) = Σ_{t ∈ T} w(t) · λ^(d(m,t) - 1)
Where:
λis the decay factor, usually0.5- a direct path contributes full value
- each extra hop halves the contribution
Second-order expansion:
B_ext(m) = B(m) + α · Σ_{m' ∈ N(m) \\ M} Σ_{t ∈ T} w(t) · λ^(d(m',t))
Where:
N(m) \\ Mis the set of people the mutual knows that you do notαdiscounts second-order reach, usually0.3
Response-adjusted final ranking:
R(m) = B_ext(m) · (1 + β · engagement(m))
Where:
engagement(m)is normalized responsiveness or relationship strengthβis the engagement bonus, usually0.2
Interpretation:
- Tier 1: high
R(m)and direct bridge paths -> warm intro asks - Tier 2: medium
R(m)and one-hop bridge paths -> conditional intro asks - Tier 3: low
R(m)or no viable bridge -> direct outreach or follow-gap fill
Scoring Signals
Weight targets before graph traversal with whatever matters for the current priority set:
- role or title alignment
- company or industry fit
- current activity and recency
- geographic relevance
- influence or reach
- likelihood of response
Weight mutuals after traversal with:
- number of weighted paths into the target set
- directness of those paths
- responsiveness or prior interaction history
- contextual fit for making the intro
Workflow
- Build the weighted target set.
- Pull the user's graph from X, LinkedIn, or both.
- Compute direct bridge scores.
- Expand second-order candidates for the highest-value mutuals.
- Rank by
R(m). - Return:
- best warm intro asks
- conditional bridge paths
- graph gaps where no warm path exists
Output Shape
SOCIAL GRAPH RANKING
====================
Priority Set:
Platforms:
Decay Model:
Top Bridges
- mutual / connection
base_score:
extended_score:
best_targets:
path_summary:
recommended_action:
Conditional Paths
- mutual / connection
reason:
extra hop cost:
No Warm Path
- target
recommendation: direct outreach / fill graph gap
Related Skills
lead-intelligenceuses this ranking model inside the broader target-discovery and outreach pipelineconnections-optimizeruses the same bridge logic when deciding who to keep, prune, or addbrand-voiceshould run before drafting any intro request or direct outreachx-apiprovides X graph access and optional execution paths
Related skills
More from affaan-m/ecc and the wider catalog.
social-publisher
Schedule and publish social media posts across 13 platforms via SocialClaw API.
springboot-patterns
Spring Boot architecture patterns, REST API design, layered services, and production-grade backend patterns.
springboot-security
Spring Security best practices for authentication, authorization, validation, and secrets management in Java Spring Boot.
springboot-tdd
Test-driven development for Spring Boot with JUnit 5, Mockito, MockMvc, Testcontainers, and JaCoCo coverage.
springboot-verification
Build, test, analyze, and security-scan Spring Boot projects before PR or deploy.
strategic-compact
Suggests manual context compaction at strategic task boundaries to preserve context through multi-phase workflows.