spec-miner

Extract software specifications from Python and JavaScript codebases into structured markdown reports.

Updated Apr 25, 2026

Search Tags:#architecture #code analysis #documentation #legacy code #api generation #reverse engineering

Ready to run

npx skills add https://github.com/Serg28/demosite --skill spec-miner-serg28

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: spec-miner
Source: https://github.com/Serg28/demosite/tree/main/.agents/skills/spec-miner
Command: npx skills add https://github.com/Serg28/demosite --skill spec-miner-serg28

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill facilitates understanding and documenting legacy and undocumented software systems by extracting specifications and analyzing code dependencies.

Core Features & Use Cases

Code Dependency Mapping: Automatically identifies code relationships and architecture layers.
Documentation Generation: Produces API and architecture documentation from source code.
Use Case: On inheriting a large, undocumented codebase, use this Skill to analyze the structure, identify key modules, and generate comprehensive documentation to accelerate onboarding and maintenance.

Quick Start

Invoke the spec-miner to analyze an existing codebase and generate architecture documentation.

Frequently Asked Questions about spec-miner

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

FAQPage Schema

How do I reverse-engineer an undocumented legacy codebase to understand its architecture?▼

To reverse-engineer a legacy codebase, this Skill extracts software specifications by mapping code dependencies and identifying architecture layers. It generates structured markdown reports to document the system and accelerate onboarding.

Can I automatically generate API documentation from existing Python and JavaScript source code?▼

Yes, you can generate API documentation directly from Python and JavaScript source code. The Skill explores files using code analysis tools to extract specifications and produces structured markdown documentation automatically.

Does this code analysis tool support languages other than Python and JavaScript?▼

This code analysis tool primarily targets Python, JavaScript, and related files. It utilizes code exploration tools like Grep, Glob, and Read to extract specifications and map dependencies from these specific languages.

What is the best way to map code dependencies and architecture layers in a large system?▼

The best way to map code dependencies is by using automated extraction to identify relationships and architecture layers across the codebase. This produces structured markdown reports detailing software specifications for architecture analysis.

How does code analysis extract software specifications from source files?▼

Code analysis extracts software specifications by using exploration tools like Grep, Glob, and Read to scan source files. It identifies code relationships, maps architecture layers, and generates structured markdown reports.