spec-assistant

Guide iterative questioning to build testable specifications before coding.

Updated Jan 20, 2026
One-click install
npx skills add https://github.com/harshilparmar/ai-coding-standards --skill spec-assistant
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-assistant
Source: https://github.com/harshilparmar/ai-coding-standards/tree/main/skills/spec-assistant
Command: npx skills add https://github.com/harshilparmar/ai-coding-standards --skill spec-assistant

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The skill helps teams gather clear requirements and craft production-ready specifications through structured questioning, reducing miscommunication and rework.

Core Features & Use Cases

  • Collaborative discovery: asks targeted questions to build a shared spec.
  • Six Core Areas framework: organizes information into Commands, Testing, Project Structure, Code Style, Git Workflow, and Boundaries for clarity.
  • Phase-driven workflow: SPECIFY, PLAN, TASKS, IMPLEMENT with gated progress to ensure quality before coding.
  • Use Case: When starting a new feature, it guides stakeholders to define scope, success metrics, and acceptance criteria before implementation starts.

Quick Start

Describe the feature you want to spec, and I will guide you through discovery questions to build a complete spec.

Frequently Asked Questions about spec-assistant

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

FAQPage Schema
How do I write testable feature specifications before starting development?

To write testable feature specifications, use a guided Q&A process that iteratively gathers requirements across six core areas including Commands, Testing, and Boundaries. This structured discovery defines scope and acceptance criteria before coding begins.

What is the best way to gather clear requirements for technical blueprinting?

The best way to gather clear requirements for technical blueprinting is through collaborative discovery. By asking targeted questions, stakeholders define success metrics and acceptance criteria within a structured framework, reducing miscommunication and rework.

How do I structure feature planning using a phase-based workflow?

You structure feature planning using a phase-based workflow by progressing sequentially through SPECIFY, PLAN, TASKS, and IMPLEMENT phases. Gated progress ensures quality checks pass at each stage before moving to actual coding or technical blueprinting.

Does collaborative Q&A work for defining project structure and code style guidelines?

Yes, collaborative Q&A works for defining project structure and code style guidelines. The framework organizes information into six core areas, explicitly ensuring code style, git workflow, and project structure are clarified during the discovery process.

Can I use guided discovery for gathering requirements across product, design, and engineering teams?

Yes, you can use guided discovery for gathering requirements across product, design, and engineering teams. The iterative questioning process builds shared specifications and aligns cross-functional stakeholders on acceptance criteria before implementation starts.

Why does feature planning require gated progress before implementation?

Feature planning requires gated progress before implementation to enforce self-verification prompts and ensure quality. Completing the SPECIFY, PLAN, and TASKS phases prevents premature coding, reducing rework and miscommunication across technical teams.