Agent skill

Reference List Builder

by davila7 in davila7/claude-code-templates

Format professional references properly and prepare reference materials.

MITAuto-check passedResearch & Science

Install Reference List Builder

skills CLI
$ npx skills add davila7/claude-code-templates --skill reference-list-builder -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install davila7/claude-code-templates reference-list-builder --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/davila7/claude-code-templates.git skills-src && mkdir -p .claude/skills && cp -r skills-src/cli-tool/components/skills/career/reference-list-builder .claude/skills/reference-list-builder && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
reference-list-builder
GitHub stars
32k
Used in
2 other repos
Token cost
~2.1k tokens
SKILL.md length
702 words
Files
1
Skills in repo
477
Repo updated
First seen
Licence
MIT

At a glance

Format professional references properly and prepare reference materials.

  • Works in 3 steps: Ask Permission → Brief Your References → Follow Up
  • The user mentions references
  • SKILL.md covers When to Use This Skill, Core Capabilities, Reference Strategy and Reference List Format, plus 7 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Reference List Builder is an agent skill from davila7/claude-code-templates. Format professional references properly and prepare reference materials. Use when the user mentions references, reference list, references page, or preparing referees for a job application.

Its SKILL.md is about 2.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Research & Science, covering Citation management and Job search and resumes. The repository describes itself as: CLI tool for configuring and monitoring Claude Code. The licence is MIT.

When your agent uses it

  • The user mentions references
  • References page
  • Preparing referees for a job application

Example prompts

  • “/reference-list-builder”

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Ask Permission
  2. Brief Your References
  3. Follow Up

What it can do on your machine

Read from SKILL.md and the folder at commit 4c82aba. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Reference List Builder loads about 2.1k tokens when it runs. Until then it costs about 53 tokens; SKILL.md has 702 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~53
When it runs · the whole SKILL.md, loaded when a task matches
~2.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from davila7/claude-code-templates at commit 4c82aba, republished under its MIT licence (© davila7). 702 words, ~2,115 tokens.

