How does this skill research my existing code?

The skill performs parallel searches of your local backend, frontend, and documentation directories to identify existing patterns, APIs, and prior art before drafting the spec.

What is the Writing-Specs Claude Code skill?

It is a specialized tool that helps developers and product managers write detailed, high-quality feature specifications by guiding the AI through research and structured documentation steps.

Does this skill help with frontend design?

Yes, it includes specific design principles for UI features, focusing on visual hierarchy, primary user actions, and reducing cognitive load for the end-user.

Why does it minimize implementation details?

By focusing on the 'what' (contracts and schemas) rather than the 'how' (infrastructure or internal formats), the spec remains flexible and focuses on the user's goals.

Can I link to specific code lines in the specs?

Absolutely. The skill is designed to reference code using GitHub-formatted URLs (including line numbers) rather than local file paths for better team collaboration.

Product Specification Expert

Name: Product Specification Expert
Author: nijikokun

bynijikokun

0•

学習とドキュメンテーション

Generates comprehensive feature specification documents by analyzing user requirements and researching existing codebases.

The Product Specification Expert skill streamlines the software design process by transforming raw user requirements into structured, technical specifications. It guides Claude through a rigorous workflow that includes gathering requirements, clarifying data models to avoid domain ambiguity, and performing parallel research across local codebases and external APIs. By emphasizing user goals over implementation details and applying specific frontend design principles, this skill ensures that every feature spec is clear, technically aligned with existing patterns, and optimized for learnability and shipping the smallest viable version.

主な機能

01Automated codebase research to ensure architectural consistency

02Frontend-specific design rules for hierarchy, actions, and cognitive load

030 GitHub stars

04Domain-specific data model clarification and JSON schema generation

05Guided requirement gathering and stakeholder interview workflows

06Standardized documentation using professional specification templates

ユースケース

01Drafting technical specifications for new backend features or API endpoints

02Standardizing project documentation for better team alignment and onboarding

03Creating UI/UX documentation for complex frontend interface updates

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add nijikokun/write-spec-skill writing-specs

For use in Claude.ai and ChatGPT

Download Skill