Jira user story skill

What it is

propay-jira-user-story is a Cursor Agent Skill that helps draft and refine Jira user stories: mandatory metadata, dependencies, Given/When/Then style acceptance criteria, and testable outcomes.

For the full layout and section-by-section helptext (how each part of the story should look in Jira), see 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:

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:

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:

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.
2. Bump the version in CHANGELOG.md following Keep a Changelog.
3. Open a PR; after merge and deploy, users can re-sync.

Raw files for review without cloning:

• SKILL.md on GitHub

Related

• User story layout — section-by-section helptext for each part of the story.
• Jira MCP in Cursor and Figma MCP in Cursor — optional MCP setup for live Jira or Figma context while drafting.