spec-save-design

Convert a /spec:brainstorm session into a structured design document saved under docs/designs.

Safety Notice

This listing is imported from skills.sh public index metadata. Review upstream SKILL.md and repository scripts before running.

Copy this and send it to your AI assistant to learn

Install skill "spec-save-design" with this command: npx skills add nu1nux/open-skills/nu1nux-open-skills-spec-save-design

Save Brainstorming Session as Design Document

The user has previously run /spec:brainstorm. Your task is to:

  1. Locate the /spec:brainstorm invocation in the current session conversation history.
  2. Collect all user and assistant messages AFTER that command.
  3. Analyze the conversation to infer the main feature/topic being designed.
  4. Transform the brainstorming content into a cohesive design document with clear sections.
  5. Generate a short, descriptive slug (3-5 words, lowercase, hyphen-separated) from the main topic.
  6. Get the current date in YYYY-MM-DD format.
  7. Construct the filename as docs/designs/YYYY-MM-DD-<slug>.md.
  8. If a file with that name already exists, adjust by either appending a suffix like -1, -2 or a short timestamp.
  9. If the docs/designs directory does not exist, create it.
  10. Use the write tool to create the file with the generated filename and design content.
  11. At the end, print the final file path you wrote to.

If no /spec:brainstorm command is found in the history, use all messages from the beginning of the conversation instead.

The design document MUST follow this structure:

[Feature Name]

Date: YYYY-MM-DD

Context

Summarize the initial idea and motivation based on the early brainstorming messages.

Discussion

Summarize key questions, answers, trade-offs, and explored alternatives from the conversation.

Approach

Summarize the final agreed direction and how it solves the problem.

Architecture

Describe technical details, components, flows, and important implementation notes if discussed.

Remember:

  • Base everything only on content after /spec:brainstorm.
  • Do not include raw chat logs; only the distilled design.${languageInstruction}

Source Transparency

This detail page is rendered from real SKILL.md content. Trust labels are metadata-based hints, not a safety guarantee.

Related Skills

Related by shared tags or category signals.

General

analyze-project

No summary provided by upstream source.

Repository SourceNeeds Review
General

spec-write-plan

No summary provided by upstream source.

Repository SourceNeeds Review
General

spec-execute-plan

No summary provided by upstream source.

Repository SourceNeeds Review
General

spec-brainstorm

No summary provided by upstream source.

Repository SourceNeeds Review