https://github.com/randomtask2000/linkedin-dignitas
LinkedIn profile grading rubric based on official LinkedIn best practices, recruiter behavior research, and SEO principles
https://github.com/randomtask2000/linkedin-dignitas
Last synced: 2 months ago
JSON representation
LinkedIn profile grading rubric based on official LinkedIn best practices, recruiter behavior research, and SEO principles
- Host: GitHub
- URL: https://github.com/randomtask2000/linkedin-dignitas
- Owner: randomtask2000
- Created: 2026-03-21T15:54:35.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-03-21T16:21:08.000Z (3 months ago)
- Last Synced: 2026-03-22T06:36:42.398Z (3 months ago)
- Language: TypeScript
- Size: 52.7 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# LinkedIn Profile Grader
Grade any LinkedIn profile in minutes. A 100-point scoring rubric built from LinkedIn's own published data, recruiter eye-tracking research, and search algorithm analysis — so you know exactly what to fix and why it matters.
Paste a profile, score each section, and walk away with a letter grade and a prioritized list of quick wins.
## What's Inside
### [LinkedIn Profile Grader](linkedin-profile-grader.md)
A 100-point scoring rubric across 9 categories:
- **Headline** (15 pts) — keyword placement, value proposition, searchability
- **About / Summary** (15 pts) — hook, first-person voice, quantified results
- **Experience** (15 pts) — XYZ formula, standard titles, career progression
- **Skills & Endorsements** (10 pts) — keyword coverage, pinned skills, endorsement depth
- **Photo & Banner** (8 pts) — professional headshot, custom banner
- **Profile Completeness** (10 pts) — All-Star status, vanity URL, connections
- **Recruiter Search Optimization** (12 pts) — Open to Work, recency, activity signals
- **Content & Thought Leadership** (8 pts) — featured section, posting cadence
- **Keyword & SEO Audit** (7 pts) — cross-section keyword placement check
Includes a fill-in grading template, deductions for common mistakes, and a "Top 3 Quick Wins" section.
### [CLAUDE.md](CLAUDE.md)
Reference guide covering LinkedIn API endpoints, OAuth flow, scopes, and profile optimization rules — useful if you're building tools on top of LinkedIn's APIs.
## How to Use
### Option 1: MCP Server (works with any MCP client)
The fastest way to use this. Add `linkedin-dignitas` as an MCP server and the `grade_profile` tool becomes available in any MCP-compatible client (Claude Desktop, Claude Code, Cursor, Windsurf, etc.).
```bash
npx linkedin-dignitas
```
**Claude Desktop / Claude Code config:**
```json
{
"mcpServers": {
"linkedin-dignitas": {
"command": "npx",
"args": ["-y", "linkedin-dignitas"]
}
}
}
```
**Remote (Cloudflare Workers):**
```
https://linkedin-dignitas..workers.dev/sse
```
### Option 2: AI Coding Agent Skill
Install as a native skill/rule for your specific platform.
**Supported:** Claude Code, OpenCode, Cursor, GitHub Copilot, Windsurf, Continue.dev, Aider
**Quick start (Claude Code):**
```bash
git clone https://github.com/randomtask2000/linkedin-dignitas.git
cp -r linkedin-dignitas/skill ~/.claude/skills/dignitas
```
```
/dignitas https://www.linkedin.com/in/someone/
```
See the **[full installation guide](INSTALL.md)** for all platforms.
### Option 2: Manual grading
1. Open the [profile grader](linkedin-profile-grader.md)
2. Review each section against the criteria
3. Score and tally
4. Focus on the quick wins first — small changes to headline and skills often have the biggest impact
## Key Stats That Drive the Rubric
| Signal | Impact |
|--------|--------|
| Profile photo | 21x more views, 36x more messages |
| Current position listed | 8x more views |
| 5+ skills | 17x more recruiter views |
| Open to Work (recruiter-only) | 3x more likely to be messaged |
| Profile updated in last 2-4 weeks | Temporary search ranking boost |
## How This Grader Was Built
This rubric was created by researching three distinct angles of how LinkedIn profiles are discovered, evaluated, and ranked — then synthesizing the findings into a single weighted scoring system.
### Source 1: LinkedIn's Official Published Best Practices
We started with what LinkedIn itself tells users to do. Their Help Center, Talent Blog, and Business Blog publish specific guidance on profile sections, character limits, and what triggers "All-Star" profile status. This gave us the baseline requirements (photo, headline, skills thresholds) and the multiplier stats (21x more views with a photo, 8x with a current position, etc.).
**Key sources:**
- [Profile Strength / All-Star Requirements](https://www.linkedin.com/help/linkedin/answer/a594698) — LinkedIn Help Center
- [Create a Good LinkedIn Profile](https://www.linkedin.com/help/linkedin/answer/a554351) — LinkedIn Help Center
- [14 LinkedIn Profile Summaries That We Love](https://www.linkedin.com/business/talent/blog/product-tips/linkedin-profile-summaries-that-we-love-and-how-to-boost-your-own) — LinkedIn Talent Blog
- [How to Write a LinkedIn Headline](https://www.linkedin.com/business/sales/blog/b2b-sales/how-to-write-a-linkedin-headline-that-makes-sales-prospects-take) — LinkedIn Sales Blog
- [20 Steps to a Better LinkedIn Profile](https://www.linkedin.com/business/sales/blog/profile-best-practices/17-steps-to-a-better-linkedin-profile-in-2017) — LinkedIn Business Blog
- [Profile Photo Guidelines](https://www.linkedin.com/help/linkedin/answer/a1377087/profile-photo-guidelines-and-conditions) — LinkedIn Help Center
- [Add and Remove Skills](https://www.linkedin.com/help/linkedin/answer/a549047) — LinkedIn Help Center
- [Request a Recommendation](https://www.linkedin.com/help/linkedin/answer/a546682) — LinkedIn Help Center
- [Manage Your Public Profile URL](https://www.linkedin.com/help/linkedin/answer/a542685/manage-your-public-profile-url) — LinkedIn Help Center
- [Open to Work Feature](https://www.linkedin.com/blog/member/product/now-you-can-privately-signal-to-recruiters-youre-open-to-new-job) — LinkedIn Blog
- [2025 LinkedIn Character Limits](https://www.linkedin.com/pulse/2023-linkedin-character-limits-eric-z-johnson) — Eric Z. Johnson
### Source 2: Recruiter Behavior Research
Next, we studied how recruiters actually search for and evaluate candidates. This included LinkedIn Recruiter's 44 search filters, the difference between Recruiter Lite and Recruiter Corporate, and an eye-tracking study of 500 recruiters across 2,000 profiles that revealed the 3.2-second scan pattern. This research determined the point weights — sections recruiters look at first (headline, current title) got more points.
**Key sources:**
- [AI Behind LinkedIn Recruiter Search and Recommendation Systems](https://www.linkedin.com/blog/engineering/recommendations/ai-behind-linkedin-recruiter-search-and-recommendation-systems) — LinkedIn Engineering Blog
- [Recruiter and Recruiter Lite Search Filters](https://www.linkedin.com/help/recruiter/answer/a414428) — LinkedIn Help Center
- [Filter Search Results in Recruiter](https://www.linkedin.com/help/recruiter/answer/a414281) — LinkedIn Help Center
- [Boolean Search in Recruiter](https://www.linkedin.com/help/recruiter/answer/a415295) — LinkedIn Help Center
- [How Search Filters Work in Recruiter (PDF)](https://business.linkedin.com/content/dam/me/business/en-us/talent-solutions/learning-center/tip-sheets/en-us/HowSearchFiltersWork.pdf) — LinkedIn Business
- [Recruiter Lite vs Recruiter Comparison](https://business.linkedin.com/talent-solutions/product-comparison/recruiterlite-vs-recruiter) — LinkedIn Talent Solutions
- [What Recruiters Actually See on LinkedIn](https://saganrecruitment.com/what-recruiters-actually-see-on-linkedin-and-how-to-show-up-in-their-searches/) — Sagan Recruitment
- [What Recruiters Really Look For in Your LinkedIn Profile](https://directrecruiters.com/dri-candidate-advice/what-recruiters-really-look-for-in-your-linkedin-profile/) — Direct Recruiters
- [LinkedIn Profile Eye-Tracking Study](https://www.jobease.ca/blog/what-happens-to-your-linkedin-profile-after-recruiters-click-view-eye-tracking-study/) — JobEase
- [LinkedIn Spotlight Filters Explained](https://www.mycareergps.com/job-blog/linkedin-spotlight-filters) — My Career GPS
- [What Does Open to Work Really Do](https://www.tryapt.ai/blog/what-does-open-to-work-on-linkedin-really-do) — Apt
### Source 3: LinkedIn SEO & Algorithm Analysis
Finally, we researched how LinkedIn's search algorithm ranks profiles and how the feed algorithm distributes content. This included the keyword weight hierarchy (headline > current title > about > experience > skills), SSI scoring, and the 2025 algorithm changes. This shaped the Keyword & SEO Audit section and the Content & Thought Leadership scoring.
**Key sources:**
- [Order of Your Profile in Search Results](https://www.linkedin.com/help/linkedin/answer/a521944) — LinkedIn Help Center
- [The Algorithm Insights Report 2025](https://www.linkedin.com/pulse/algorithm-insights-report-2025-here-xdooc) — LinkedIn
- [Social Selling Index (SSI)](https://business.linkedin.com/sales-solutions/social-selling/the-social-selling-index-ssi) — LinkedIn Sales Solutions
- [How the LinkedIn Algorithm Works in 2025](https://authoredup.com/blog/linkedin-algorithm) — AuthoredUp
- [LinkedIn Algorithm 2026: How Reach, Engagement, and Visibility Work Now](https://www.designace.ca/blog/linkedin-algorithm-2026-how-it-actually-works) — designACE
- [LinkedIn SEO: A Comprehensive Guide to Keyword Optimization](https://www.hyperclapper.com/blog-posts/linkedin-seo-keyword-optimization-3356f) — HyperClapper
- [LinkedIn SEO: Everything You Need to Know (2026)](https://columncontent.com/linkedin-seo/) — Column Content
- [LinkedIn Keywords Guide 2026](https://linkedinrank.com/linkedin-keywords-guide) — LinkedInRank
- [LinkedIn Profile Keywords and SEO Guide](https://pursuenetworking.com/blog/linkedin-profile-keywords-seo-guide/) — Pursue Networking
- [LinkedIn Social Selling Index: How to Check and Grow It](https://expandi.io/blog/linkedin-boost-ssi/) — Expandi
- [LinkedIn Algorithm 2026: How to Stay Visible](https://www.agorapulse.com/blog/linkedin/linkedin-algorithm-2025/) — Agorapulse
- [A Leader's Guide to the LinkedIn Algorithm](https://mercermackay.com/thinking/blog/a-leaders-guide-to-the-linkedin-algorithm-what-the-data-says/) — Mercer-Mackay
## Contributing
Found something outdated or have data to improve the rubric? Open an issue or PR.
## License
MIT