---
title: "Jira user story skill"
description: "Install, update, and version the propay-jira-user-story Cursor Agent Skill from the handbook repository. Canonical path, HTTPS mirrors, and clone-based workflows."
canonical_url: "https://handbook.propay.co.za/analysis/jira-user-story-skill"
---
# Jira user story skill

> Install, update, and version the propay-jira-user-story Cursor Agent Skill from the handbook repository. Canonical path, HTTPS mirrors, and clone-based workflows.

## What it is

**propay-jira-user-story** is a [Cursor Agent Skill](https://cursor.com/docs/context/skills) that helps draft and refine **human-first**, flow-sized Jira user stories: Gherkin summary, tech tasks, business rules, acceptance criteria, test cases, and optional epic grouping.

For the full **layout and section-by-section helptext** (how each part of the story should look in Jira), see [User story layout](https://handbook.propay.co.za/analysis/user-story-layout).

The **canonical source** in Git lives in the handbook repository:

`https://github.com/PropaySystems/handbook/tree/main/analysis/propay-jira-user-story`

A **read-only mirror** of the same files is published under this site for quick downloads (after each deploy):

`https://handbook.propay.co.za/agent-skills/propay-jira-user-story/`

## Install (recommended: sync script)

From any machine with `curl` and write access to your user Cursor config:

```bash
curl -sL https://handbook.propay.co.za/sync-agent-skills.sh | bash
```

This installs into `~/.cursor/skills/propay-jira-user-story/` (override with `TARGET_DIR` if needed—see script header).

## Install (clone or sparse checkout)

Clone the handbook repo and copy only the skill folder:

```bash
git clone --depth 1 https://github.com/PropaySystems/handbook.git
cp -R handbook/analysis/propay-jira-user-story ~/.cursor/skills/propay-jira-user-story
```

For a minimal checkout:

```bash
git clone --filter=blob:none --sparse https://github.com/PropaySystems/handbook.git
cd handbook
git sparse-checkout set analysis/propay-jira-user-story
cp -R analysis/propay-jira-user-story ~/.cursor/skills/propay-jira-user-story
```

## Project-local install

To scope the skill to one repo, copy the folder to `<project>/.cursor/skills/propay-jira-user-story/` instead of `~/.cursor/skills/`.

## Updating

1. **Sync script:** Re-run `sync-agent-skills.sh` after a handbook deploy to pull the latest published mirror.
2. **Git:** `git pull` in your handbook clone and copy the folder again, or re-run sparse checkout steps.

Compare versions using `analysis/propay-jira-user-story/CHANGELOG.md` (semantic versioning for the skill).

## Versioning

- The skill carries its own **semver** in `CHANGELOG.md` (e.g. `1.0.0`).
- Because the skill lives in the **handbook monorepo**, a git tag on the repo applies to the **whole** handbook, not only this skill. To pin an exact artifact, use a **commit SHA** or the dated deploy of `handbook.propay.co.za/agent-skills/...`.

## Cursor Remote Rules / large repos

Pointing Cursor’s remote context at the **entire** handbook repository can pull more than the skill alone. Prefer **this sync script**, **clone + copy**, or **sparse checkout** of `analysis/propay-jira-user-story` only.

## Other Propay repos

Application repositories (for example **petra-prime**) should **not** duplicate this skill long term. Link to this page or to the GitHub path above as the single source of truth; remove embedded copies when convenient.

## Edit the skill

1. Change files under `analysis/propay-jira-user-story/` in [PropaySystems/handbook](https://github.com/PropaySystems/handbook).
2. Bump the version in `CHANGELOG.md` following [Keep a Changelog](https://keepachangelog.com/).
3. Open a PR; after merge and deploy, users can re-sync.

Raw files for review without cloning:

- [SKILL.md on GitHub](https://github.com/PropaySystems/handbook/blob/main/analysis/propay-jira-user-story/SKILL.md)

## Related

- [User story layout](https://handbook.propay.co.za/analysis/user-story-layout) — section-by-section helptext for each part of the story.
- [Jira MCP in Cursor](https://handbook.propay.co.za/analysis/jira-mcp) and [Figma MCP in Cursor](https://handbook.propay.co.za/analysis/figma-mcp) — optional MCP setup for live Jira or Figma context while drafting.


## Sitemap

See the full [sitemap](https://handbook.propay.co.za/sitemap.md) for all pages.
