phuryn avatar

Job Stories

This generates job stories in the Jobs-to-be-Done format: "When [situation], I want to [motivation], so I can [outcome]." It's an alternative to traditional user stories that focuses on the context and circumstances that trigger a need rather than user roles. You pass in your product name, feature description, design links, and user context, and it outputs complete stories with 6-8 acceptance criteria each. The acceptance criteria are well structured, covering everything from real-time updates to edge cases and notification thresholds. Useful if your team prefers JTBD over personas or if you're working on products where the situation matters more than who the user is. The example about tracking snack spending shows it can handle everyday scenarios, not just enterprise features.

skills.sh installs
2.9K
GitHub stars
27.8K
last updated
Aug 21, 2026

Install

$ npx -y skills add phuryn/pm-skills --skill job-stories --agent claude-code

Installs into .claude/skills of the current project.

Files

Job Stories

Create job stories using the 'When [situation], I want to [motivation], so I can [outcome]' format. Generates stories with detailed acceptance criteria focused on user situations and outcomes.

Use when: Writing job stories, expressing user situations and motivations, creating JTBD-style backlog items, or focusing on user context rather than roles.

Arguments:

  • $PRODUCT: The product or system name
  • $FEATURE: The new feature to break into job stories
  • $DESIGN: Link to design files (Figma, Miro, etc.)
  • $CONTEXT: User situations or job scenarios

Step-by-Step Process

  1. Identify user situations that trigger the need
  2. Define motivations underlying the user's behavior
  3. Clarify outcomes the user wants to achieve
  4. Apply JTBD framework: Focus on the job, not the role
  5. Create acceptance criteria that validate the outcome is achieved
  6. Use observable, measurable language
  7. Link to design mockups or prototypes
  8. Output job stories with detailed acceptance criteria

Story Template

Title: [Job outcome or result]

Description: When [situation], I want to [motivation], so I can [outcome].

Sponsors

Details

Repository
github.com/phuryn/pm-skills
Categories
Documentation, Code Review & Quality
First seen
May 16, 2026

More from phuryn/pm-skills

All 68
1forcedotcom avatarhandling-sf-dataforcedotcom/sf-skillsSalesforce data operations with 130-point scoring. Use this skill to create, update, delete, bulk import/export, generate test data, and clean up org records us2.9Kskills.sh installs
2dynatrace avatardt-obs-servicesdynatrace/dynatrace-for-aiService performance monitoring with RED metrics (Rate, Errors, Duration) and runtime-specific telemetry for Java, .NET, Node.js, Python, PHP, and Go. Use when a2.9Kskills.sh installs
3nicholasspisak avatarsecond-brainnicholasspisak/second-brainSet up a new Obsidian knowledge base with the LLM Wiki pattern. Use when the user wants to create a second brain, initialize a vault, set up a personal knowledg2.9Kskills.sh installs
4shubhamsaboo avatarmeeting-notesshubhamsaboo/awesome-llm-appsStructured meeting summaries with action items, decisions, and key discussion points. Use when: taking meeting notes, summarizing discussions, tracking action i2.9Kskills.sh installs
5mastra-ai avatarreact-best-practicesmastra-ai/mastraReact performance optimization guidelines from Mastra Engineering. This skill should be used when writing, reviewing, or refactoring React code to ensure optima2.8Kskills.sh installs
6openai avatartest-tuiopenai/codexGuide for testing Codex TUI interactively2.8Kskills.sh installs