generic-spec-capture

Synthesize structured project specifications from code, documentation, and conversations.

Updated Mar 12, 2026
One-click install
npx skills add https://github.com/Puzzle9900/puzzle9900-claude-plugin --skill generic-spec-capture
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: generic-spec-capture
Source: https://github.com/Puzzle9900/puzzle9900-claude-plugin/tree/main/skills/generic-spec-capture
Command: npx skills add https://github.com/Puzzle9900/puzzle9900-claude-plugin --skill generic-spec-capture

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill captures existing project information (code, docs, conversations) into structured specification documents, ensuring no details are lost and creating a single source of truth.

Core Features & Use Cases

  • Information Synthesis: Consolidates scattered project details into a coherent spec.
  • Structured Documentation: Generates specs in a standardized format within the projectspecs/ directory.
  • Use Case: You have a set of design notes, code snippets, and a Slack conversation about a new feature. Use this Skill to synthesize all that information into a formal spec.md file under projectspecs/001_new-feature/.

Quick Start

Use the generic-spec-capture skill to synthesize a project specification from the provided codebase files and inline description.

Frequently Asked Questions about generic-spec-capture

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

FAQPage Schema
How do I synthesize project specifications from scattered code and documentation?

Capture existing project information by consolidating code, documentation, and conversations into structured specification documents. It separates product definition, functional behavior, and technical approach into versioned `projectspecs/` directories to prevent detail loss.

How do I create a single source of truth from design notes and Slack conversations?

Create a single source of truth by synthesizing design notes and Slack conversations into a formal `spec.md` file. The skill identifies product definition, functional behavior, and open questions, saving them into standardized versioned directories under `projectspecs/`.

Can I generate structured documentation from inline descriptions and a codebase?

Yes, you can generate structured documentation from inline descriptions and codebase files. The skill synthesizes diverse source materials into a coherent spec, strictly adhering to the provided source without inventing missing details.

Does the specification synthesis process flag ambiguities in the source material?

Yes, the specification synthesis process explicitly flags ambiguities found in the source material. It requires strict adherence to existing information without invention, separating identified constraints and open questions to ensure no details are lost.

What is the best way to consolidate scattered project details into a coherent spec?

The best way to consolidate scattered project details is using a synthesis skill that extracts product definition, functional behavior, and technical approach. It organizes this information into versioned `projectspecs/` directories, creating a standardized specification document.