Reference Check Checklist

WHAT IT DOES

Provides a structured checklist panel for conducting reference checks during the hiring process. The script displays a comprehensive checklist organized by reference check categories including Contact Information, Role Confirmation, Performance Evaluation, Strengths Identified, Areas for Development, Teamwork Assessment, Integrity Check, and Overall Recommendation. Each category contains specific questions to guide the reference conversation. You can mark items as completed, add notes to each item, and track overall progress with a percentage indicator and visual progress bar. Custom questions and sections can be added to tailor the checklist to your organization's needs. A summary section shows time elapsed since the reference check began.

WHERE IT RUNS

Works on all websites (match pattern *://*/*), making it perfect for HR portals, recruiting platforms, candidate management systems, or any web-based hiring workflow. Each candidate gets their own independent checklist, allowing you to manage multiple reference checks simultaneously. The checklist state is saved per candidate identifier, ensuring continuity across sessions and page reloads.

HOW TO USE

Install the script and the reference checklist appears in the panel. Enter a candidate identifier to associate the checklist with a specific candidate. Work through the questions category by category, checking items off as you complete them. Add notes to any item to capture important details. Click "Add Question" to add custom questions to any existing category. Click "Add Section" to create entirely new categories. The progress bar updates in real-time showing completion percentage. Use the actions buttons to reset the checklist, complete all items, or clear completed items. The script saves your progress automatically as you work.

REAL MECHANISM: CANDIDATE-KEYED PERSISTENCE WITH SECTIONED QUESTION MANAGEMENT

This script uses a candidate-based storage architecture where each candidate gets their own isolated checklist state. The getCandidateId() function retrieves the current candidate identifier from GM_setValue or generates a new one. Data is stored using GM_setValue with a key format of "reference_check_" plus the candidate ID, ensuring data isolation between candidates. The data structure includes an items array where each item has an id, sectionId (linking to a section), text, completed boolean, and notes string. Sections are defined separately in defaultSections and customSections, allowing flexible categorization. The renderChecklist() function groups items by sectionId using filter(), rendering section headers followed by their associated items. Each item renders as a flex row with a checkbox input that toggles completed state, triggering saveReferenceData() and re-rendering. Notes fields are conditionally rendered based on the showNotes setting, with input elements that persist notes on blur events. Custom sections are stored globally using the key "reference_custom_sections" and merged with default sections during rendering. The elapsed time calculation uses Math.min() and Date.now() to show how long the reference check has been in progress. All operations are reactive, with automatic persistence and UI updates.

THE PANEL

Drag the panel anywhere on screen by clicking and holding the header. It snaps to screen edges when released. Collapse it to a small bubble by clicking the minimize button, and expand it back by clicking the bubble. Resize the panel from any corner. Press Escape to close the configuration panel. Your position and size preferences are saved automatically per site.

PLEASE NOTE

This script requires the free BotGentz browser extension which provides the BGPanel framework and storage APIs. All data (items, notes, custom sections, and candidate identifiers) is stored locally in your browser using GM_setValue and never sent anywhere. No analytics, no tracking, no external calls. The script only reads the current domain and candidate identifier to isolate checklists and never accesses user data, passwords, or sensitive information. Checklists are saved per candidate identifier, so ensure you enter a unique identifier for each reference check you conduct.