What happens if my repository has missing or unclear information?

The skill follows a 'No Hallucinations' rule. It will make educated inferences based on file structure but will clearly label these as 'Assumptions' or 'Unknown' in the final document.

What types of diagrams does this skill generate?

It generates 8 specific Mermaid diagrams: System Context, Container/Deployment, Module Relations, Sequence, ER, Class, Flowchart, and State diagrams.

Where is the specification document saved?

By default, the skill creates or updates a document at docs/specification.md, but it can follow a custom path if requested.

How does the skill identify my technology stack?

The skill performs a reconnaissance workflow, scanning for manifest files like package.json, go.mod, and requirements.txt, as well as Docker and infrastructure configurations.

Does it require manual input to work?

It is designed to be highly autonomous, asking a maximum of five clarifying questions only if the repository lacks sufficient evidence to generate an accurate spec.

Project Specification Writer

Name: Project Specification Writer
Author: sinjie2008

bysinjie2008

0•

学習とドキュメンテーション

Automatically generates comprehensive software specification documents and architectural diagrams based on your repository's codebase.

The Project Specification Writer is a specialized Claude Code skill designed to bridge the gap between source code and formal documentation. It performs an automated deep dive into your repository to map out architectures, data models, and deployment strategies, then outputs a structured 12-section Markdown document. By combining logical inference with Mermaid-based visualizations, it provides a high-fidelity blueprint of your project—including sequence diagrams, ER models, and pseudocode—making it indispensable for onboarding, architectural reviews, and maintaining technical debt visibility.

主な機能

01Automatically renders 8 types of Mermaid diagrams for visual system mapping and flow analysis.

02Minimizes developer friction by inferring system details from code with a 'Minimal Questions' policy.

03Conducts repository reconnaissance to identify tech stacks, runtimes, and deployment configurations.

04Standardizes documentation output to a clean, version-control-friendly Markdown file.

05Generates 12 essential specification sections covering architecture, data models, and key processes.

060 GitHub stars

ユースケース

01Generating instant architectural overviews to onboard new developers to a complex codebase.

02Preparing formal technical documentation for security audits, stakeholders, or handovers.

03Visualizing legacy database schemas and module relationships through automated Mermaid diagramming.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add sinjie2008/foundational-electronics-core-systems project-specification-writer

For use in Claude.ai and ChatGPT

Download Skill

主な機能

01Automatically renders 8 types of Mermaid diagrams for visual system mapping and flow analysis.

02Minimizes developer friction by inferring system details from code with a 'Minimal Questions' policy.

03Conducts repository reconnaissance to identify tech stacks, runtimes, and deployment configurations.

04Standardizes documentation output to a clean, version-control-friendly Markdown file.

05Generates 12 essential specification sections covering architecture, data models, and key processes.

060 GitHub stars

ユースケース

01Generating instant architectural overviews to onboard new developers to a complex codebase.

02Preparing formal technical documentation for security audits, stakeholders, or handovers.

03Visualizing legacy database schemas and module relationships through automated Mermaid diagramming.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add sinjie2008/foundational-electronics-core-systems project-specification-writer

For use in Claude.ai and ChatGPT

Download Skill