Can I use this skill on an existing project spec?

Yes, you can run the skill against any current specification file to detect gaps before moving into the planning or execution phases of development.

What is the primary benefit of the Refining Specifications skill?

It identifies missing decision points and ambiguities in your requirements early, preventing downstream rework and ensuring that implementation plans are based on clear, actionable data.

What kind of gaps does the taxonomy look for?

The skill scans for missing functional scope, domain model inconsistencies, UX edge cases, non-functional quality attributes (like performance/security), and integration dependencies.

How many questions will the skill ask me?

To maintain high efficiency, the skill is constrained to generate a maximum of 5 prioritized questions that have the most significant impact on architecture or UX.

Refining Specifications

Name: Refining Specifications
Author: samjhecht

bysamjhecht

•

生产力与工作流

Audits software specifications to detect ambiguities and generate prioritized clarification questions that reduce implementation risk.

The Refining Specifications skill acts as an automated expert reviewer for technical documentation and feature requirements. By applying a rigorous taxonomy across functional scope, domain models, UX flows, and non-functional attributes, it identifies 'missing decision points' that often lead to scope creep or technical debt. The skill provides a structured gap analysis and generates a concise list of high-impact questions designed to align stakeholders and developers before code is written, ensuring a smooth transition from concept to implementation plan.

主要功能

01Automated ambiguity detection for adjectives and unquantified metrics

02Prioritized question generation limited to the top 5 highest-impact uncertainties

031 GitHub stars

04Easy-to-answer output formats including multiple-choice and short-phrase questions

05Structured taxonomy scan covering domain models, UX, and non-functional requirements

06Standardized audit trail for specification maturation and readiness

使用场景

01Pre-planning review to ensure a feature specification is ready for technical decomposition

02Post-feedback refinement to verify that stakeholder updates haven't introduced new inconsistencies

03Gap analysis of legacy documentation to identify missing edge cases or security constraints

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add samjhecht/wrangler refining-specifications

For use in Claude.ai and ChatGPT

Download Skill