silver-spec

Generate SPEC.md and REQUIREMENTS.md via structured Socratic dialogue.

6|3|Updated Mar 31, 2026
One-click install
npx skills add https://github.com/alo-exp/silver-bullet --skill silver-spec
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: silver-spec
Source: https://github.com/alo-exp/silver-bullet/tree/main/forge/skills/silver-spec
Command: npx skills add https://github.com/alo-exp/silver-bullet --skill silver-spec

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill guides stakeholders through a structured Socratic dialogue to produce canonical planning artifacts (SPEC.md and REQUIREMENTS.md) from scratch or to augment existing drafts, ensuring aligned requirements and traceable decisions.

Core Features & Use Cases

  • Guided Socratic elicitation that surfaces problems, user goals, boundaries, and acceptance criteria.
  • Generates and manages planning artifacts (.planning/SPEC.md and .planning/REQUIREMENTS.md) with versioned spec data.
  • Supports augmentation of existing specs, integrates optional design review, and produces testable requirements.

Quick Start

Describe a feature to elicit, and Silver Spec will orchestrate the dialogue to produce canonical spec artifacts.

Frequently Asked Questions about silver-spec

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

FAQPage Schema
How do I elicit project requirements through Socratic dialogue for planning artifacts?

Socratic spec elicitation guides product managers through structured dialogue to frame problems, define user goals, and establish acceptance criteria, producing canonical planning artifacts like SPEC.md and REQUIREMENTS.md.

What is the best way to generate a SPEC.md file with AI-assisted requirements gathering?

AI-assisted requirements gathering generates a SPEC.md file by orchestrating a Socratic dialogue that captures problem framing, user goals, scope, and edge cases, ensuring comprehensive and testable planning artifacts.

Can I augment existing specifications and requirements drafts instead of starting from scratch?

Yes, you can augment existing specifications and requirements drafts; the workflow supports integrating current specs to refine boundaries, fill gaps, and produce versioned planning artifacts with traceable decisions.

Does spec elicitation work for defining acceptance criteria and project edge cases?

Spec elicitation works for defining acceptance criteria and project edge cases by guiding stakeholders through targeted Socratic dialogue that surfaces boundaries and testable requirements for comprehensive planning.

How do I manage versioning and frontmatter for REQUIREMENTS.md files?

You manage versioning and frontmatter for REQUIREMENTS.md files through the artifact orchestration process, which automatically handles spec data versioning and document structuring during the elicitation workflow.

When should I use Socratic dialogue for requirements gathering over traditional methods?

You should use Socratic dialogue for requirements gathering when you need to uncover hidden edge cases, align stakeholder decisions, and ensure traceable problem framing from scratch or when augmenting existing drafts.