candidate-interview-kit

Candidate Interview Kit

A product of theProductPath

---

What This Is

The Candidate Interview Kit is an AI-powered workflow for hiring teams. It gives every interviewer consistent, evidence-based preparation before an interview — and a structured way to capture and compare assessments after. When the hire is made, the kit gets retired. It’s a Burner App for the hiring process.

The impermanence is the point. This kit is bespoke for one role, one hiring cycle. It’s not a platform. It has no login, no database, no ongoing subscription. When you’ve made your hire, delete the folder.

Landing page: candidate-interview-kit-site

---

Two Versions

Individual Kit

One interviewer. One role. Full pipeline.

The interviewer (or hiring manager working alone) uses the kit to:

1. Generate a prep brief for each candidate before the interview
2. Structure their post-interview assessment while it’s fresh
3. Compare all candidates in a single Burner App

No shared infrastructure required. One folder, one person, one decision.

Team Kit

Multiple interviewers. Same role. Coordinated assessments.

Each interviewer gets personalized prep briefs based on their focus areas. Each submits independent assessments. The hiring manager sees all assessments in one comparison tool, with the ability to toggle each interviewer’s input on and off.

---

The Three Roles

Role	Who They Are
Setup	Whoever initializes the folder — loads the JD, adds resumes as candidates arrive
Hiring Manager	Defines focus areas for the interviewer; makes the final call
Interviewer	Uses the prep brief before interviews; submits assessments after

In a solo hiring loop, one person plays all three roles.

---

Folder Structure (Individual Kit)

{Company}-{Role}/
├── job-description.md          ← JD text (source of truth, static)
├── interviewer-notes.md        ← Hiring Manager's focus areas for the interviewer
├── candidates/
│   └── {candidate-name}/
│       ├── resume.pdf          ← source resume
│       ├── brief.md            ← AI-generated pre-interview prep
│       └── assessment.md       ← AI-structured post-interview notes
└── comparison.html             ← Burner App comparing all candidates (generated by skill)

---

How It Works

The kit runs through three steps, in order, for each candidate:

1. Prep — Point the skill at a candidate folder. It reads the JD, the interviewer notes, and the resume. It produces a prep brief: competency scores, areas to probe, suggested questions, red flags.

2. Assess — After the interview, share your raw notes with the skill. It structures them into a clean assessment: qualitative scores, evidence, strengths, concerns.

3. Compare — Once you have assessments for all candidates, the skill generates comparison.html — a self-contained Burner App showing all candidates side-by-side. Open it in a browser. Make your decision. Delete the folder.

---

What’s in This Folder

candidate-interview-kit/
├── README.md                   ← This file
├── individual-kit/             ← One interviewer, one role, full pipeline
│   ├── SKILL.md                ← The AI skill (copy this to your kit folder)
│   ├── skill/                  ← Supporting skill files (copy this too)
│   └── example/                ← Working example (AirCorp — Product Analyst)
│       └── AirCorp-ProductAnalyst/
│           ├── job-description.md
│           ├── interviewer-notes.md
│           ├── candidates/
│           └── comparison.html
├── team-kit/                   ← Multiple interviewers, coordinated assessments
│   ├── SKILL.md                ← The team AI skill
│   ├── skill/                  ← Team-specific scripts and comparison template
│   └── example/                ← Working example (AirCorp — 4 interviewers, 4 candidates)
│       └── AirCorp-ProductAnalyst/
│           ├── _team.md
│           ├── job-description.md
│           ├── candidates/
│           └── comparison.html

---

Getting Started

Individual Kit (solo interviewer)

1. Download or clone this repo
2. Start a session in your preferred LLM tool with individual-kit/ as the working directory
3. Type initialize — the LLM scaffolds a fresh working kit
4. Add a job description file and optionally interviewer notes
5. Add candidates and follow the prep → assess → compare workflow

cd individual-kit
node skill/scripts/init-kit.js /path/to/new-kit-folder

Team Kit (multiple interviewers)

1. Start a session with team-kit/ as the working directory
2. Type initialize — the LLM scaffolds a team kit with _team.md
3. Edit _team.md with your interviewer roster and focus areas
4. Add a job description file
5. Add candidates, generate per-interviewer briefs, capture assessments, and refresh the team comparison tool

cd team-kit
node skill/scripts/init-team-kit.js /path/to/new-kit-folder

The skill handles the rest.

File Expectations

• A job description file is required before the skill can generate briefs, assessments, or the comparison tool.
• Accepted JD examples: job-description.md, jd.pdf, role-description.docx
• Individual Kit: Interviewer notes are optional but recommended.
• Team Kit: _team.md is required — it defines the interviewer roster and per-interviewer focus areas.
• add-candidate.js will try to refresh comparison.html automatically after creating the folder.
• If a candidate name is entered incorrectly, use node skill/scripts/rename-candidate.js "Old Name" "New Name".

---

*Candidate Interview Kit — theProductPath

Built by Steven Jones*