Interview kits
Structured interview templates, scorecard competencies, panel feedback, and enforcement under structured_interviews.
Structured interviews standardize live interview prep and feedback through interview kits and scorecard templates. Gated by structured_interviews.
Settings → Interview Kits (/dashboard/settings/interview-kits) manages kits, scorecard templates, and org-wide enforcement rules.
Feature gate
Probe: trpc.interviewKits.capabilities
When disabled, interview scheduling still works but kits, structured scorecards, panel matrix, and advance enforcement are unavailable.
Concepts
| Concept | Description |
|---|---|
| Interview kit | Prep content + suggested questions + linked scorecard template for an interview type |
| Scorecard template | Reusable competency list interviewers rate after each session |
| Scorecard | Instance submitted by an interviewer for a specific interview |
| Enforcement | Optional rule blocking pipeline advance until required feedback is in |
Interview kits
Each kit includes:
| Field | Purpose |
|---|---|
name | e.g. "Technical Phone Screen", "Panel - Values" |
description | Internal summary for recruiters |
prepContent | Markdown/HTML shown to interviewers before the session |
questions | Up to 50 suggested questions with optional competencyLabel |
scorecardTemplateId | Linked template for post-interview ratings |
Suggested questions
Questions are JSON objects:
{ "id": "q1", "text": "Describe a time you...", "competencyLabel": "Problem solving" }competencyLabel maps loosely to scorecard items — helps interviewers cover each competency.
Using kits on interviews
When scheduling from a candidate profile, recruiters attach a kit. Interviewers receive prep content and the linked scorecard opens automatically after the session.
Scorecard templates
Templates define competency rows (items):
| Item field | Description |
|---|---|
label | Competency name (e.g. "Communication", "Technical depth") |
description | Rating guidance for interviewers |
required | Must be rated before submit |
sortOrder | Display order |
New orgs can seed a default template via trpc.interviewKits.seedDefaultScorecardTemplate.
Submitting scorecards
Interviewers rate each item (typically 1–5 or qualitative scale depending on UI config) and add overall notes. Submissions aggregate on the candidate profile as a panel feedback matrix — rows are competencies, columns are interviewers.
Enforcement settings
Org admins configure enforcement from the Interview Kits settings page (getEnforcementSettings / updateEnforcementSettings):
| Setting | Effect |
|---|---|
| Require scorecard before advance | Blocks kanban/stage move until all assigned interviewers submit |
| Minimum scorecards | Number of required submissions per stage transition |
| Grace period | Optional hours before hard block |
Enforcement integrates with custom_pipelines — stage advance checks call scorecard completion validators in insighthire-api/src/routers/scorecards.ts.
When enforcement fails, the UI surfaces which interviewers have pending scorecards.
API namespace
| Procedure group | Purpose |
|---|---|
interviewKits.capabilities | Gate probe |
interviewKits.listKits / getKit / createKit / updateKit | Kit CRUD |
interviewKits.listScorecardTemplates / createScorecardTemplate / updateScorecardTemplate | Template CRUD |
interviewKits.seedDefaultScorecardTemplate | Bootstrap default template |
interviewKits.getEnforcementSettings / updateEnforcementSettings | Org policy |
scorecards.* | Interviewer submission, panel aggregation |
Workflow example
flowchart LR
A[Create scorecard template] --> B[Create interview kit linked to template]
B --> C[Schedule interview with kit]
C --> D[Interviewer reads prep]
D --> E[Live interview]
E --> F[Submit scorecard]
F --> G[Panel matrix updates]
G --> H{Enforcement on?}
H -->|All complete| I[Allow stage advance]
H -->|Pending| J[Block with reminder]Best practices
- One kit per interview type, not per candidate
- Keep scorecard templates to 5–8 competencies for completion rates
- Mark only truly critical items
required - Turn on enforcement only after pilots — start with visibility-only panel matrix
- Align competency labels with journey evaluation criteria for holistic review
Troubleshooting
| Symptom | Check |
|---|---|
| Settings tab hidden | structured_interviews grant |
| Cannot advance candidate | Enforcement settings; pending scorecards list |
| Empty panel matrix | Scorecards submitted? Correct interview linked? |
| Kit missing template | Link scorecardTemplateId on kit edit |
Related docs
- Pipelines & automations — stage advance integration
- Roles & permissions — interviewer role
- Platform feature flags