spec-interview_skill

This skill conducts structured interviews to refine technical specs from plan.md and auto-generates OpenSpec proposals for spec-driven development.

Python

8

GitHub Stars

1

Bundled Files

2 months ago

Catalog Refreshed

4 months ago

First Indexed

Readme & install

Copy the install command, review bundled files from the catalogue, and read any extended description pulled from the listing source.

Installation

Preview and clipboard use veilstrat where the catalogue uses aiagentskills.

npx veilstrat add skill bahayonghang/my-claude-code-settings --skill spec-interview

SKILL.md2.0 KB

Overview

This skill conducts structured, Socratic interviews to turn draft specifications into complete, actionable technical documents and automatically creates an OpenSpec proposal after the interview. It is designed to drive spec-driven development and ensure decisions, risks, and implementation tasks are recorded and ready for execution. The result is a traceable proposal, prioritized tasks, and spec deltas suitable for team review.

How this skill works

The skill reads a provided plan or specification draft, analyzes goals, gaps, and risks, then runs a multi-dimensional interview guided by engineering principles (KISS, YAGNI, DRY, SOLID). It probes architecture, API design, data models, testing, UI/UX, and operational concerns, identifies high-risk operations, and recommends mitigations. After the interview it generates a structured OpenSpec proposal with proposal.md, tasks.md, and spec delta files for clear implementation and review.

When to use it

When a draft spec needs clarification before engineering work begins
For design reviews and trade-off analysis of technical approaches
When preparing a prioritized implementation plan tied to acceptance criteria
Before significant infrastructure or schema changes to capture rollback and backup plans
To convert informal decisions from meetings into reviewable spec deltas

Best practices

Prepare business context and constraints before the interview to speed up deep questioning
Answer uncertain items candidly — request option comparisons where you lack a firm choice
Follow Read-before-Write: review generated proposal before applying changes
Share the generated proposal with stakeholders for early review and alignment
Iterate: use follow-up interviews to refine acceptance criteria and tasks

Example use cases

Refine a user-management API draft into a production-ready spec with authentication and RBAC decisions
Evaluate multiple tech-stack options and produce a trade-off summary and implementation tasks
Identify and mitigate risks for a database schema migration with rollback and backup steps
Create spec deltas for incremental feature delivery and generate a prioritized task list for sprint planning
Audit a design for maintainability, testing strategy, and adherence to SOLID/DRY principles

FAQ

You receive a structured OpenSpec proposal containing a proposal summary, prioritized tasks, and spec delta files that mark additions, modifications, and deletions.

How does the skill detect high-risk operations?

It identifies operations like file deletion, force-push, env var changes, schema migrations, and bulk dependency updates, then provides impact descriptions, rollback steps, backup strategies, and testing guidance.

Can I iterate on the generated proposal?

Yes. The proposal is intended for review and refinement; you can run follow-up interviews to expand details, adjust priorities, and update acceptance criteria.