interview-me

interview-me

A Claude Code skill that interviews you like a senior architect before you write code.

 

Why This Exists

When you're building alone, there's no one to challenge your assumptions. Requirements start as vague ideas, edge cases get discovered in production, and security concerns become afterthoughts.

interview-me is the senior architect you wish you had on the team. It reads your requirement, checks whether your existing code is even relevant (and asks before scanning it — or runs in greenfield mode if there's nothing yet), then asks hard questions one at a time — pushing back on contradictions, probing edge cases, and hard-blocking on security gaps. Outputs a production-grade markdown spec with decisions log and implementation order.

Optionally publishes a diagram-first spec preview as a shareable Claude Artifact — flow diagrams, an at-a-glance summary, and a dependency graph on a private claude.ai link you can share with teammates for review before finalizing.

Install

As a plugin (recommended) — one command, versioned updates:

/plugin marketplace add Sorbh/interview-me
/plugin install interview-me@sorbh

Manual install — copy the skill files directly:

mkdir -p ~/.claude/skills/interview-me
curl -o ~/.claude/skills/interview-me/SKILL.md \
  https://raw.githubusercontent.com/Sorbh/interview-me/main/skills/interview-me/SKILL.md
curl -o ~/.claude/skills/interview-me/STYLE_PRESETS.md \
  https://raw.githubusercontent.com/Sorbh/interview-me/main/skills/interview-me/STYLE_PRESETS.md

Use one method or the other — installing both ways gives you duplicate skills.

Usage

/interview-me path/to/requirements.md
/interview-me "I want to build a user auth system with OAuth"
/interview-me #42
/interview-me https://github.com/owner/repo/issues/42

Point it at a GitHub issue and it pulls the title, body, and comments as the requirement — and offers to post the finished spec back to the issue.

---

If this saves you from one bad architectural decision, consider giving it a star.

License

MIT