Why does it create a separate SPEC/ folder?

This follows the principle of separating 'things you read' (narrative decisions in SPEC.md) from 'things you look up' (dense reference material like API schemas), improving readability.

How does the interview process work?

It guides you through five specific phases: Vision & Problem, Requirements, Architecture, Tech Stack Details, and Design & Security using multiple-choice questions for efficiency.

What files does this skill generate?

The skill primarily creates a SPEC.md (narrative requirements), an optional SPEC/ folder for technical lookups (API schemas, data models), and a CLAUDE.md pointer file for AI agents.

Can it suggest a technology stack for my project?

Yes, it provides opinionated recommendations (e.g., Bun vs. pnpm) based on modern best practices while allowing you to override choices based on team preference.

Can I use this for existing projects?

Absolutely. You can use the /feature command to plan new additions or the /sync command to align your specifications with existing codebase changes.

Project Spec Writer

Name: Project Spec Writer
Author: Linaqruf

byLinaqruf

0•

Productivity & Workflow

Generates comprehensive, implementation-ready project specifications and architectural plans through an intelligent interview process.

Project Spec Writer transforms high-level ideas into structured technical documentation by guiding users through a multi-phase architectural interview. It produces a self-sufficient SPEC.md file, optional deep-dive supplements for APIs and schemas, and an agent-optimized CLAUDE.md to ensure Claude Code and other AI tools have the precise context needed for implementation. By integrating tech stack recommendations, ASCII system maps, and Context7 documentation, it bridges the gap between conceptual planning and active development.

Key Features

01Opinionated tech stack recommendations with trade-off analysis

02Context7 integration to fetch real-time documentation for chosen libraries

03Generates self-sufficient SPEC.md and agent-optimized CLAUDE.md files

04Interactive multi-phase interview flow for vision, requirements, and architecture

05Automated ASCII system maps, data models, and user flow diagrams

060 GitHub stars

Use Cases

01Planning complex new features within an existing codebase to maintain consistency

02Creating standardized design systems and API references for team collaboration

03Scaffolding a new MVP with a defined tech stack and architectural patterns

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add linaqruf/cc-plugins spec-writing

For use in Claude.ai and ChatGPT

Download Skill