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.