Spec

Convert unstructured notes and chats into a formal requirements document.

1|Updated Jan 30, 2026
One-click install
npx skills add https://github.com/samdae/archflow --skill spec-samdae
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Spec
Source: https://github.com/samdae/archflow/tree/main/skills/spec
Command: npx skills add https://github.com/samdae/archflow --skill spec-samdae

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Spec skill transforms scattered materials into structured, testable requirements documents, establishing a single source of truth for product initiatives.

Core Features & Use Cases

  • Collects service names and input materials, performs an iterative refinement loop with Q&A to resolve ambiguities.
  • Generates a formal requirements document structure ready for arch/design handoffs.
  • Supports Notion/Markdown inputs and converts them into a consistent spec format.

Quick Start

Launch the Spec skill, provide the input material (Notion/Markdown or chat history), and name your service. The tool will produce a standardized docs/{serviceName}/spec.md and guide you through the Q&A to finalize the requirements.

Frequently Asked Questions about Spec

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

FAQPage Schema
How do I turn unstructured notes into a formal requirements document?

To turn unstructured notes into a requirements document, provide scattered Markdown or Notion inputs to trigger an iterative Q&A refinement loop that resolves ambiguities and outputs a structured specification.

Can I generate acceptance criteria and traceable IDs from scattered chat history?

Yes, you can generate acceptance criteria and traceable IDs from chat history by feeding the conversations as input material, which the system converts into a standardized specification format with unique identifiers.

Does this requirements generation process support Markdown and Notion inputs?

The requirements generation process supports both Notion and Markdown inputs, converting them into a consistent specification format ready for architecture and design handoffs.

What is the best way to resolve ambiguities when writing software specifications?

The best way to resolve ambiguities when writing software specifications is using an iterative Q&A loop that refines scattered inspiration into clear requirements with testable acceptance criteria.

How to create a standardized spec.md file for a specific service?

You create a standardized spec.md file by naming your service and providing input materials, which automatically generates the formal requirements document at the output location docs/{serviceName}/spec.md.