How does the YAGNI checkpoint work?

During the understanding phase, the skill explicitly asks you to validate which features are essential and which should be deferred to avoid scope creep and unnecessary complexity.

Does it support team feedback and iterations?

Yes, the Revision Mode allows the skill to ingest feedback from reviewers and update the specification while maintaining a 'Review Discussion' section to track historical decisions.

Where are the specifications saved by default?

Specs are saved to a configurable path, typically a /specs directory in your project, using a customizable naming convention such as {date}-{topic}-spec.md.

What is the primary purpose of Spec Writer?

It transforms abstract ideas into detailed implementation plans, ensuring all technical requirements and design decisions are clarified before coding begins.

Can I use my own specification templates?

Yes, the skill supports custom templates via the --template argument or a local project configuration file located at .claude/spec-workflow/templates/spec.md.

Implementation Spec Writer

Name: Implementation Spec Writer
Author: ky1ejs

byky1ejs

•

生产力与工作流

Transforms high-level ideas into detailed, actionable implementation specifications through collaborative dialogue and design analysis.

The Spec Writer skill bridges the gap between raw ideas and code implementation by guiding users through a structured planning process. It features multiple operating modes—Interactive, Autonomous, and Revision—allowing it to function as a collaborative design partner or an independent architect. By enforcing 'You Ain't Gonna Need It' (YAGNI) principles and evaluating design alternatives, the skill ensures that technical specifications are robust, parallelization-aware, and aligned with project-specific standards before implementation begins. It is particularly effective for complex feature planning where architectural consistency and clear data models are required.

主要功能

011 GitHub stars

02Standardized spec generation covering architecture, data models, APIs, and testing

03Configurable support for project-specific templates and engineering philosophy docs

04Ruthless YAGNI-focused scope management to eliminate unnecessary features early

05Autonomous and revision modes for seamless integration with orchestrator workflows

06Interactive requirements gathering with multi-phase validation checkpoints

使用场景

01Refining technical designs through a collaborative feedback loop with an AI architect

02Generating structured documentation for new modules to ensure team alignment and implementation accuracy

03Planning complex feature additions that require multi-service coordination and architectural review

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ky1ejs/claude-plugins spec-writer

For use in Claude.ai and ChatGPT

Download Skill