software-design-creation

Create software design specifications with requirements, architecture, and acceptance criteria.

902|58|Updated May 31, 2012
One-click install
npx skills add https://github.com/stencila/stencila --skill software-design-creation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: software-design-creation
Source: https://github.com/stencila/stencila/tree/main/.stencila/skills/software-design-creation
Command: npx skills add https://github.com/stencila/stencila --skill software-design-creation

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Turning a vague feature idea into a concrete, implementation-ready design specification is hard: requirements are missing, scope is unclear, and acceptance criteria are vague. This Skill elicits missing requirements, structures the design, and writes a spec developers can use for planning and implementation.

Core Features & Use Cases

  • Requirements Elicitation: Asks targeted clarifying questions about users, scope, constraints, and success criteria, or records explicit assumptions when answers are unavailable.
  • Structured Spec Generation: Produces a design document covering goals, non-goals, functional and non-functional requirements, architecture, data models, interfaces, risks, and testable acceptance criteria.
  • Persistent Design Artifacts: Writes the finished spec to .stencila/designs/{name}.md so it can be updated and reused across planning sessions.
  • Use Case: Given a prompt like "design a feature for scheduling social media posts", the Skill produces a scoped spec with timezone handling constraints, platform API limits, and acceptance criteria for scheduling, validation, and failure handling.

Quick Start

Ask the assistant to create a software design specification for your feature idea, such as designing an internal tool for tracking lab equipment usage.

Frequently Asked Questions about software-design-creation

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

FAQPage Schema
How do I write a software design specification from a vague idea?

Provide your idea as a prompt and the Skill restates the problem, asks a few high-value clarifying questions about users, scope, and constraints, then drafts a structured spec. If answers are unavailable, it proceeds with explicitly labeled assumptions.

What sections should a technical design document include?

The generated spec covers summary, problem, goals and non-goals, users, scope, functional and non-functional requirements, architecture overview, components, data and interfaces, risks, assumptions, open questions, and testable acceptance criteria.

Can I use this for writing production code or code review?

No. The Skill produces design specifications and implementation-ready requirements, not source code or code reviews. It provides enough architecture and interface detail to support implementation, but the deliverable remains a design document.

Where are the generated design specs saved?

Completed designs are written to .stencila/designs/{name}.md using a kebab-case file name. Updates to an existing design use edit_file or apply_patch rather than rewriting the whole file.

What happens when requirements conflict or scope is unclear?

Conflicting requirements are called out explicitly with documented tradeoffs and a recommended resolution. Unclear scope is split into must-have scope and deferred scope instead of producing a fuzzy all-in-one spec.