codebase-spec-extractor

Extract implementable engineering specifications from existing codebases.

50|3|Updated Jan 30, 2026
One-click install
npx skills add https://github.com/okwinds/miscellany --skill codebase-spec-extractor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: codebase-spec-extractor
Source: https://github.com/okwinds/miscellany/tree/main/agent/skills/codebase-spec-extractor
Command: npx skills add https://github.com/okwinds/miscellany --skill codebase-spec-extractor

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

The Codebase Spec Extractor converts existing codebases into complete, implementable engineering specifications that enable replication without access to the original source code, even when the target stack differs.

Core Features & Use Cases

  • Inventory and analyze a repository to identify architecture, data models, dependencies, and data flows.
  • Generate a skeleton, inventory, and verification workflow so teams can reproduce behavior from documentation alone.
  • Ideal for migration planning, documenting legacy systems, onboarding new engineers, and cross-stack knowledge transfer.

Quick Start

  1. Scan a project: bash scripts/discover_project.sh /path/to/project > discovery.md
  2. Build an element inventory: bash scripts/inventory_elements.sh /path/to/project > inventory.md
  3. Create a spec skeleton: bash scripts/generate_skeleton.sh spec

Frequently Asked Questions about codebase-spec-extractor

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

FAQPage Schema
How do I extract engineering specifications from an existing codebase for migration?

To extract engineering specifications from a codebase, run Bash scripts to scan project structure, inventory elements, and generate a spec skeleton. This produces documentation of architecture, data models, dependencies, and data flows, enabling system replication without original source code.

What is the best way to document legacy system architecture and data flows?

Documenting legacy system architecture is best achieved by generating an implementable engineering specification from the codebase. The skill inventories dependencies and data flows, creating a verification workflow so teams can reproduce behavior from documentation alone.

Can I generate a project specification skeleton using only Bash and Unix utilities?

Yes, you can generate a project specification skeleton using Bash and standard Unix utilities. The skill requires these foundational tools to locate repository structure, with optional ripgrep support for faster scanning of dependencies and data flows.

How do I transfer knowledge across different tech stacks without source code access?

Knowledge transfer across tech stacks without source code is done by extracting complete engineering specifications. The skill analyzes the original codebase to produce a skeleton and inventory, allowing teams to reproduce behavior in a completely different target stack.

How to inventory repository dependencies and data models for cross-stack replication?

Inventory repository dependencies and data models by running the element inventory script on the project path. This scans the codebase to identify architecture and data flows, outputting a markdown file that defines the implementable specification for cross-stack replication.

What are the limitations of generating engineering specs from code without source access?

Generating engineering specs from code requires Bash and Unix utilities to scan the original repository, meaning you need initial access to the codebase to build the inventory. The resulting specification enables later replication without source, but the extraction phase requires direct file access.