reverse-spec

Read codebases and generate spec.md files, design skeletons, and gap analysis.

Updated Apr 12, 2026
One-click install
npx skills add https://github.com/asfbay-bit/opchain --skill reverse-spec-asfbay-bit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reverse-spec
Source: https://github.com/asfbay-bit/opchain/tree/main/skills/reverse-spec
Command: npx skills add https://github.com/asfbay-bit/opchain --skill reverse-spec-asfbay-bit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reverse-spec bridges the gap when projects lack formal specs by reading existing codebases and producing pipeline-ready documentation that feeds app-architect, stack-forge, and tri-dev inputs.

Core Features & Use Cases

  • Reads codebases and outputs structured spec documents (spec.md) and supporting design/gap artifacts.
  • Generates route-ready guidance for downstream skills by providing a clear, architecture-aligned baseline.
  • Useful for documenting legacy projects, backfilling missing specs, or aligning an existing codebase with the development pipeline.

Quick Start

Generate reverse-spec outputs for your codebase and begin integrating the produced specs into your workflow.

Frequently Asked Questions about reverse-spec

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

FAQPage Schema
How do I generate specifications from an existing codebase?

To generate specifications from an existing codebase, this Skill reads your source files and outputs structured spec.md documents alongside design baselines. It analyzes the architecture to produce pipeline-ready artifacts for downstream development workflows.

Can I use this to reverse engineer legacy code into documentation?

Yes, you can reverse engineer legacy code into documentation by reading the existing codebase and producing structured spec documents. It bridges the gap when projects lack formal specs by generating design skeletons and gap analysis for alignment.

Does this tool support generating specs across a monorepo?

Generating specs across a monorepo is fully supported. The tool reads monorepos or single apps to output spec.md files, design skeletons, and gap analysis, providing a route-ready baseline aligned with your architecture.

What is the best way to backfill missing specs for a development pipeline?

The best way to backfill missing specs is to read the codebase and generate pipeline-ready specifications. This Skill produces spec docs and gap analysis that feed directly into downstream development pipeline inputs.

How does checkpoint-based session continuity work for spec generation?

Checkpoint-based session continuity works by saving your progress during the spec generation process. This allows you to pause and resume reading large codebases and outputting design baselines without losing your analysis state.

What is a pipeline-ready specification?

A pipeline-ready specification is a structured spec.md document generated from an existing codebase that provides architecture-aligned design baselines. It serves as route-ready guidance to feed downstream skills and development pipeline inputs.