Does it require an existing documentation framework?

While it works best with an initialized framework, it can offer to initialize one if it doesn't find the required folder structure.

Can I edit the generated specification?

Yes, the skill includes an iterative process where the AI presents a draft and you can provide corrections or additions before it is saved.

What does retrofit-spec do?

It analyzes existing code files to create a structured feature specification document, helping you understand and document functionality that was built without formal specs.

Where are the specifications saved?

Specs are saved within your project's docs/feature-specs/ directory, organized by domain or capability.

How does it handle complex modules?

For directories, the skill reads key files within the module and uses a specialized codebase-analyzer subagent to infer the broader feature context.

Retrofit Feature Spec

Name: Retrofit Feature Spec
Author: asermax

byasermax

•

Learning & Documentation

Generates comprehensive feature specifications and documentation from existing code implementations.

The retrofit-spec skill enables developers to automatically document legacy or undocumented codebases by reverse-engineering functional specifications from implementation details. By analyzing source files and modules, it drafts detailed feature specs—including user stories and acceptance criteria—while ensuring documentation is organized within a standardized project structure. This skill bridges the gap between implementation and architectural clarity, making it indispensable for maintaining large-scale projects or onboarding new team members to undocumented features.

Key Features

01Automated code analysis and specification drafting

021 GitHub stars

03Automatic organization into capability domains and sub-capabilities

04Interactive iteration for refining user stories and acceptance criteria

05Integrated 'Retrofit Note' tracking to distinguish generated vs. original specs

06Standardized documentation structure in docs/feature-specs/

Use Cases

01Standardizing architectural documentation across different development teams

02Documenting legacy features that lack original requirements or design documents

03Maintaining up-to-date project documentation for rapidly evolving codebases

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add asermax/claude-plugins retrofit-spec

For use in Claude.ai and ChatGPT

Download Skill