candidate-intake

Candidate Intake

Turn applicants who arrive through many different channels into one running, scored master Google Sheet, then help the user pick who to contact and send the outreach. This is a recruiting funnel in a box: it does not matter whether someone applied on Indeed, emailed a resume, commented on a Facebook job post, or sent a Messenger DM. They all land in the same sheet, scored the same way, so the user has a single ranked view of every candidate.

  Indeed -+
  Gmail  -+
  FB post-+--> normalize --> score --> dedupe -->  ONE master Google Sheet
  FB DM  -+                                          |
  paste  -+                                          v
                                    review ranked list --> approved outreach

The guiding idea: organize and score everyone first, then let the user decide who gets outreach. Never message people before the user has seen the ranked list and chosen. That review gate is the whole point, so respect it.

Prerequisites

This skill works almost entirely through the browser, so a community member can use it with zero API keys or developer setup.

• Claude in Chrome extension connected. Gmail, Facebook, Indeed, and Google Sheets are all read and written through Chrome. If it is not connected, ask the user to connect it before proceeding.
• A Google account with the applicant channels logged in in that Chrome profile (Gmail, and Facebook if they use it).
• A master Google Sheet. Setup helps the user create one, or point at an existing sheet.
• A config file, .candidate-intake-config.json, saved in the working folder. It holds the role definition, scoring rubric, sheet URL, and outreach templates so every run and the daily sweep behave consistently.

Step 0: Setup (run once, or when the role changes)

Before the first intake, check the working folder for .candidate-intake-config.json.

• If it is missing, run setup: read references/setup-and-config.md and follow it. Setup collects the role and company, the must-have and nice-to-have criteria, the screener questions and their ideal answers, the scoring weights, the sender's first name, and the outreach templates. It then creates (or adopts) the master Google Sheet and writes the header row. Save the result to .candidate-intake-config.json using assets/config.template.json as the shape.
• If it exists, load it and continue. If the user says the role or criteria changed, re-run the relevant part of setup and save.