User Story Writer
Transform feature ideas into testable user stories with acceptance criteria
What You Can Do
You can take rough feature ideas, product specifications, or backlog items and transform them into independently valuable, testable user stories that teams can develop against immediately. The skill grounds each story in specific user personas, defines verifiable acceptance criteria, identifies edge cases and risks, and establishes clear out-of-scope boundaries to prevent scope creep. This creates a conversation contract between product, design, and engineering that eliminates ambiguity.
Features
writes stories from the perspective of specific user types with clear motivations and context
generates verifiable, testable conditions that are free of ambiguity
flags boundary conditions, security considerations, and integration points that could break the story
explicitly states what the story does NOT include to prevent scope creep
ensures each story delivers measurable user value without depending on other stories
highlights dependencies, technical risks, and assumptions that teams should validate
structures stories to be easily validated through acceptance tests
Example Output
Input: "We need to improve the search function"
Output:
User Story: As a content researcher, I want to filter search results by publication date so that I can find recent articles relevant to my current project without manually reviewing outdated sources.
Acceptance Criteria:
- Date filter dropdown appears on search results page
- User can select from: Last 7 days, Last 30 days, Last 90 days, Custom range
- Results are sorted by date (most recent first) when filter is applied
- Filter state persists when user navigates and returns to results
- "No results" message displays if filter matches zero items
Edge Cases:
- What happens if user selects a future date in custom range?
- How should system handle articles with missing/invalid publication dates?
- Performance impact if filtering 500k+ articles?
Out of Scope:
- Advanced search operators or boolean queries
- Saved search filters
- Natural language date parsing ("last Tuesday")
What's Included
- SKILL.md: Complete user story writing instruction file with activation contexts and workflows
- User Story Template: Pre-formatted markdown template with persona, narrative, acceptance criteria, edge cases, and out-of-scope sections
- Persona Definition Checklist: Guide for identifying and documenting user personas (role, goals, pain points, context)
- Acceptance Criteria Framework: Structured approach to writing testable, unambiguous criteria using Gherkin-style examples
- Scope Management Worksheet: Tool for defining story boundaries and preventing scope creep
Who It's For
- Product managers — decomposing feature requests into development-ready stories that prevent miscommunication
- Scrum masters and agile coaches — facilitating backlog refinement and ensuring stories meet definition of ready
- Engineering leads — translating vague requirements into concrete, testable acceptance criteria for teams
- UX/product designers — grounding user stories in behavioral context and user motivations
- QA and test engineers — identifying edge cases and generating test scenarios from acceptance criteria
Best For
- Converting feature requests into backlog items ready for sprint planning
- Decomposing large, vague epics into smaller independently-valuable stories
- Refining stories that lack clear acceptance criteria or testability
- Identifying and documenting scope boundaries to prevent mid-sprint creep
- Building conversation contracts between product, design, and engineering teams
You might also like
Turn project descriptions, timelines, and structured data into professional draw.io diagrams instantly. You can generate flowcharts, org charts, Gantt charts, swimlane diagrams, and process flows by describing what you need. Claude creates draw.io XML that you can open directly in the editor or modify further.
by skillslib
You can design culturally appropriate survey instruments tailored to international development contexts, analyze mixed-methods data by integrating quantitative findings with qualitative insights, and implement robust data quality management systems for your field operations. Claude helps you create survey templates with adaptive logic, develop validation protocols, and produce data quality reports that highlight issues before analysis begins.
by skillslib
You can evaluate whether products are viable remanufacturing candidates by conducting systematic disassembly analysis and identifying recovery opportunities. The skill helps you design efficient remanufacturing workflows, calculate ROI and environmental impact metrics (including embodied energy recovery of 85-90%), and create remanufacturability scorecards that guide design improvements and supply chain decisions.
by skillslib
You can diagnose warehouse bottlenecks using structured data analysis, then generate optimized layouts and flow improvements. The skill models space utilization, labor deployment, and throughput constraints to identify quick wins and long-term improvements, delivering quantified cost savings and performance gains for your specific facility.
by skillslib
You can systematically code qualitative data against your evaluation framework, surface patterns and themes across multiple responses, extract compelling impact stories with supporting evidence, and generate summary matrices that link narrative findings to your outcomes claims. This skill maintains analytical rigor while reducing the 40-60 hours typically spent manually reviewing transcripts and open-ended survey responses per evaluation cycle.
by skillslib
Get complete, ready-to-deploy lead magnets tailored to your ideal customer profile. Claude designs the concept, writes the persuasive copy, builds the email sequences, and creates deployment strategies that attract qualified prospects and build engaged lists fast. You'll capture 3-5x more subscribers with magnetic offers that actually resonate.
by skillslib
You can convert raw discovery call notes into polished, multi-section sales proposals that include executive summaries tailored to buyer personas, needs analysis mapped to your solution architecture, tiered pricing options with competitive positioning, ROI projections with financial justification, and realistic implementation timelines. The skill preserves personalization and strategic positioning while automating structural components, letting you respond to RFPs and time-sensitive opportunities without sacrificing quality or consistency.
by skillslib
This skill generates optimized facility layouts by analyzing material and personnel flow patterns, validating against operational constraints, and comparing multiple design options with quantified metrics. You provide your facility's dimensions, equipment locations, and operational requirements, and Claude produces detailed layouts with flow efficiency scores, space utilization analysis, and cost-benefit comparisons. Each layout option includes specific recommendations for improving throughput, reducing congestion points, and enhancing safety compliance.
by skillslib