write-next-story-from-shell-story

Convert the next unwritten shell story in a Jira epic into a full Jira story.

24|3|Updated Jul 17, 2025
One-click install
npx skills add https://github.com/bitovi/cascade-mcp --skill write-next-story-from-shell-story
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: write-next-story-from-shell-story
Source: https://github.com/bitovi/cascade-mcp/tree/main/plugins/cascade-mcp/skills/write-next-story-from-shell-story
Command: npx skills add https://github.com/bitovi/cascade-mcp --skill write-next-story-from-shell-story

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Turn unwritten shell stories in a Jira epic into fully formed Jira stories by loading only the screens referenced in the shell, performing a shell-story anchored scope analysis, and generating a complete story description with acceptance criteria, non-functional requirements, and developer notes if provided.

Core Features & Use Cases

  • Convert the next unwritten shell story into a full Jira story, preserving the shell story's scope bullets as the anchor for acceptance criteria.
  • Load only the Figma screens specified by the target shell story, perform scope analysis, and generate a detailed description suitable for Jira.
  • Mark the shell story as complete in the epic and optionally link blockers to dependent stories.

Quick Start

Provide the Jira epic key and optional shell story ID to begin generating the full Jira story.

Frequently Asked Questions about write-next-story-from-shell-story

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

FAQPage Schema
How do I convert shell story bullets in Jira epics into full stories with acceptance criteria?

To convert shell story bullets into full Jira stories, the Skill loads the epic's Shell Stories section, identifies the next unwritten target, and generates a complete User Story Description with Acceptance Criteria in Gherkin format. It anchors the scope analysis directly to the shell bullets.

Can I generate Gherkin acceptance criteria for Jira stories from Figma screens automatically?

Yes, you can generate Gherkin acceptance criteria by providing a Jira epic key. The Skill loads only the Figma screens referenced in the target shell story, performs scope analysis, and outputs Non-Functional Requirements and Developer Notes alongside the Gherkin criteria.

What is the process for linking dependency stories when creating Jira tickets from an epic?

Linking dependency stories happens automatically during ticket creation. After generating the full Jira story under the specified epic, the Skill links any identified dependency stories as blockers and marks the original shell story as complete in the epic upon success.

Does this story-writing automation require a specific shell story ID to start?

No, a specific shell story ID is optional. You can begin generating the full Jira story by providing just the Jira epic key, and the Skill will automatically identify and convert the next unwritten shell story in the epic's queue.

How do I perform scope analysis for Jira epics without loading the entire Figma file?

Scope analysis is performed by loading only the specific Figma screens referenced by the target shell story bullets. This targeted loading prevents full file processing and anchors the generated story description strictly to the relevant design frames.

Why are my shell stories not being marked as complete in Jira after ticket generation?

Shell stories are marked complete in the epic only upon successful story generation and ticket creation. If the process fails to create the Jira issue under the specified epic or link dependencies, the shell story status remains unchanged to prevent data loss.