https://github.com/sorbh/interview-me

A Claude Code skill that turns vague requirements into production-grade specs — by interviewing you like a senior architect would.
https://github.com/sorbh/interview-me

ai-tools claude claude-code developer-tools llm prompt-engineering specification

Last synced: 4 months ago
JSON representation

A Claude Code skill that turns vague requirements into production-grade specs — by interviewing you like a senior architect would.

• Host: GitHub
• URL: https://github.com/sorbh/interview-me
• Owner: Sorbh
• License: mit
• Created: 2026-02-21T18:00:27.000Z (4 months ago)
• Default Branch: main
• Last Pushed: 2026-02-26T08:47:42.000Z (4 months ago)
• Last Synced: 2026-02-27T13:13:05.649Z (4 months ago)
• Topics: ai-tools, claude, claude-code, developer-tools, llm, prompt-engineering, specification
• Size: 1.09 MB
• Stars: 14
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# interview-me

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

[![Claude Code Skill](https://img.shields.io/badge/Claude%20Code-Skill-blue)](https://docs.anthropic.com/en/docs/claude-code)   [![MIT License](https://img.shields.io/badge/License-MIT-green)](LICENSE)

![interview-me in action](assets/interview-me-preview.gif)

## 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, scans your codebase, 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 spec with decisions log and implementation order.

Optionally generates an **interactive HTML preview** with inline commenting so you can visually review and annotate the spec before finalizing.

## Install

```bash

mkdir -p ~/.claude/skills/interview-me

curl -o ~/.claude/skills/interview-me/SKILL.md \

  https://raw.githubusercontent.com/Sorbh/interview-me/main/interview-me/SKILL.md

curl -o ~/.claude/skills/interview-me/STYLE_PRESETS.md \

  https://raw.githubusercontent.com/Sorbh/interview-me/main/interview-me/STYLE_PRESETS.md

```

## Usage

```

/interview-me path/to/requirements.md

/interview-me "I want to build a user auth system with OAuth"

```

## License

MIT