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.