create-story

Create a GitHub Story issue linked to a parent Feature with SN.x.y formatting.

Updated Feb 17, 2026
One-click install
npx skills add https://github.com/ajrmooreuk/pfi-w4m-dev --skill create-story-ajrmooreuk
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-story
Source: https://github.com/ajrmooreuk/pfi-w4m-dev/tree/main/azlan-github-workflow/skills/create-story
Command: npx skills add https://github.com/ajrmooreuk/pfi-w4m-dev --skill create-story-ajrmooreuk

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates the creation of properly formatted Story issues linked to a parent Feature in GitHub, reducing manual steps and ensuring consistent naming.

Core Features & Use Cases

  • Creates a Story issue in the correct SN.x.y format and links it to the parent Feature.
  • Determines the next story sequence for a given feature, with optional override of the parent identifier.
  • Gathers required inputs (title, user story, acceptance criteria) and formats the issue body accordingly.
  • Updates the parent Feature's Stories checklist when possible to reflect new work.

Quick Start

Invoke the create-story action with a title and optional --feature flag to generate and link a new Story under the specified feature.

Frequently Asked Questions about create-story

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

FAQPage Schema
How do I create a GitHub story issue linked to a parent feature?

To create a GitHub story issue linked to a parent feature, use this skill to compute the next story sequence, collect the title and acceptance criteria, and generate an issue formatted as SN.x.y referencing the parent feature.

How does story sequence numbering work for GitHub feature issues?

Story sequence numbering uses the SN.x.y format, where the skill identifies the parent feature and computes the next sequential number for the new story issue automatically using jq parsing.

Do I need the gh CLI to automate GitHub story issue creation?

Yes, you need the gh CLI installed to automate GitHub story issue creation, along with jq for parsing and string manipulation to format the issue body and update the parent feature checklist.

Can I override the parent feature identifier when creating a story?

Yes, you can override the parent feature identifier when creating a story by providing the optional --feature flag during invocation to link the issue to a specific feature.

What's the best way to update a feature checklist when adding a story on GitHub?

The best way to update a feature checklist when adding a story on GitHub is to automate it during issue creation, where the skill updates the parent feature's Stories checklist to reflect the new work where possible.