Download SKILL.mdSave it as .claude/skills/reference-list-builder/SKILL.md (or your agent's skills folder).
name
reference-list-builder
description
Format professional references properly and prepare reference materials. Use when the user mentions references, reference list, references page, or preparing referees for a job application.

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: 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
  • 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
Show full SKILL.md (284 more words)Show less
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

© davila7, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in cli-tool/components/skills/career/reference-list-builder of davila7/claude-code-templates.

Open the folder on GitHubat commit 4c82aba

Used in 2 other repositories

We found 3 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 2 other GitHub owners. This page covers the copy in davila7/claude-code-templates, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Reference List Builder next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Reference List Builder compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Reference List Builder this skilldavila7/claude-code-templates32k2 repos~2.1kAutomated safety check: PassMIT
Content Research Writerweapp-tailwindcss/weapp-tailwindcss1.9k25 repos~3.5kAutomated safety check: PassMIT
NetworkxzLanqing/codex-claude-academic-skills4.6k16 repos~3.2kAutomated safety check: PassBSD-3-Clause
Citation Verification GuideGalaxy-Dawn/claude-scholar5.7k3 repos~1.9kAutomated safety check: PassMIT
Systematic Review ScreenerImbad0202/academic-research-skills51k—~8.4kAutomated safety check: PassCustom licence
Literature Reviewneflibata-feng/MyArxiv-Agent12621 repos~5.9kAutomated safety check: NotesMIT

Similar skills

  • Content Research Writer

    weapp-tailwindcss/weapp-tailwindcss

    Assists in writing high-quality content by conducting research, adding citations, improving hooks, iterating on outlines, and providing real-time feedback on each section.

    1.9k GitHub starsUsed in 25 repos~3.5k tokens
    Research & ScienceAuto-check passed
  • Networkx

    zLanqing/codex-claude-academic-skills

    Comprehensive toolkit for creating, analyzing, and visualizing complex networks and graphs in Python.

    4.6k GitHub starsUsed in 16 repos~3.2k tokens
    Research & ScienceAuto-check passed
  • Citation Verification Guide

    Galaxy-Dawn/claude-scholar

    Reference guidance for checking every citation in academic writing against canonical sources such as DOI, arXiv, CrossRef and Semantic Scholar, to catch fake or wrong references.

    5.7k GitHub starsUsed in 3 repos~1.9k tokens
    Research & ScienceAuto-check passed
  • Systematic Review Screener

    Imbad0202/academic-research-skills

    Screens records for systematic, scoping and rapid reviews against fixed eligibility rules, using two blinded AI reviewers and a third adjudicator, with traceable PRISMA counts.

    51k GitHub stars~8.4k tokensUpdated 4 days ago
    Research & ScienceAuto-check passed
  • Literature Review

    neflibata-feng/MyArxiv-Agent

    Conduct comprehensive, systematic literature reviews using multiple academic databases (PubMed, arXiv, bioRxiv, Semantic Scholar, etc.).

    126 GitHub starsUsed in 21 repos~5.9k tokens
    Research & ScienceAuto-check: notes
  • Openalex Database

    neflibata-feng/MyArxiv-Agent

    Query and analyze scholarly literature using the OpenAlex database.

    126 GitHub starsUsed in 13 repos~3k tokens
    Research & ScienceAuto-check passed

More from davila7/claude-code-templates

All 477 skills in this repo
  • Perplexity Web Search

    davila7/claude-code-templates

    Runs web-grounded searches through Perplexity's Sonar models over OpenRouter for current events, recent literature and cited facts beyond the model's training cutoff.

    32k GitHub starsUsed in 12 repos~3.5k tokens
    Auto-check: notes
  • Neuropixels Data Analysis

    davila7/claude-code-templates

    Analyzes Neuropixels recordings from SpikeGLX or Open Ephys through preprocessing, drift correction, Kilosort4 spike sorting, quality metrics and curation.

    32k GitHub starsUsed in 10 repos~2.8k tokens
    Auto-check passed
  • Scientific Venue Templates

    davila7/claude-code-templates

    Supplies LaTeX templates and formatting rules for journals, conferences, posters, and grant proposals, then can check a draft against them.

    32k GitHub starsUsed in 9 repos~5.1k tokens
    Auto-check: notes
  • Brand Voice Content Creator

    davila7/claude-code-templates

    Analyzes a brand's existing writing to lock in a consistent voice, then builds SEO blog posts and platform-specific social content around it.

    32k GitHub starsUsed in 2 repos~1.9k tokens
    Auto-check passed
  • CAPA Officer

    davila7/claude-code-templates

    Guides corrective and preventive action (CAPA) work in a quality management system, from initiation and root cause analysis through effectiveness verification.

    32k GitHub starsUsed in 1 repo~2k tokens
    Auto-check passed
  • Fda Consultant Specialist

    davila7/claude-code-templates

    Senior FDA consultant and specialist for medical device companies including HIPAA compliance and requirement management.

    32k GitHub starsUsed in 1 repo~2.7k tokens
    Auto-check passed

Questions about Reference List Builder

What does Reference List Builder do?

Format professional references properly and prepare reference materials. Reference List Builder is an agent skill from davila7/claude-code-templates. Format professional references properly and prepare reference materials.

When should I use Reference List Builder?

Reference List Builder fits situations like: the user mentions references; references page; preparing referees for a job application.

How do I install Reference List Builder in Claude Code?

Run `npx skills add davila7/claude-code-templates --skill reference-list-builder -a claude-code`. Or copy the skill folder (cli-tool/components/skills/career/reference-list-builder in davila7/claude-code-templates) into .claude/skills/reference-list-builder in your project. Claude Code loads it when a task matches its description.

How do I install Reference List Builder in Codex?

Run `npx skills add davila7/claude-code-templates --skill reference-list-builder -a codex`. Or copy the skill folder (cli-tool/components/skills/career/reference-list-builder in davila7/claude-code-templates) into .agents/skills/reference-list-builder in your project. Codex loads it when a task matches its description.

Can I use Reference List Builder in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add davila7/claude-code-templates --skill reference-list-builder -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/reference-list-builder, .gemini/skills/reference-list-builder, .github/skills/reference-list-builder and .opencode/skills/reference-list-builder in your project.

What does Reference List Builder need to run?

SKILL.md names no scripts, command-line tools or credentials: Reference List Builder is instructions for the agent only.

Does Reference List Builder access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Reference List Builder safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Reference List Builder use?

Reference List Builder is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Reference List Builder use?

About 2.1k tokens (SKILL.md is roughly 8.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Reference List Builder?

Skills that share tags, products or a category with Reference List Builder: Content Research Writer (weapp-tailwindcss/weapp-tailwindcss, 1.9k stars), Networkx (zLanqing/codex-claude-academic-skills, 4.6k stars), Citation Verification Guide (Galaxy-Dawn/claude-scholar, 5.7k stars) and Systematic Review Screener (Imbad0202/academic-research-skills, 51k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Reference List Builder?

davila7 (a GitHub user) maintains it in davila7/claude-code-templates, which has 32,432 GitHub stars. The repository holds 477 skills in this directory. The repository was last updated on October 7, 2026.

Source: davila7/claude-code-templates on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.