---
title: "Job reference list builder"
type: "skill"
url: "https://useaiblocks.com/skills/job-reference-list-builder"
updated: "2026-10-28"
first_published: "2026-10-25"
job: "Prepare job applications"
tested: true
licence: "MIT"
source: "https://github.com/davila7/claude-code-templates/tree/7d85535533914ff0880945570a94fcbec4adc042/cli-tool/components/skills/career/reference-list-builder"
instructions: "https://useaiblocks.com/skills/job-reference-list-builder/SKILL.md"
---

# Job reference list builder

> Build a job reference list: pick the right referees, check permission, and get request and briefing drafts for each person. Missing details are marked.

Share the role and people who can speak about your work. It helps choose relevant references and formats their details. You get a reference list, permission-request drafts and short briefings about the role for each person to review.

Free skill for the job "Prepare job applications" · Level: beginner · Thinking: medium · Tested · Updated 2026-10-28

## Links

- Page: https://useaiblocks.com/skills/job-reference-list-builder
- Instructions (SKILL.md): https://useaiblocks.com/skills/job-reference-list-builder/SKILL.md
- All files (zip): https://useaiblocks.com/skills/job-reference-list-builder.zip
- JSON version: https://useaiblocks.com/skills/job-reference-list-builder.json
- In your AI: connect https://useaiblocks.com/mcp and ask "Use AI Blocks to get job-reference-list-builder"

## What it does

Share the role and people who can speak about your work. It helps choose relevant references and formats their details. You get a reference list, permission-request drafts and short briefings about the role for each person to review.

## What you give it

- The target role and possible professional references.
- Known contact details, working relationships and permission status.

## What you get

- A formatted reference list with missing details marked.
- Draft permission requests and reference briefings.
- A checklist for sharing and follow-up.

## Example: what goes in and what comes out

### What goes in

- The role you are applying for, and the company
- Names of people who could speak for your work
- Their job titles, contact details and how you worked together
- Whether each person has agreed to be a reference (optional)

### What comes out

- **Reference Strategy**: The target role and company, so every choice of referee ties back to the job.
- **Recommended References**: Primary referees with title, company, contact, relationship, why they fit and what to highlight.
- **Backup References**: Extra referees in the same format, in case a main referee drops out.
- **Briefing Notes**: A checklist of what to send each referee and the key points each should mention.
- **Permission Request Script**: A short message asking each person if they will speak for you, tailored to the role.
- **Briefing Email**: A draft email giving each referee the role, your key points and the work they may be asked about.
- **Thank You Template**: A short note to send your referees after the check, whatever the result.

## Skip it when

- You need to share references now, before anyone asks. Wait for the final round, and send the list only when the employer requests it.
- Your referee has left, said no or may give a lukewarm review. Pick someone else who saw your work, such as a senior colleague or client.
- You need a CV or cover letter. Write those first, then come back here to build the list.
- The employer has already asked for references. Send the list only after you have each person's agreement.

## How to use it

1. Open Claude, ChatGPT or Gemini and paste in the skill text from this page.
2. Tell your AI the role and company. Then list each person who could be a reference.
3. Add their titles, contact details and how you worked together. Say who has already agreed.
4. Answer any questions it asks. It will mark missing details instead of guessing.
5. Check the list and drafts. Ask people before you send anything, then send the list only when the employer asks for it.
6. After the check, send your thank-you notes and tell each referee the result. Pair the list with your CV and cover letter, and update your job-search tracker.

## Sources and credits

- From Daniel (San) Ávila: https://github.com/davila7/claude-code-templates/tree/7d85535533914ff0880945570a94fcbec4adc042/cli-tool/components/skills/career/reference-list-builder, shared under the MIT licence (original name: reference-list-builder).
- [reference-list-builder skill](https://github.com/davila7/claude-code-templates/tree/7d85535533914ff0880945570a94fcbec4adc042/cli-tool/components/skills/career/reference-list-builder), Daniel (San) Ávila: Copied under the MIT licence. We gave it a plain name. We added Before you start and After this sections that link to other AI Blocks steps.

## Instructions (SKILL.md)

## Reference List Builder

<!-- needs: written by tools/add-needs.mjs for AI Blocks; not part of the original skill. Edit that tool, not this section. -->
### Before you start
Use the material below to do this job. If facts or tool access are missing, explain what you can finish and what must wait.

**What you need** (use your own material or the linked skill):
- **The job description** (yours): the role's title, team, duties and level, as a job post or plain notes.
- **A document** (yours): a finished document, such as a Word file, a PDF or a page of notes.

How to start:
1. **Look first.** Use what they've already attached, pasted or put in their about-me note. In a coding assistant with file access, look in the project too for these by name.
2. **Check what's missing.** Look for the job description, a document. They can attach files, paste the details, or share a file path your assistant can read. Ask only for missing facts that change the result. If they ask you to start with what they have, complete the parts you can and mark the gaps.
3. **Do the job.** Follow the skill below with the facts and tools you have. Mark each gap with `MISSING:` where it belongs and never invent a fact to fill it.
<!-- /needs -->

### 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:**
1. **Most Valuable:** Recent direct supervisor
2. **Very Valuable:** Senior leaders who know your work
3. **Valuable:** Peers and cross-functional partners
4. **Acceptable:** Clients, vendors, professors
5. **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 projects
```

#### Information 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 only if they have agreed to be contacted that way
- 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

1. **Application:** "References available upon request" (optional on resume)
2. **First Interview:** Have list ready but don't offer
3. **Final Rounds:** "Can you provide references?" → Share list
4. **Reference Check:** Company contacts your references
5. **Offer:** Follow up with references, thank them

### Output Format

When building a reference list:

```markdown
# 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
