init-spec

Generate initial project documentation and design artifacts from an existing codebase.

6|2|Updated Apr 5, 2026
One-click install
npx skills add https://github.com/i-standard1/yamasaki --skill init-spec
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: init-spec
Source: https://github.com/i-standard1/yamasaki/tree/main/.claude/skills/init-spec
Command: npx skills add https://github.com/i-standard1/yamasaki --skill init-spec

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill automates the generation of initial project specifications and documentation from an existing codebase, reducing manual setup time and ensuring consistency across CLAUDE.md, requirements overview, architecture, DB design, and API specifications.

Core Features & Use Cases

  • Auto-generate CLAUDE.md with project overview and technology stack.
  • Create or migrate essential docs: requirements overview, architecture, DB design, API-specs, and OpenAPI YAML.
  • If documents already exist, operate in migration mode to fill only missing parts and preserve existing content.

Quick Start

Run init-spec on a target repository to auto-generate CLAUDE.md, requirements overview, architecture, DB design, and OpenAPI documentation.

Frequently Asked Questions about init-spec

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

FAQPage Schema
How do I auto-generate OpenAPI specs and architecture docs from an existing codebase?

You can auto-generate OpenAPI specs, architecture, and DB design docs by analyzing the repository structure and key components to produce consistent documentation with traceable sources.

What is the best way to create a CLAUDE.md file with a project overview and technology stack?

The best way to create a CLAUDE.md file is to automate its generation from the existing codebase, extracting the project overview and technology stack to ensure consistency.

Can I migrate missing parts of my API specifications without overwriting existing documentation?

Yes, if documents already exist, it operates in migration mode to fill only missing parts of your API specifications and architecture docs while preserving existing content.

Does this documentation generation approach work for multi-repo setups?

Yes, this documentation generation approach is applicable to multi-repo setups where CLAUDE.md, requirements overview, architecture, DB design, and OpenAPI specs need to be created or migrated.

What components are analyzed to generate database design and requirements overview docs?

To generate database design and requirements overview docs, it analyzes the repository structure and identifies key components like architecture, DB design, and API specs to produce traceable documentation.