Can I customize the clarifying questions?

The skill dynamically generates 2-3 essential questions based on your initial feature description to ensure the most relevant details are captured before documentation begins.

Does it support visual rendering of workflows?

Yes, it provides both Mermaid.js code (for GitHub/GitLab rendering) and ASCII art diagrams for immediate readability within the terminal or text editors.

What is included in the generated specification?

The spec includes YAML metadata, context tables, in/out scope definitions, Mermaid and ASCII diagrams, example tables for edge cases, Gherkin scenarios, and a 'Done When' checklist.

How does the skill handle features that are too large?

If a feature exceeds what can be completed in a single iteration, the skill recommends splitting it into multiple specifications linked by dependency references.

Detailed Feature Spec Architect

Name: Detailed Feature Spec Architect
Author: jagreehal

byjagreehal

0•

Content Management

Generates exhaustive feature specifications including diagrams, flowcharts, and Gherkin scenarios to eliminate development ambiguity.

The spec-detailed skill is designed for developers who prioritize clarity and precision in their planning phase. It guides the user through a structured discovery process using multiple-choice clarifying questions before generating a comprehensive 'Spec Format v1' document. This document includes everything from YAML metadata and Mermaid diagrams to ASCII flowcharts and Gherkin-style test scenarios, ensuring that every feature is fully scoped, technically sound, and ready for implementation in a single development iteration.

Key Features

01Interactive requirements gathering with lettered multiple-choice questions

02Gherkin-style BDD scenarios including Scenario Outlines for validation

03Standardized YAML frontmatter for tracking priority, risk, and dependencies

04Automated file system mapping for affected directory structures

05Dual-mode visualization featuring both Mermaid.js and ASCII flowcharts

060 GitHub stars

Use Cases

01Standardizing documentation for team-wide feature implementation

02Breaking down monolithic features into smaller, manageable technical specs

03Scoping complex backend integrations that require clear sequence logic

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jagreehal/baldrick spec-detailed

For use in Claude.ai and ChatGPT

Download Skill