convert-to-speckit

Convert reverse-engineering documentation into GitHub Spec Kit specifications.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/jschulte/stackshift --skill convert-to-speckit
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: convert-to-speckit
Source: https://github.com/jschulte/stackshift/tree/main/skills/convert-to-speckit
Command: npx skills add https://github.com/jschulte/stackshift --skill convert-to-speckit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reverse-engineering documentation often lacks a consistent Spec Kit format. This Skill converts docs/reverse-engineering into properly formatted Spec Kit specifications, ready for the /speckit-* workflow.

Core Features & Use Cases

  • Scan reverse-engineering docs: Read docs/reverse-engineering/ to identify features.
  • Extract & map: Pull out business logic, data models, APIs, and integrations.
  • Create specs: Generate specs at specs/F{NNN}-{feature}/spec.md with required sections.
  • Validate quality: Ensure specs meet the required structure and completeness.

Quick Start

Ensure your repository has docs/reverse-engineering/ and .specify/templates/. Then run the conversion to generate specs in specs/ using the standard Spec Kit layout.

Frequently Asked Questions about convert-to-speckit

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

FAQPage Schema
How do I convert reverse-engineering documentation to Spec Kit format?▼

Convert reverse-engineering docs by running this Skill against docs/reverse-engineering/ to extract features, business logic, and data models, then map them to Spec Kit schema and generate specs at specs/F{NNN}-{feature}/spec.md with complete required sections.

What documentation structure does the conversion tool expect?▼

The Skill reads docs/reverse-engineering/ for feature documentation and uses templates from .specify/templates/ to standardize extraction and mapping, ensuring your source docs and template layouts align before conversion begins.

Can I automate specs generation from existing reverse-engineering docs?▼

Yes. This Skill automates the entire pipeline—scan, analyze, extract, convert, create, and validate—to turn unformatted reverse-engineering documentation into production-ready Spec Kit specs without manual reformatting.

Does the conversion validate spec completeness and structure?▼

Yes. The Skill validates generated specs against Spec Kit requirements, checking structure, section completeness, and format compliance before publishing specs to ensure they're ready for downstream speckit-* workflows.

What happens if my reverse-engineering docs are incomplete or inconsistent?▼

The Skill extracts available business logic, APIs, and data models from your existing docs; validation steps flag missing or incomplete sections, letting you identify gaps before publishing specs.