reference-list-builder
Skill8 starsChanged 3 months agoMITView on GitHub
Format professional references properly and prepare reference materials
3 other projects use a version of this, 1 of them edited.
Adopted by
Most recently taken up by
- carriegale2710/resume-tailortheir own version, first seen Nov 16, 2026
- tstapler/dotfilesedited, first seen Oct 10, 2026
- Paramchoudhary/ResumeSkillsword for word, first seen Mar 16, 2026
Other versions3 projects use a version of this.
Word for word · 1
- Paramchoudhary/ResumeSkills★ 2.1k100% same
Edited · 1
- tstapler/dotfiles★ 882% same
Wrote their own version · 1
- carriegale2710/resume-tailor★ 1same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository177 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- docs/llms-full.txtllms.txt
- docs/llms.txtllms.txt
- llms.txtllms.txt
- academic-cv-builderSkill
- agenticx-a2a-connectorSkill
- agenticx-agent-builderSkill
- agenticx-automation-crontaskSkill
- agenticx-deployerSkill
- agenticx-memory-architectSkill
- agenticx-quickstartSkill
- agenticx-skill-managerSkill
- agenticx-tool-creatorSkill
- agenticx-workflow-designerSkill
- ai-slop-detectorSkill
- alert-managerSkill
- algorithmic-artSkill
- api-gatewaySkill
- backlink-analyzerSkill
- brand-guidelinesSkill
- canvas-designSkill
- career-changer-translatorSkill
- Codex-apiSkill
- Codex-skill-rustSkill
- claw-releaseSkill
- clawsec-clawhub-checkerSkill
- clawsec-feedSkill
- clawsec-nanoclawSkill
- clawsec-scannerSkill
- clawsec-suiteSkill
- clawtributorSkill
- cn-statsSkill
- codebase-documenterSkill
- code-dev-workflowSkill
- competitor-analysisSkill
- content-experimentation-best-practicesSkill
- content-gap-analysisSkill
- content-modeling-best-practicesSkill
- content-quality-auditorSkill
- content-refresherSkill
- context-mode-opsSkill
- context-modeSkill
- cover-letter-generatorSkill
- creative-portfolio-resumeSkill
- crypto-reportSkill
- ctx-doctorSkill
- ctx-insightSkill
- ctx-purgeSkill
- ctx-statsSkill
- ctx-upgradeSkill
- deep-cleanSkill
- doc-coauthoringSkill
- docxSkill
- domain-authority-auditorSkill
- edgeoneSkill
- edge-ttsSkill
- entity-optimizerSkill
- executive-resume-writerSkill
- fallowSkill
- The first 60 shown.
The file
We split this skill into the rules it gives an agent
11 rules. About 0 are common, 11 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈11
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 10
Use this skill when the user:
- Distinctive: line 104
Call or email to ask permission
- Distinctive: line 153
After references are checked:
- Distinctive: line 163
Ask if reference check can wait until later stage
- Distinctive: line 164
Use colleagues who've left the company
- Distinctive: line 166
Use other professional references
- Distinctive: line 172
Use their personal email/phone
- Distinctive: line 179
Use another supervisor from that role
- Distinctive: line 180
Use senior colleagues instead
- Distinctive: line 276
Offer: Follow up with references, thank them
- Distinctive: line 280
When building a reference list:
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Reference List Builder
When to Use This Skill
Use this skill when the user:
- Needs to create a professional reference list
- Wants help choosing the right references
- Needs to format references properly
- Is preparing references for job applications
- Mentions: "references", "reference list", "professional references", "reference check"
Core Capabilities
- Format professional reference lists
- Guide reference selection strategy
- Prepare reference briefing materials
- Anticipate reference check questions
- Handle difficult reference situations
- Coordinate reference outreach
Reference Strategy
Who Makes a Good Reference?
Ideal References:
- Former direct managers (most important)
- Senior colleagues who observed your work
- Cross-functional partners
- Clients or customers
- Direct reports (for leadership roles)
- Professors or advisors (for recent graduates)
Reference Hierarchy:
- Most Valuable: Recent direct supervisor
- Very Valuable: Senior leaders who know your work
- Valuable: Peers and cross-functional partners
- Acceptable: Clients, vendors, professors
- Avoid: Friends, family, HR contacts only
Who to Avoid
- ❌ Current employer (without permission)
- ❌ People who barely know you
- ❌ References from 10+ years ago only
- ❌ Personal friends (unless specified)
- ❌ People who might give lukewarm feedback
- ❌ Anyone you haven't contacted in advance
Reference List Format
Standard Format
PROFESSIONAL REFERENCES
Jane Smith
Senior Director of Product
TechCorp Inc.
Phone: (555) 123-4567
Email: jane.smith@techcorp.com
Relationship: Direct supervisor for 3 years (2020-2023)
John Doe
VP of Engineering
Previous Company
Phone: (555) 234-5678
Email: john.doe@previous.com
Relationship: Cross-functional partner on 5 major projectsInformation to Include
Required:
- Full name
- Current job title
- Current company
- Phone number
- Professional email
- Your relationship to them
Optional:
- LinkedIn URL
- Best time to reach
- Preferred contact method
Formatting Guidelines
- Match the style of your resume (fonts, formatting)
- 3-5 references (more only if requested)
- Separate page from resume
- Header should match resume header
- Include "References" or "Professional References" as title
Reference Preparation
Step 1: Ask Permission
Before listing anyone:
- Call or email to ask permission
- Confirm their contact information
- Explain the role you're applying for
- Gauge their willingness and enthusiasm
Script:
"Hi [Name], I hope you're doing well! I'm applying for a [Role] position at [Company] and was wondering if you'd be comfortable serving as a reference for me. The role involves [brief description], and I think your perspective on [specific project/skill] would be particularly valuable. Would you be willing to speak with them if they reach out?"Step 2: Brief Your References
Send them:
- Copy of your resume
- Job description
- Key points you want highlighted
- Specific projects to mention
- Timeline for when they might be contacted
Briefing Email Template:
Subject: Reference Preparation - [Role] at [Company]
Hi [Name],
Thank you so much for agreeing to be a reference! Here's some context to help:
**The Role:** [Job title] at [Company]
**What they're looking for:** [Key requirements]
**Points I'm emphasizing:**
- [Achievement 1]
- [Achievement 2]
- [Skill they should mention]
**Our work together they might ask about:**
- [Project 1]
- [Project 2]
I've attached my resume and the job description for reference. They may reach out in the next [timeframe].
Please let me know if you have any questions, and thank you again!
Best,
[Your name]Step 3: Follow Up
After references are checked:
- Thank your references regardless of outcome
- Let them know the result
- Offer to reciprocate
Handling Special Situations
Current Employer Doesn't Know
Options:
- Ask if reference check can wait until later stage
- Use colleagues who've left the company
- Be upfront: "My current employer doesn't know I'm looking"
- Use other professional references
Manager Left the Company
Options:
- Track them down on LinkedIn
- Use their personal email/phone
- Include their new company in reference list
- Explain "Former manager, now at [New Company]"
Bad Relationship with Past Manager
Options:
- Use another supervisor from that role
- Use senior colleagues instead
- Choose references from different roles
- Be prepared to explain if asked
Limited Professional Experience
Options:
- Professors or academic advisors
- Internship supervisors
- Volunteer organization leaders
- Coaches or mentors
- Client contacts
Reference Won't Give Positive Review
Don't use them. It's better to have fewer references than a lukewarm or negative one.
What Reference Checkers Ask
Common Questions
Performance:
- "How would you describe [name]'s work?"
- "What were their primary responsibilities?"
- "How did they perform against expectations?"
Skills:
- "What are their greatest strengths?"
- "What areas could they improve?"
- "How would you rate their [specific skill]?"
Work Style:
- "How did they handle pressure/deadlines?"
- "How did they work with the team?"
- "How did they handle conflict?"
Character:
- "Would you rehire them?"
- "Is there anything else I should know?"
- "How do they compare to peers?"
The "Would You Rehire?" Question
Most important question. Brief your references that this may be asked and ensure they can answer enthusiastically.
Reference List Template
[YOUR NAME]
[Your Email] | [Your Phone]
PROFESSIONAL REFERENCES
[REFERENCE 1 - MOST SENIOR/RELEVANT]
[Name]
[Title]
[Company]
Phone: [Number]
Email: [Email]
Relationship: [How you worked together, dates]
[REFERENCE 2]
[Name]
[Title]
[Company]
Phone: [Number]
Email: [Email]
Relationship: [How you worked together, dates]
[REFERENCE 3]
[Name]
[Title]
[Company]
Phone: [Number]
Email: [Email]
Relationship: [How you worked together, dates]
---
References available upon request for additional contacts.Reference Timing
When to Provide References
- Don't include with initial application (unless requested)
- Bring to interview (have them ready)
- Provide when asked (usually after final interview)
- Always ask before sharing (confirm permission each time)
Common Timeline
- Application: "References available upon request" (optional on resume)
- First Interview: Have list ready but don't offer
- Final Rounds: "Can you provide references?" → Share list
- Reference Check: Company contacts your references
- Offer: Follow up with references, thank them
Output Format
When building a reference list:
# REFERENCE LIST
## Reference Strategy
**Target Role:** [Position]
**Company:** [Company]
## Recommended References
### Primary References (Use These)
**Reference 1: [Name]**
- Current Title: [Title]
- Company: [Company]
- Contact: [Phone/Email]
- Relationship: [Description]
- Why: [What they can speak to]
- Key points to highlight: [Specific projects/skills]
**Reference 2: [Name]**
[Same format]
**Reference 3: [Name]**
[Same format]
### Backup References (If Needed)
**Reference 4: [Name]**
[Same format]
## Briefing Notes
### For Each Reference, Send:
- [ ] Resume
- [ ] Job description
- [ ] Key talking points
- [ ] Timeline
### Key Points to Emphasize
- [Point 1 - who should mention]
- [Point 2 - who should mention]
## Reference Outreach
### Permission Request Script
[Customized script]
### Briefing Email
[Draft briefing email]
### Thank You Template
[Post-check thank you message]Reference Checklist
- ✅ Have 3-5 references ready
- ✅ All references have given permission
- ✅ Contact information is current and accurate
- ✅ References know about the specific role
- ✅ Each reference has your resume and talking points
- ✅ At least one direct supervisor included
- ✅ References span different aspects of your work
- ✅ References are enthusiastic (not just willing)
- ✅ Backup references identified
- ✅ Thank you notes planned
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

