site-interviewer

Guide a structured interview and output site-brief.json with interview-summary.md.

10|2|Updated Mar 31, 2026
One-click install
npx skills add https://github.com/mrhinkle/VibeCoding-a-Website --skill site-interviewer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: site-interviewer
Source: https://github.com/mrhinkle/VibeCoding-a-Website/tree/main/.claude/skills/site-interviewer
Command: npx skills add https://github.com/mrhinkle/VibeCoding-a-Website --skill site-interviewer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill conducts a structured interview with users to gather comprehensive website requirements and outputs a site-brief.json that all downstream skills consume.

Core Features & Use Cases

  • Structured interview flow guides the client through sections on business essentials, audience, brand, pages, features, content strategy, SEO, and deployment to surface complete requirements.
  • Outputs to leverage downstream include site-brief.json (structured data for all downstream skills) and interview-summary.md (human-readable summary) to accelerate design, development, and content work.
  • Use case: a consultant performs a 30-minute discovery interview with a client; the produced site-brief.json informs branding, copy, page structure, and technical decisions.

Quick Start

Initiate a warm, guided interview with the client and generate site-brief.json and interview-summary.md outputs.

Frequently Asked Questions about site-interviewer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I turn client interview notes into a structured site brief?

You can turn client discovery notes into a site brief by running a structured interview that captures business goals, audience, and branding, automatically outputting a site-brief.json and an interview-summary.md for downstream use.

What is the best way to automate website requirements discovery for UX research?

Website requirements discovery is best automated through a guided interview that asks non-technical questions about business essentials, pages, and content strategy, translating the answers directly into a structured JSON schema.

How do I generate a JSON output schema from a website discovery interview?

To generate a JSON output schema from a discovery interview, use a structured conversation flow that enforces data structure and safety, producing a site-brief.json file alongside a human-readable summary of the collected requirements.

Can I use a guided interview to collect technical needs and SEO goals for a site brief?

Yes, a guided interview can collect technical needs and SEO goals by walking the client through targeted discovery sections, ensuring all critical website requirements are surfaced and saved into the final site brief output.

Does the site interview process require any specific technical dependencies or components?

The site interview process requires no external dependencies or components, operating independently to facilitate the conversation and generate the required JSON data and markdown summary files for downstream workflows.

What downstream tasks can consume the site-brief.json generated from the interview?

Downstream tasks that can consume the site-brief.json include design, development, and content workflows, using the structured data to inform branding, copy, page structure, and technical decisions without needing manual data entry.