to-spec

Synthesizes conversation context into a published specification with conflict sweep and proposals.

Updated Aug 13, 2026
One-click install
npx skills add https://github.com/Evolutionary-Leadership/harness --skill to-spec-evolutionary-leadership
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: to-spec
Source: https://github.com/Evolutionary-Leadership/harness/tree/main/.claude/skills/to-spec
Command: npx skills add https://github.com/Evolutionary-Leadership/harness --skill to-spec-evolutionary-leadership

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After a design conversation, teams still need a written specification that lives in one authoritative place. This Skill turns the current conversation into a structured spec and publishes it, either as a tracker issue or as proposals in Spec Universe, without re-interviewing the user. ## Core Features & Use Cases - Spec synthesis from context: Reads the existing conversation and codebase state to produce a specification with problem statement, user stories, implementation and testing decisions, and scope boundaries. - Dual publish modes: Detects the spec_product key in .harness-version and either publishes a tracker issue (dormant mode) or writes node proposals to Spec Universe via the shared client script (connected mode). - Conflict sweep: In connected mode, lists every existing spec node the change touches or contradicts, ordered by strictness, and routes contradictions through a documented conflict protocol before drafting. - Use Case: After a /grilling design discussion about a new feature, run this Skill to produce the spec, sweep for conflicts against existing requirements, and publish proposals keyed to the change so later phases like /to-tickets and /release can consume them. ## Quick Start Ask the assistant to turn the current design conversation into a specification and publish it using the to-spec skill.

Frequently Asked Questions about to-spec

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

FAQPage Schema
How do I turn a design conversation into a specification?

Run the to-spec skill after the design discussion. It synthesizes the existing conversation context into a spec with problem statement, user stories, implementation and testing decisions, then publishes it without asking new interview questions.

What is a specification conflict sweep in Spec Universe?

A conflict sweep lists every existing requirement node the change touches or contradicts, ordered by strictness. Touched nodes get amended by proposals, while contradicted nodes trigger a conflict protocol requiring a user decision before drafting continues.

Does to-spec work without Spec Universe connected?

Yes. When the spec_product key in .harness-version is empty, the skill runs in dormant mode and publishes the spec as a single tracker issue using the built-in template, skipping all Spec Universe read and write steps.

Why must nodes be re-read before writing a proposal?

Proposals replace whole fields, so building on a stale retrieved snapshot could overwrite changes made by someone else. The skill re-reads the target node live with the spec-universe client immediately before sending each proposal.

When should I not use to-spec?

Do not use it before a design conversation has happened, since it synthesizes rather than interviews. Run the grilling or feature phase first so there is enough context to produce a meaningful specification.