spec-creator

Generate engineering-grade specifications for software features and systems.

Updated Sep 25, 2025
One-click install
npx skills add https://github.com/iyaki/opencode-base-template --skill spec-creator-iyaki
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-creator
Source: https://github.com/iyaki/opencode-base-template/tree/main/.agents/skills/spec-creator
Command: npx skills add https://github.com/iyaki/opencode-base-template --skill spec-creator-iyaki

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Spec Creator helps teams produce engineering-grade specifications that are explicit, testable, and implementation-ready, reducing back-and-forth and ambiguity.

Core Features & Use Cases

  • Generates a complete, canonical spec using the SPEC_TEMPLATE.md, covering scope, goals, data models, workflows, APIs, security considerations, and validation criteria.
  • Ensures consistency across projects by enforcing a single source of truth for requirements and architectural decisions.
  • Use Case: When starting a new feature, generate a full spec document that can be handed to engineers, QA, and stakeholders.

Quick Start

Provide a complete, implementation-ready spec document for a new feature using the SPEC_TEMPLATE.

Frequently Asked Questions about spec-creator

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

FAQPage Schema
How do I generate an engineering-grade specification for a new software feature?

To generate an engineering-grade specification, define the scope, goals, non-goals, architecture, data models, workflows, APIs, and verification criteria. This ensures the resulting spec is explicit, testable, and implementation-ready for engineers and stakeholders.

What should be included in a software design doc to make it testable?

A testable software design doc must include explicit scope, non-goals, architecture decisions, data models, workflows, APIs, security considerations, and validation criteria. Defining these elements ensures consistency and reduces ambiguity across engineering teams.

How do I create a consistent spec template for API and data model architecture?

You can create a consistent spec template by enforcing a single source of truth for requirements and architectural decisions. The template should systematically cover APIs, data models, workflows, and security considerations to maintain consistency across different projects.

Can I use this specification generator for product requirements and stakeholder alignment?

Yes, this specification generator applies to product and engineering contexts. It produces a canonical spec document covering scope and validation criteria, which can be handed directly to engineers, QA, and stakeholders to ensure alignment.

What is the best way to document architecture decisions and security considerations in a feature spec?

The best way to document architecture decisions and security considerations is using a formal spec template. This ensures all architectural choices, workflows, and security constraints are explicitly defined, testable, and treated as a single source of truth.

Why do I need formal verification criteria in my software requirements document?

You need formal verification criteria in your software requirements document to ensure the specification is implementation-ready and testable. Explicit criteria reduce back-and-forth ambiguity by providing engineers and QA with clear validation standards.