BACK TO CLAUDE CODE
Skill

User Story Creation

Turn a feature idea into a detailed GitHub issue — automatically

How to add this

  1. 1.Copy the skill below
  2. 2.Paste it into Claude Code and ask it to save this as a skill in your project
  3. 3.Run /user-story followed by your feature description

How I Use This

This is a Claude Code skill that lives in my project. When I have a feature idea, I run /user-story followed by a description of what I want. Claude reads the codebase, figures out what files need changing, and creates a fully structured GitHub issue — ready for someone (or another AI session) to pick up and build.

It saves me from writing boilerplate issues by hand and ensures every story follows the same structure: summary, current vs desired behaviour, implementation plan with actual file paths, dependencies, and testing steps.

Process

1

Understand the feature

Ask clarifying questions if the request is ambiguous. Otherwise, proceed.

2

Research the codebase

Read relevant source files to understand the current implementation, existing patterns, and where the new feature fits.

3

Write the issue

Use gh issue create with the structured template below.

Issue Template

Every issue created by this skill follows this structure:

SummaryOne-paragraph description of what the feature does and why it’s needed.
Current BehaviourWhat happens today, or what’s missing.
Desired BehaviourWhat should happen after implementation.
Implementation PlanFiles to modify, files to create, and a step-by-step numbered list specific enough to follow without ambiguity.
DependenciesNew packages, API scopes, env vars, or infrastructure needed.
TestingHow to verify the feature works end-to-end.
Scope / Out of ScopeWhat’s included and explicitly what’s not.

Rules

  • -Keep it concise but complete — no filler
  • -Reference actual file paths and function names from the codebase
  • -Use the project’s existing patterns (tool registry, googleapis client pattern, etc.)
  • -Label with enhancement unless it’s a bug fix
  • -Pass title and body via HEREDOC to preserve formatting

Add to your project

Download the file and drop it into your Claude Code skills directory.