Reference list builder

Format professional references properly and prepare reference materials

How to use it

  1. Hit Copy the whole skill.
  2. Claude: ⋯ → Download .md, then Customize → Skills → Add → Upload skill.
    ChatGPT: make a Project and paste it into Instructions.
    Neither? Paste it at the top of a new chat — it works for that chat.
  3. Describe your job in plain words. The AI follows the skill from there.
Claude Code — installs the whole folder, not just SKILL.md
npx degit Paramchoudhary/ResumeSkills/.agents/skills/reference-list-builder#main ~/.claude/skills/reference-list-builder

For one project only, change the path to .claude/skills/reference-list-builder.

Not working?
  • Check which app you pasted it into — the steps above name the right one.
  • Some skills need the paid tier of Claude or ChatGPT.
Step-by-step guide with screenshots · Ask in the forum

Paste into Claude, ChatGPT or Cursor.

Show the full text348 lines
reference-list-builder/SKILL.md348 lines8.2 KBpushed 189d agoRawView on GitHub

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:

  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: [email protected]
Relationship: Direct supervisor for 3 years (2020-2023)

John Doe
VP of Engineering
Previous Company
Phone: (555) 234-5678
Email: [email protected]
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
  • 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:

# 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
1---
2name: reference-list-builder
3description: Format professional references properly and prepare reference materials
4---
5 
6# Reference List Builder
7 
8## When to Use This Skill
9 
10Use this skill when the user:
11- Needs to create a professional reference list
12- Wants help choosing the right references
13- Needs to format references properly
14- Is preparing references for job applications
15- Mentions: "references", "reference list", "professional references", "reference check"
16 
17## Core Capabilities
18 
19- Format professional reference lists
20- Guide reference selection strategy
21- Prepare reference briefing materials
22- Anticipate reference check questions
23- Handle difficult reference situations
24- Coordinate reference outreach
25 
26## Reference Strategy
27 
28### Who Makes a Good Reference?
29 
30**Ideal References:**
31- Former direct managers (most important)
32- Senior colleagues who observed your work
33- Cross-functional partners
34- Clients or customers
35- Direct reports (for leadership roles)
36- Professors or advisors (for recent graduates)
37 
38**Reference Hierarchy:**
391. **Most Valuable:** Recent direct supervisor
402. **Very Valuable:** Senior leaders who know your work
413. **Valuable:** Peers and cross-functional partners
424. **Acceptable:** Clients, vendors, professors
435. **Avoid:** Friends, family, HR contacts only
44 
45### Who to Avoid
46 
47- ❌ Current employer (without permission)
48- ❌ People who barely know you
49- ❌ References from 10+ years ago only
50- ❌ Personal friends (unless specified)
51- ❌ People who might give lukewarm feedback
52- ❌ Anyone you haven't contacted in advance
53 
54## Reference List Format
55 
56### Standard Format
57 
58```
59PROFESSIONAL REFERENCES
60 
61Jane Smith
62Senior Director of Product
63TechCorp Inc.
64Phone: (555) 123-4567
65Email: [email protected]
66Relationship: Direct supervisor for 3 years (2020-2023)
67 
68John Doe
69VP of Engineering
70Previous Company
71Phone: (555) 234-5678
72Email: [email protected]
73Relationship: Cross-functional partner on 5 major projects
74```
75 
76### Information to Include
77 
78**Required:**
79- Full name
80- Current job title
81- Current company
82- Phone number
83- Professional email
84- Your relationship to them
85 
86**Optional:**
87- LinkedIn URL
88- Best time to reach
89- Preferred contact method
90 
91### Formatting Guidelines
92 
93- Match the style of your resume (fonts, formatting)
94- 3-5 references (more only if requested)
95- Separate page from resume
96- Header should match resume header
97- Include "References" or "Professional References" as title
98 
99## Reference Preparation
100 
101### Step 1: Ask Permission
102 
103**Before listing anyone:**
104- Call or email to ask permission
105- Confirm their contact information
106- Explain the role you're applying for
107- Gauge their willingness and enthusiasm
108 
109**Script:**
110```
111"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?"
112```
113 
114### Step 2: Brief Your References
115 
116**Send them:**
117- Copy of your resume
118- Job description
119- Key points you want highlighted
120- Specific projects to mention
121- Timeline for when they might be contacted
122 
123**Briefing Email Template:**
124```
125Subject: Reference Preparation - [Role] at [Company]
126 
127Hi [Name],
128 
129Thank you so much for agreeing to be a reference! Here's some context to help:
130 
131**The Role:** [Job title] at [Company]
132**What they're looking for:** [Key requirements]
133 
134**Points I'm emphasizing:**
135- [Achievement 1]
136- [Achievement 2]
137- [Skill they should mention]
138 
139**Our work together they might ask about:**
140- [Project 1]
141- [Project 2]
142 
143I've attached my resume and the job description for reference. They may reach out in the next [timeframe].
144 
145Please let me know if you have any questions, and thank you again!
146 
147Best,
148[Your name]
149```
150 
151### Step 3: Follow Up
152 
153After references are checked:
154- Thank your references regardless of outcome
155- Let them know the result
156- Offer to reciprocate
157 
158## Handling Special Situations
159 
160### Current Employer Doesn't Know
161 
162**Options:**
163- Ask if reference check can wait until later stage
164- Use colleagues who've left the company
165- Be upfront: "My current employer doesn't know I'm looking"
166- Use other professional references
167 
168### Manager Left the Company
169 
170**Options:**
171- Track them down on LinkedIn
172- Use their personal email/phone
173- Include their new company in reference list
174- Explain "Former manager, now at [New Company]"
175 
176### Bad Relationship with Past Manager
177 
178**Options:**
179- Use another supervisor from that role
180- Use senior colleagues instead
181- Choose references from different roles
182- Be prepared to explain if asked
183 
184### Limited Professional Experience
185 
186**Options:**
187- Professors or academic advisors
188- Internship supervisors
189- Volunteer organization leaders
190- Coaches or mentors
191- Client contacts
192 
193### Reference Won't Give Positive Review
194 
195**Don't use them.** It's better to have fewer references than a lukewarm or negative one.
196 
197## What Reference Checkers Ask
198 
199### Common Questions
200 
201**Performance:**
202- "How would you describe [name]'s work?"
203- "What were their primary responsibilities?"
204- "How did they perform against expectations?"
205 
206**Skills:**
207- "What are their greatest strengths?"
208- "What areas could they improve?"
209- "How would you rate their [specific skill]?"
210 
211**Work Style:**
212- "How did they handle pressure/deadlines?"
213- "How did they work with the team?"
214- "How did they handle conflict?"
215 
216**Character:**
217- "Would you rehire them?"
218- "Is there anything else I should know?"
219- "How do they compare to peers?"
220 
221### The "Would You Rehire?" Question
222 
223**Most important question.** Brief your references that this may be asked and ensure they can answer enthusiastically.
224 
225## Reference List Template
226 
227```
228[YOUR NAME]
229[Your Email] | [Your Phone]
230 
231PROFESSIONAL REFERENCES
232 
233[REFERENCE 1 - MOST SENIOR/RELEVANT]
234[Name]
235[Title]
236[Company]
237Phone: [Number]
238Email: [Email]
239Relationship: [How you worked together, dates]
240 
241[REFERENCE 2]
242[Name]
243[Title]
244[Company]
245Phone: [Number]
246Email: [Email]
247Relationship: [How you worked together, dates]
248 
249[REFERENCE 3]
250[Name]
251[Title]
252[Company]
253Phone: [Number]
254Email: [Email]
255Relationship: [How you worked together, dates]
256 
257---
258References available upon request for additional contacts.
259```
260 
261## Reference Timing
262 
263### When to Provide References
264 
265- **Don't include with initial application** (unless requested)
266- **Bring to interview** (have them ready)
267- **Provide when asked** (usually after final interview)
268- **Always ask before sharing** (confirm permission each time)
269 
270### Common Timeline
271 
2721. **Application:** "References available upon request" (optional on resume)
2732. **First Interview:** Have list ready but don't offer
2743. **Final Rounds:** "Can you provide references?" → Share list
2754. **Reference Check:** Company contacts your references
2765. **Offer:** Follow up with references, thank them
277 
278## Output Format
279 
280When building a reference list:
281 
282```markdown
283# REFERENCE LIST
284 
285## Reference Strategy
286**Target Role:** [Position]
287**Company:** [Company]
288 
289## Recommended References
290 
291### Primary References (Use These)
292 
293**Reference 1: [Name]**
294- Current Title: [Title]
295- Company: [Company]
296- Contact: [Phone/Email]
297- Relationship: [Description]
298- Why: [What they can speak to]
299- Key points to highlight: [Specific projects/skills]
300 
301**Reference 2: [Name]**
302[Same format]
303 
304**Reference 3: [Name]**
305[Same format]
306 
307### Backup References (If Needed)
308 
309**Reference 4: [Name]**
310[Same format]
311 
312## Briefing Notes
313 
314### For Each Reference, Send:
315- [ ] Resume
316- [ ] Job description
317- [ ] Key talking points
318- [ ] Timeline
319 
320### Key Points to Emphasize
321- [Point 1 - who should mention]
322- [Point 2 - who should mention]
323 
324## Reference Outreach
325 
326### Permission Request Script
327[Customized script]
328 
329### Briefing Email
330[Draft briefing email]
331 
332### Thank You Template
333[Post-check thank you message]
334```
335 
336## Reference Checklist
337 
338- ✅ Have 3-5 references ready
339- ✅ All references have given permission
340- ✅ Contact information is current and accurate
341- ✅ References know about the specific role
342- ✅ Each reference has your resume and talking points
343- ✅ At least one direct supervisor included
344- ✅ References span different aspects of your work
345- ✅ References are enthusiastic (not just willing)
346- ✅ Backup references identified
347- ✅ Thank you notes planned
348 

Discussion

Alternatives

Also in Job hunting