skills.rest
mlbright
mlbrightCOMMUNITY
Explore all skills by this author →
GitHub

refine-specification

Refine draft feature specifications into implementation-ready documentation through targeted clarifying questions.

Updated Feb 8, 2026
Search Tags:#documentation#specification#requirements#product management#analysis#feature refinement
One-click install
npx skills add https://github.com/mlbright/notes --skill refine-specification
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: refine-specification
Source: https://github.com/mlbright/notes/tree/main/.github/skills/refine-specification
Command: npx skills add https://github.com/mlbright/notes --skill refine-specification

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill transforms draft feature specifications into detailed, implementation-ready documentation by asking targeted clarifying questions.

Core Features & Use Cases

  • Interactive Q&A: Guides users through refining scope, user workflows, data models, integrations, and non-functional requirements.
  • Structured Output: Generates a comprehensive refined specification document.
  • Use Case: A product manager has a high-level idea for a new feature. They use this Skill to systematically flesh out all the necessary details, ensuring developers have a clear understanding before implementation begins.

Quick Start

Use the refine-specification skill to refine the draft specification located at 'docs/features/new-user-onboarding.md'.

Frequently Asked Questions about refine-specification

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

FAQPage Schema
How do I refine draft feature specifications into implementation-ready documentation?▼

To refine draft feature specifications, this Skill asks targeted clarifying questions across five domains: Scope, Users, Data Model, Integrations, and Non-Functional Requirements, then generates a structured summary document ready for development.

What is the best way to flesh out high-level product ideas for developers?▼

Fleshing out high-level product ideas requires systematically detailing user workflows and data models. This Skill provides suggested answers to targeted questions, transforming rough drafts into comprehensive, actionable specifications for development teams.

Can I use this to refine requirements for non-functional specifications?▼

Yes, you can refine requirements for non-functional specifications. The Skill explicitly examines Non-Functional Requirements alongside Scope, Users, Data Model, and Integration domains to ensure complete coverage of your feature documentation.

How does interactive Q&A work for product management analysis?▼

Interactive Q&A for product management analysis works by adapting clarifying questions based on your draft specification input. It guides you through defining scope and external services, providing suggested answers to streamline the refinement process.

Do I need a specific file format to start refining specifications?▼

You need a draft feature specification in a document format, such as a markdown file. The Skill processes this draft text to identify gaps and asks targeted questions to produce the final structured output document.

Related Skills

Explore More Product & Management Skills→
lionbenjaminlionbenjamin
15

specify

Draft product specifications with problem, goals, user stories, and acceptance criteria.

Community
Intermediate
atlassianatlassian
949

spec-to-backlog

Convert Confluence specification documents into structured Jira backlogs with Epics and linked tickets.

Official
Intermediate
AgentientAgentient
2

er-diagram-and-data-modeling

Identify and visualize entity-relationship structures from domain data.

Official
Basic
VYRE-StudiosVYRE-Studios

code-review

Review Git changes for correctness, security, performance, and maintainability.

Official
Advanced