Source profileQuality 91/100

PramodDutta/qaskills/seed-skills/reference-list-builder/SKILL.md

Reference List Builder

Format professional references properly and prepare reference materials

Source repository stars
211
Declared platforms
3
Static risk flags
0
Last source update
2026-08-28
Source checked
2026-08-28

Decision brief

What it does: where it fits

Format professional references properly and prepare reference materials

Best for

  • Needs to create a professional reference list
  • Wants help choosing the right references
  • Needs to format references properly

Not for

  • Tasks that require unconfirmed production actions or broad system permissions.
  • Environments where the pinned source and install steps cannot be inspected.

Compatibility matrix

Platform support, with evidence labels

PlatformStatusEvidenceWhat to check
CodexDeclaredSource recordInstall path and trigger
Claude CodeDeclaredSource recordInstall path and trigger
CursorDeclaredSource recordInstall path and trigger
Gemini CLINot declaredNo explicit evidencePortability before use
Open the compatibility checker

Installation

Inspect first. Install second.

The source command is displayed only when detected. A safe inspection prompt is always available so your agent can explain every action before execution.

Source-detected install commandSource
npx skills add https://github.com/PramodDutta/qaskills --skill "seed-skills/reference-list-builder"
Safe inspection promptEditorial

Inspect the Agent Skill "Reference List Builder" from https://github.com/PramodDutta/qaskills/blob/fb3fbec70591bad971dd97c5d9add6eaa99bae18/seed-skills/reference-list-builder/SKILL.md at commit fb3fbec70591bad971dd97c5d9add6eaa99bae18. List every install step, command, network request, credential, file read/write, external action, and rollback step. Explain whether it fits my task. Do not install or execute anything until I approve.

Workflow

What the source asks the agent to do

  1. 01

    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

    Call or email to ask permissionConfirm their contact informationExplain the role you're applying for
  2. 02

    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

    Copy of your resumeJob descriptionKey points you want highlighted
  3. 03

    Step 3: Follow Up

    After references are checked: - Thank your references regardless of outcome - Let them know the result - Offer to reciprocate

    Thank your references regardless of outcomeLet them know the resultOffer to reciprocate
  4. 04

    Reference Won't Give Positive Review

    Don't use them. It's better to have fewer references than a lukewarm or negative one.

    Don't use them. It's better to have fewer references than a lukewarm or negative one.
  5. 05

    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", "r…

    Needs to create a professional reference listWants help choosing the right referencesNeeds to format references properly

Permission review

Static risk signals and limitations

No configured static risk pattern was detected

This is not proof of safety. Runtime behavior, indirect dependencies, and hidden external systems are outside the static scan.

Evidence record

Why each signal appears

EvidenceSourceComputedTestedEditorial
SignalValueEvidence typeMeaning
Quality score91/100ComputedDocumentation, specificity, maintenance, and trust rules
Repository stars211SourceRepository attention, not individual Skill quality
Compatibility3 platformsSourceDeclared in the catalog source record
Usage guideautomated source guideEditorialGenerated or reviewed according to the visible evidence level

Pinned source

Provenance and original SKILL.md

Repository
PramodDutta/qaskills
Skill path
seed-skills/reference-list-builder/SKILL.md
Commit
fb3fbec70591bad971dd97c5d9add6eaa99bae18
License
MIT
Collected
2026-08-28
Default branch
main
View the original SKILL.md

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

For QA and Testing Roles

The strongest QA references are the people your testing directly protected: the engineering manager whose releases you gated, the developer whose bugs you caught pre-production, the product manager whose launch you saved. A developer saying "their bug reports were the best I have worked from" outweighs another QA colleague's praise. Brief each reference on the specific claims they can support (the framework you built, the incident you prevented) so their story matches your resume's numbers.


License and attribution

Adapted for QA professionals by The Testing Academy (thetestingacademy) from Resume Skills. The original work is used under the MIT License, reproduced in full below. Modifications to this file are released under the same license.

MIT License

Copyright (c) 2026 Resume Skills

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

Frequently asked questions

What to verify before installation and use

What does the Reference List Builder source document cover?

Format professional references properly and prepare reference materials

How do I install Reference List Builder?

The source record exposes this install command: npx skills add https://github.com/PramodDutta/qaskills --skill "seed-skills/reference-list-builder". Inspect the command and pinned source before running it.

Which Agent platforms does the source record declare?

The pinned source record declares support for: codex, claude code, cursor.

Alternatives

Compare before choosing