user-story

Installation
SKILL.md

Follow these steps in order:

  1. Check the output configuration. Look for skills.user-story.format in AGENTS.md. If not configured, see template files in format/ (relative to this skill) to present the available options and ask the user to choose before proceeding.
  2. Understand the project context. Before writing anything, explore the repository to ground the story in the real codebase. Read the README, scan docs/ or any documentation folder, and skim relevant source files (routes, components, models, config). Look for the tech stack, existing terminology, domain language, feature boundaries, and naming conventions the team already uses. This prevents inventing features that already exist and ensures acceptance criteria reference actual UI labels, page names, and workflows.
  3. Identify the user persona, their goal, and the ticket type (Story, Task, or Bug). Use what you learned from the codebase to pick the right persona and to align the story's scope with existing architecture.
  4. Write the ticket following the standards below. Weave in project-specific details — reference real page names, existing components, and established terminology rather than generic placeholders.
  5. Deliver the story using the configured output mode.
  6. If the story covers more than one distinct user goal, ask whether to split it into multiple stories — large stories are harder to estimate and deliver incrementally.

<ticket_types> Story — contains a user story sentence ("As a … I want … so that …") with testable acceptance criteria.

Installs
1
Repository
razbakov/skills
GitHub Stars
3
First Seen
Jun 23, 2026
user-story — razbakov/skills