How does it ensure the generated specification is actually feasible?

It runs two parallel validators: a quality validator for document structure and an adequacy validator that uses a subagent to check for over-engineering and architectural alignment.

What is the primary output of the User Spec Planning skill?

The skill generates a structured 'user-spec.md' file in your project's work directory, complete with status tracking, acceptance criteria, and technical context.

How does the adaptive interview process work?

The skill asks targeted batches of questions, challenging your responses with codebase references and proposing solutions based on existing project patterns until the requirements reach a high confidence score.

Can I use this for bug fixes as well as new features?

Absolutely. The skill features work-type adaptations that shift the focus toward reproduction steps, root cause analysis, and regression risks when a bug is identified.

Does this skill support languages other than English?

Yes, this specific skill is configured to conduct the planning interview in Russian to better assist Russian-speaking development teams.

User Spec Planning

Name: User Spec Planning
Author: servitola

byservitola

•

협업 도구

Generates comprehensive user-spec.md documents through adaptive interviews, codebase scanning, and automated dual validation.

User Spec Planning is a sophisticated workflow skill for Claude Code designed to transform vague feature ideas into rigorous requirement documents. It acts as an engaged co-thinker, conducting thorough interviews—optimized for Russian-speaking environments—while simultaneously scanning your codebase to ensure technical feasibility. By utilizing subagents for research and validation, it produces high-quality specifications that align with existing project architecture, helping developers define edge cases, deployment steps, and acceptance criteria before writing a single line of code.

주요 기능

01Structured workflow supporting features, bug fixes, and complex refactoring

02Adaptive multi-phase interview process with context-aware questioning

0312 GitHub stars

04Automated codebase scanning via specialized subagents to verify feasibility

05Integration with project-specific knowledge bases and reference files

06Dual validation system checking for both document quality and technical adequacy

사용 사례

01Documenting reproduction steps and regression risks for complex bug fixes

02Defining detailed requirements and acceptance criteria for a new software feature

03Mapping out architectural changes and migration paths for refactoring tasks

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add servitola/dotfiles user-spec-planning

For use in Claude.ai and ChatGPT

주요 기능

01Structured workflow supporting features, bug fixes, and complex refactoring

02Adaptive multi-phase interview process with context-aware questioning

0312 GitHub stars

04Automated codebase scanning via specialized subagents to verify feasibility

05Integration with project-specific knowledge bases and reference files

06Dual validation system checking for both document quality and technical adequacy

사용 사례

01Documenting reproduction steps and regression risks for complex bug fixes

02Defining detailed requirements and acceptance criteria for a new software feature

03Mapping out architectural changes and migration paths for refactoring tasks

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add servitola/dotfiles user-spec-planning

For use in Claude.ai and ChatGPT