draft-spec

Drafts review-ready Markdown specifications from conversation and repository context without publishing.

Updated Mar 26, 2026
One-click install
npx skills add https://github.com/sciman-top/skills-manager --skill draft-spec-sciman-top
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: draft-spec
Source: https://github.com/sciman-top/skills-manager/tree/main/overrides/custom/draft-spec
Command: npx skills add https://github.com/sciman-top/skills-manager --skill draft-spec-sciman-top

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a long discussion or scattered repository context into a structured, reviewable specification is time-consuming and error-prone. This Skill converts the current conversation and repo evidence into a concise Markdown draft spec, clearly separating facts, decisions, assumptions, and open questions. ## Core Features & Use Cases - Structured spec drafting: Produces sections for problem statement, goals, user stories, requirements, acceptance criteria, and risks, following a supplied template when available. - Evidence grounding: Labels facts versus assumptions, links claims to inspected repository paths or symbols, and asks for missing inputs instead of guessing. - Draft-only safety boundary: Never publishes to issue trackers, creates labels, or modifies repository files; publication is treated as a separate authorized task. - Use Case: After a design discussion about a new feature, ask for a spec draft and receive a review-ready PRD with observable acceptance criteria and explicit open questions. ## Quick Start Ask the assistant to use draft-spec to turn the current discussion into a review-ready Markdown specification without publishing it.

Frequently Asked Questions about draft-spec

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

FAQPage Schema
How do I draft a product spec from a conversation?▼

Ask the assistant to use draft-spec on the current discussion. It produces a Markdown draft with problem statement, goals, requirements, acceptance criteria, and open questions, grounded in the conversation and repository evidence.

How to write acceptance criteria for a requirements document?▼

The draft-spec skill generates observable and testable acceptance criteria for each material requirement, including failure or recovery behavior where it affects the user-visible result, rather than speculative implementation details.

Does draft-spec publish the spec to an issue tracker?▼

No. It is a draft-only skill that never calls issue trackers, creates labels, or modifies repository files. Publication is treated as a separate, explicitly authorized task with its own workflow.

What happens when required information is missing for a spec?▼

The skill asks for the missing target or payload instead of guessing. Assumptions are labeled explicitly, and choices stay open rather than inventing APIs, files, or estimates.

When should I not use a spec drafting skill?▼

Avoid it when you need direct issue-tracker publication or ticket creation, since draft-spec deliberately excludes publishing. Use it only for producing review-ready Markdown drafts from existing context.