interview-system-designer · borghei — Claude Code skill: what it does
interview-system-designer — a skill for Claude Code and five other platforms that builds structured interview loops, writes questions with scoring rubrics, and runs calibration analysis on past results.
LicenseRef-MIT-Commons-Clause 137 installs ★ 1,183 updated 2026-11-08
npx skills add borghei/Claude-Skills --skill interview-system-designer -a claude-codeWhat interview-system-designer does
The skill covers three scenarios: designing an interview loop for a role and seniority level, generating a question bank with rubrics, and doing statistical analysis of completed interview records.
Three Python scripts do the heavy lifting. loop_designer.py builds rounds, distributes competencies and produces scorecards. question_bank_generator.py pulls from scenario stems covering roughly 40 competencies — each with level-specific context (a senior prompt references "the service you own", a staff prompt references "a system several teams depend on"). Any competency without a ready stem gets questions marked "generic": true, which signals that those questions need replacing with scenarios drawn from the team's actual work. hiring_calibrator.py measures interviewer consistency and pass-rate drift; it emits a stderr warning when fewer than 50 records are present, because below that threshold group-level disparity figures are noise.
Calibration analysis requires a JSON file of interview results. Analysing demographic fields for adverse impact may need legal sign-off depending on jurisdiction.
What it helps with
- design an interview loop for a specific role and seniority level
- write competency-based questions with 1–4 scoring anchors per round
- check whether interviewers apply the rubric consistently
- detect pass-rate drift across a batch of completed interviews
- swap out templated questions for scenarios from the team's real stack
Example prompts for the agent
- Build an interview loop for a Senior Software Engineer on the platform team, focusing on system design and reliability
- Generate 9 questions for
react,typescript,system-designcompetencies for a senior Frontend Engineer, output as JSON - Run a comprehensive calibration analysis on
assets/sample_interview_results.jsonand show interviewer drift
How to install interview-system-designer
1Skills CLI (Vercel)
npx skills add borghei/Claude-Skills --skill interview-system-designer -a claude-code2Manually: put the files in place
~/.claude/skills/interview-system-designer/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/interview-system-designer/
1Skills CLI (Vercel)
npx skills add borghei/Claude-Skills --skill interview-system-designer -a codex2Manually: put the files in place
.agents/skills/interview-system-designer/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add borghei/Claude-Skills --skill interview-system-designer -a cursor2Manually: put the files in place
.cursor/skills/interview-system-designer/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install borghei/Claude-Skills engineering/interview-system-designer/SKILL.md2Manually: put the files in place
.github/skills/interview-system-designer/SKILL.md1Skills CLI (Vercel)
npx skills add borghei/Claude-Skills --skill interview-system-designer -a gemini-cli2Platform CLI
gemini skills install https://github.com/borghei/Claude-Skills --path engineering/interview-system-designerManually: put the files in place
.devin/skills/interview-system-designer/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add borghei/Claude-Skills --skill interview-system-designer -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about interview-system-designer
How do I install interview-system-designer in Claude Code?
Run npx skills add borghei/Claude-Skills --skill interview-system-designer -a claude-code. The skill is then available at ~/.claude/skills/interview-system-designer/SKILL.md.
What does the interview-system-designer skill do?
It designs a structured interview loop for a given role and level, generates questions with rubrics and 1–4 scoring anchors, and after real interviews analyses calibration and pass-rate drift via hiring_calibrator.py.
Can the generated question bank be used as-is?
Questions marked "generic": true are placeholders: the script sets that flag when no scenario stem exists for a competency. Those questions need to be replaced with ones grounded in the team's actual problems; the rest already carry level context and stack-specific framing.
Similar skills
All skills for Agent setup: memory, context, orchestration →interview-system-designer by other authors comes first.