spec-factory

Generate structured JSON specifications from natural language requirements.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/Minh-Tam-Solution/MTClaw --skill spec-factory
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-factory
Source: https://github.com/Minh-Tam-Solution/MTClaw/tree/main/docs/08-collaborate/skills/spec-factory
Command: npx skills add https://github.com/Minh-Tam-Solution/MTClaw --skill spec-factory

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates the creation of structured specifications from natural language requirements, ensuring clarity and consistency in project documentation.

Core Features & Use Cases

  • Structured Specification Generation: Converts informal requests into a formal JSON specification.
  • Acceptance Criteria: Automatically generates BDD-style acceptance criteria (Given/When/Then).
  • Risk Assessment: Includes a section for identifying and assessing project risks.
  • Use Case: A product manager can describe a new feature in plain English, and this Skill will generate a detailed specification including user stories, acceptance criteria, and potential risks.

Quick Start

Use the spec-factory skill to generate a specification for a new user login feature.

Frequently Asked Questions about spec-factory

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

FAQPage Schema
How do I generate structured specifications from natural language requirements?

You can generate structured specifications by providing informal natural language requirements, which are automatically converted into a formal JSON specification adhering to a defined schema. This ensures clarity and consistency for product development and engineering teams.

Can I create BDD-style acceptance criteria from plain English feature descriptions?

Yes, you can create BDD-style acceptance criteria directly from plain English feature descriptions. The system automatically generates Given/When/Then scenarios to facilitate clear documentation and testing boundaries for product management.

Does specification generation work with Vietnamese input requirements?

Specification generation fully supports Vietnamese input requirements alongside English. It processes the natural language input to produce structured JSON specifications, BDD acceptance criteria, and technical requirements for your project documentation.

What is the best way to document project risks when writing product specifications?

The best way to document project risks is to use automated specification generation that includes a dedicated risk assessment section. This identifies and evaluates potential project risks directly within the formal JSON specification output.

How do I convert a user story into a JSON format specification for engineering teams?

To convert a user story into a JSON specification, input your plain text description and the system maps it to a defined schema. It outputs structured technical requirements and acceptance criteria formatted for engineering team consumption.