doc-spec

Generate functional specifications by analyzing codebases or structuring user concepts with Mermaid diagrams.

Updated Jan 24, 2026
One-click install
npx skills add https://github.com/umatoma/claude-example --skill doc-spec-umatoma
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doc-spec
Source: https://github.com/umatoma/claude-example/tree/main/.claude/skills/doc-spec
Command: npx skills add https://github.com/umatoma/claude-example --skill doc-spec-umatoma

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill streamlines the creation and generation of functional specifications, whether by reverse-engineering existing code or by documenting new user concepts.

Core Features & Use Cases

  • Code-to-Spec Generation: Analyzes code to produce detailed specifications, including structure, data flow, and dependencies.
  • Concept-to-Spec Documentation: Helps users articulate and structure their ideas into formal specifications.
  • Use Case: You have a new feature implemented but no documentation. Use this Skill to analyze the codebase and generate a functional specification document outlining its behavior and data flow.

Quick Start

Use the doc-spec skill to generate a specification for the 'user-authentication' feature based on the existing code.

Frequently Asked Questions about doc-spec

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

FAQPage Schema
How do I generate functional specifications from existing code?

To generate functional specifications from existing code, the Skill analyzes your codebase to extract structural information, data flow diagrams using Mermaid, and dependencies. It reverse-engineers single features, feature groups, or entire projects into comprehensive documentation.

Can I create documentation for a new feature concept without any code?

Yes, you can create documentation for a new feature concept without code. The Skill structures user-provided concepts and ideas into formal functional specifications, articulating behavior and data flow before any implementation begins.

How do I document code structure and data flow for reverse engineering?

To document code structure and data flow for reverse engineering, the Skill extracts structural information and generates data flow diagrams using Mermaid. It identifies dependencies to produce comprehensive documentation outlining feature behavior.

What is the best way to write functional specifications for an undocumented codebase?

The best way to write functional specifications for an undocumented codebase is using code-to-spec generation. The Skill analyzes the existing code to produce detailed specifications outlining behavior, structure, and dependencies automatically.

Does this specification generator include data flow diagrams?

Yes, the specification generator includes data flow diagrams. It creates these diagrams using Mermaid syntax during the code analysis or concept structuring process, visualizing data flow alongside identified dependencies.

Can I generate a specification for an entire project or just single features?

You can generate specifications for both entire projects and single features. The Skill supports analyzing and documenting individual features, feature groups, or full project codebases to create comprehensive functional specifications.