spec

Transform product briefs into technical specifications with data models and API routes.

51|2|Updated Apr 20, 2026
One-click install
npx skills add https://github.com/g2i-ai/agents --skill spec-g2i-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec
Source: https://github.com/g2i-ai/agents/tree/main/skills/spec
Command: npx skills add https://github.com/g2i-ai/agents --skill spec-g2i-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Product briefs frequently lack the detail needed for engineering teams. This skill converts briefs into precise technical specifications to guide implementation and reduce ambiguity.

Core Features & Use Cases

  • Automated brief-to-spec transformation that captures goals, constraints, success metrics, and acceptance criteria.
  • Structured output compatible with docs/specs/{project-name-slug}.md and design review workflows.
  • Use Case: Given a new feature brief, generate a full spec including data models, APIs, and testing considerations.

Quick Start

Use the spec skill to convert a product brief into a technical specification and save it to docs/specs/{project-name-slug}.md.

Frequently Asked Questions about spec

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

FAQPage Schema
How do I turn a product brief into a technical specification for engineering?

To turn a product brief into a technical specification, you need to capture goals, constraints, success metrics, and acceptance criteria. This process reduces ambiguity by producing a structured, testable plan for implementation.

What should be included in a technical specification for API design and data models?

A technical specification for API design and data models should include architecture details, data models, API routes, testing considerations, and feature flags. This structured output ensures engineering teams have a complete, testable plan.

How do I generate a technical spec from a brief and save it to my docs folder?

You can generate a technical spec from a brief and save it to docs/specs/{project-name-slug}.md. This automated transformation applies focused discovery across architecture and APIs, outputting a file compatible with design review workflows.

Does this brief-to-spec transformation work for codebase discovery and feature flags?

Yes, the brief-to-spec transformation applies focused discovery across architecture, data models, API routes, tests, and feature flags. It ensures these technical details are captured in the resulting specification to guide implementation.

What is the best way to structure a technical specification for a new feature?

The best way to structure a technical specification is to follow a standardized template like templates/tech-spec-template.md. This ensures the document captures all necessary components, including goals, constraints, and acceptance criteria.

Can I use this specification generation for project planning and design reviews?

Yes, you can use the generated specification for project planning and design review workflows. The output provides a complete, testable plan that aligns engineering teams on architecture, data models, and API routes before implementation.