spec-analyzing

Extract insights from `.research/*.md` reports into a root ANALYSIS.md plan.

23|2|Updated Jun 9, 2025
One-click install
npx skills add https://github.com/kaptinlin/gozod --skill spec-analyzing
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-analyzing
Source: https://github.com/kaptinlin/gozod/tree/main/.agents/skills/spec-analyzing
Command: npx skills add https://github.com/kaptinlin/gozod --skill spec-analyzing

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Analyzes research reports and produces a root ANALYSIS.md that defines the scope, priorities, and structure for specification writing.

Core Features & Use Cases

  • Reads all .research/*.md reports and synthesizes a single ANALYSIS.md at the project root.
  • Defines Scope, Priorities, Structure, and SSOT mapping to guide subsequent SPEC work.
  • Provides a clear plan to translate findings into SPEC documents and philosophy updates.

Quick Start

Review the .research/ folder and run the spec-analyzing skill to generate the ANALYSIS.md at the project root.

Frequently Asked Questions about spec-analyzing

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

FAQPage Schema
How do I turn research markdown reports into a structured specification plan?

To turn research markdown reports into a structured specification plan, you need a tool that extracts insights from `.research/*.md` files and defines scope, priorities, and SSOT mapping for implementation.

What is SSOT mapping in specification writing and why is it needed?

SSOT mapping in specification writing identifies single sources of truth to ensure consistent documentation. It is needed to prevent conflicting data across multiple SPEC documents during implementation planning.

How do I generate a root ANALYSIS.md that synthesizes multiple research reports?

To generate a root ANALYSIS.md that synthesizes multiple research reports, place your findings in a `.research/` folder and run an analysis process to output a structured project plan at the root directory.

Can I define SPEC dependencies and priorities directly from markdown research notes?

Yes, you can define SPEC dependencies and priorities directly from markdown research notes by synthesizing the findings into a structured plan that outlines actions, dependencies, and philosophy updates.

What is the best way to structure documentation before writing technical specifications?

The best way to structure documentation before writing technical specifications is to synthesize existing research into an analysis document containing Context, Structure, Priorities, Dependencies, and SSOT Map sections.

Do I need a specific folder structure to analyze research for specification writing?

Yes, you need a specific folder structure to analyze research for specification writing. Research files must be placed in a `.research/` directory as markdown files for the analysis process to read and synthesize them.