generate-spec

Generate phased specification documents from code and documentation analysis.

862|67|Updated Mar 2, 2026
One-click install
npx skills add https://github.com/saffron-health/libretto --skill generate-spec-saffron-health
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: generate-spec
Source: https://github.com/saffron-health/libretto/tree/main/.agents/skills/generate-spec
Command: npx skills add https://github.com/saffron-health/libretto --skill generate-spec-saffron-health

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill streamlines the process of planning and documenting new features or complex bug fixes by generating detailed, phased specification documents.

Core Features & Use Cases

  • Structured Spec Generation: Creates comprehensive specs including problem overview, solution, goals, non-goals, and implementation phases.
  • Codebase Understanding: Leverages code search and documentation research to inform spec creation.
  • Critical Questioning: Identifies and asks clarifying questions to resolve ambiguities before implementation.
  • Use Case: When proposing a significant new feature for your application, use this Skill to generate a detailed spec that outlines the implementation plan, potential challenges, and success criteria.

Quick Start

Use the generate-spec skill to create a spec for adding user authentication to the platform.

Frequently Asked Questions about generate-spec

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

FAQPage Schema
How do I generate a detailed implementation spec for new feature development?

To generate a detailed implementation spec, this Skill analyzes your existing codebase and external documentation to define problems, propose solutions, and outline phased implementation steps for new features. It structures the document with goals, non-goals, and critical clarifying questions.

What is included in a phased specification document for software development?

A phased specification document includes a problem overview, proposed solution, specific goals, non-goals, and step-by-step implementation phases. It leverages codebase analysis and critical questioning to resolve ambiguities before coding begins.

How do I document complex bug fixing plans before writing code?

You document complex bug fixing plans by generating a structured specification that outlines the problem, solution, and implementation steps. The Skill asks critical questions to clarify requirements and establish a robust plan before any coding begins.

Can I use this spec generation process without providing external documentation?

Yes, you can generate specifications by relying primarily on existing codebase analysis to inform the plan. However, providing external documentation helps the Skill better define problems, establish goals, and propose more accurate solutions.

What is the best way to define goals and non-goals for an implementation plan?

The best way to define goals and non-goals for an implementation plan is using a structured specification generator. This Skill analyzes your codebase and documentation to explicitly establish boundaries and objectives before development starts.

When do I need a specification document for software development tasks?

You need a specification document when proposing a significant new feature or tackling a complex bug fix. It ensures a robust plan by resolving ambiguities through critical questioning before the actual implementation phase begins.