spec

Convert user intent into a formal spec document with goals and acceptance criteria.

Updated Apr 18, 2026
One-click install
npx skills add https://github.com/chughtapan/safer-by-default --skill spec-chughtapan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec
Source: https://github.com/chughtapan/safer-by-default/tree/main/skills/spec
Command: npx skills add https://github.com/chughtapan/safer-by-default --skill spec-chughtapan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ambiguity in user intent often leads to misaligned work. This skill converts vague goals into a formal spec that defines goals, non-goals, invariants, acceptance criteria, and open questions so downstream modalities can execute without needing the original conversation.

Core Features & Use Cases

  • Generates a formal spec from user intent including sections: Intent, Goals, Non-goals, Invariants, Acceptance criteria, Assumptions, Open questions.
  • Publishes the spec to GitHub as an issue or comment for traceability and alignment.
  • Asks clarifying questions when ambiguity is high, preventing scope drift and misinterpretation.

Quick Start

Provide a natural-language user intent and let the spec modality produce a complete artifact.

Frequently Asked Questions about spec

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

FAQPage Schema
How do I write a formal spec document from vague project requirements?

Converting vague intent into a formal spec involves structuring goals, non-goals, invariants, and acceptance criteria. This skill automates that conversion to prevent scope drift without requiring prior conversations.

What is the best way to document open questions and assumptions for software requirements?

Documenting open questions and assumptions for software requirements is best handled by generating a formal spec artifact. This process explicitly captures ambiguity and scope boundaries to guide downstream execution accurately.

How do I create and publish a requirements spec to GitHub as an issue?

To create and publish a requirements spec to GitHub as an issue, you provide a natural-language user intent. The generated spec artifact is then published directly to GitHub for traceability and team alignment.

Does this spec generation tool ask clarifying questions for ambiguous user intent?

Yes, when ambiguity is high, the spec generation process asks clarifying questions about the user intent. This proactive approach prevents misinterpretation and scope drift before the formal spec is finalized.

Can I generate acceptance criteria and non-goals without prior team discussion?

You can generate acceptance criteria and non-goals without prior discussion by inputting raw user intent. The skill independently produces a complete spec artifact designed to guide downstream work autonomously.