spec

Generate and validate project specification files from JSON and markdown proposals.

4|Updated Feb 24, 2026
One-click install
npx skills add https://github.com/dmitriyb/spexmachina --skill spec-dmitriyb
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec
Source: https://github.com/dmitriyb/spexmachina/tree/main/skills/spec
Command: npx skills add https://github.com/dmitriyb/spexmachina --skill spec-dmitriyb

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires spex, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the authoring and validation of specifications for projects, eliminating manual steps and ensuring consistent, error-free output.

Core Features & Use Cases

  • Automated Spec Creation: Read proposals and automatically generate project.json, module.json, and markdown content files.
  • Validation: Ensures that all generated specifications conform to predefined schemas.
  • Use Case: For a software project, this Skill can process a high-level design document and automatically generate the corresponding project specifications, including JSON structures and markdown content.

Quick Start

Generate a spec from the proposal file 'high-level-design.md' using the spec skill.

Frequently Asked Questions about spec

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

FAQPage Schema
How do I automate software specification authoring from markdown design documents?

To automate specification authoring, you need a tool that reads markdown proposals and generates structured JSON files. This Skill processes high-level design documents to automatically create project specifications, including the necessary JSON structures and markdown content.

How do I validate generated project specifications against predefined schemas?

To validate generated project specifications against predefined schemas, you require an automated validation mechanism. This Skill ensures that all generated JSON structures and markdown specifications conform strictly to your defined schema definitions, eliminating manual error checking.

Can I generate project.json and module.json files automatically from a high-level proposal?

Yes, you can generate project.json and module.json files automatically from a high-level proposal. By reading your input JSON and markdown content, the Skill automatically authors and outputs the corresponding project specification files without manual formatting.

Do I need predefined schema definitions to automate software specification validation?

Yes, you need predefined schema definitions to automate software specification validation. The Skill requires both schema definitions and project proposals as functional inputs to correctly generate and validate the resulting JSON and markdown content.

What is the best way to ensure error-free JSON structures for software project specifications?

The best way to ensure error-free JSON structures for software project specifications is to automate generation and validation against schemas. This Skill eliminates manual authoring steps, ensuring consistent, validated output directly from your project proposals.