# Draft Spec

> Draft a review-ready Markdown product or implementation specification from the current conversation and repository context without publishing it. Use when the user asks to draft a spec, PRD, requirements summary, or design document for review; do not use for issue-tracker publication.

- Skill: `sciman-top/draft-spec` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add sciman-top/draft-spec`
- Raw SKILL.md: https://api.skillmd.com/api/skills/sciman-top/draft-spec/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: sciman-top (https://skillmd.com/u/sciman-top)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/sciman-top/draft-spec

---


# Draft Spec

Turn the context already available into a concise, reviewable Markdown draft.

## Output

Return the draft in the response with these sections:

1. Problem statement
2. Goals and non-goals
3. User stories or user-visible outcomes
4. Requirements and implementation decisions
5. Acceptance criteria and test strategy
6. Risks, assumptions, and open questions
7. Publication handoff (what still needs approval or tracker configuration)

Use repository terminology and existing ADRs when they are available. Separate
facts, decisions, assumptions, and unanswered questions. Prefer observable
behavior and seams over speculative file-by-file plans.

## Side-effect boundary

This is a draft-only skill. Do not call an issue tracker, create labels or
links, invoke `to-spec`/`to-tickets`, or create or modify repository files.
If the user later asks to publish the draft, hand off to an explicit
`$to-spec` invocation after the user has reviewed it.