af-refine-specifications

Transform Linear features into BDD specifications and mini-PRDs.

Updated Feb 8, 2026

Search Tags:#specification #requirements #development process #bdd #ux #mini-prd

Ready to run

npx skills add https://github.com/GainInsightDev/websites --skill af-refine-specifications

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: af-refine-specifications
Source: https://github.com/GainInsightDev/websites/tree/main/.claude/skills/af-refine-specifications
Command: npx skills add https://github.com/GainInsightDev/websites --skill af-refine-specifications

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill bridges the gap between high-level feature ideas and actionable development tasks by transforming Linear features into detailed specifications, including behavior scenarios, visual designs, and technical requirements.

Core Features & Use Cases

Specification Generation: Creates comprehensive mini-PRDs from Linear issues.
Behavioral Scenarios: Defines clear, testable scenarios using BDD principles.
Visual Design Integration: Facilitates the creation of Storybook stories and RTL tests.
Use Case: When a product manager creates a new feature in Linear, this Skill can be used to automatically generate detailed requirements, acceptance criteria, and technical specifications, ensuring all stakeholders have a clear understanding before development begins.

Quick Start

Use the af-refine-specifications skill to refine the Linear feature 'LIN-123'.

Frequently Asked Questions about af-refine-specifications

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

FAQPage Schema

How do I generate detailed BDD specifications and mini-PRDs from Linear features?▼

To generate detailed BDD specifications and mini-PRDs from Linear features, use a refinement process that transforms high-level feature ideas into comprehensive documentation, including behavior scenarios, visual designs, and technical requirements. This ensures stakeholders share a clear understanding before development begins.

What is the best way to create testable behavior scenarios for product features?▼

The best way to create testable behavior scenarios for product features is by applying BDD principles during the specification generation process. This approach transforms feature ideas into clear, testable scenarios that define exact acceptance criteria and expected behaviors.

Can I automatically generate Storybook stories and RTL tests from a Linear issue?▼

Yes, you can automatically generate Storybook stories and RTL tests from a Linear issue. This specification process integrates visual design requirements directly into the generated documentation, facilitating the creation of component specs and testable frontend scenarios.

How do I bridge the gap between high-level feature ideas and actionable development tasks?▼

To bridge the gap between high-level feature ideas and actionable development tasks, transform Linear features into detailed specifications. This process generates comprehensive mini-PRDs, behavior scenarios, and technical component requirements needed for clear implementation.

Does specification generation support creating selector contracts for component specs?▼

Yes, specification generation supports creating selector contracts for component specs. It generates comprehensive documentation that includes PRDs, Markdown scenarios, Storybook stories, RTL tests, and selector contracts to fully define technical requirements.