← Back to list
✍️

job-stories Checked

Create job stories using the 'When [situation], I want to [motivation], so I can [outcome]' forma…
✍️ Writing skills By phuryn Version v1.0.0 Added 2026-09-03 Updated 2026-09-03 Source ↗
7.6Overall rating
1Views
4Downloads
26.0kStars

Installation

🤖 Install via AI

Copy the prompt below and send it to your AI assistant (e.g. Claude Code) — it will follow the instructions and install automatically.

Install the "job-stories" skill by following the instructions at https://skill123.me/install/job-stories.
⌨️ Command line install

Run in your terminal — downloads and installs to ~/.claude/skills/.

curl -fsSL https://skill123.me/install/job-stories.sh | bash
📦 Download ZIP

Download the zip and extract it into your skills directory (e.g. ~/.claude/skills/), then restart your session.

⬇ Download v1.0.0 · 1 KB
📊 Static rating
7.6/10
Trigger
6.5
Structure
8.0
Workflow
6.0
Content
8.0
Engineering
9.0
Security
9.5

Six-dimension rubric with reviewer rationale.

View scorecard ↓
🛡 Dynamic test
—

Not live-tested yet — this skill is rated on static analysis only.

About this skill

Create job stories using the 'When [situation], I want to [motivation], so I can [outcome]' format with detailed acceptance criteria. Use when writing job stories, creating JTBD-style backlog items, or expressing user situations and motivations.

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

Documentation

Create job stories using the 'When [situation], I want to [motivation], so I can [outcome]' format with detailed acceptance criteria. Use when writing job stories, creating JTBD-style backlog items, or expressing user situations and motivations.

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].

**Design:** [Link to design files]

**Acceptance Criteria:**

1. [Situation is properly recognized]

2. [System enables the desired motivation]

3. [Progress or feedback is visible]

4. [Outcome is achieved efficiently]

5. [Edge cases are handled gracefully]

6. [Integration and notifications work]

Example Job Story

**Title:** Track Weekly Snack Spending

**Description:** When I'm preparing my weekly allowance for snacks (situation), I want to quickly see how much I've spent so far (motivation), so I can make sure I don't run out of money before the weekend (outcome).

**Design:** [Figma link]

**Acceptance Criteria:**

1. Display Spending Summary with 'Weekly Spending Overview' section

2. Real-Time Update when expense logged

3. Progress Indicator (progress bar showing 0-100% of weekly budget)

4. Remaining Budget Highlight in prominent color

5. Detailed Spending Log with breakdown by category

6. Notifications at 80% budget threshold

7. Weekend-Specific Reminder at 90% by Thursday evening

8. Easy Access and Navigation to detailed breakdown

Output Deliverables

  • Complete set of job stories for the feature
  • Each story follows the 'When...I want...so I can' format
  • 6-8 acceptance criteria focused on outcomes
  • Stories emphasize user situations and motivations
  • Clear links to design and prototypes

---

### Further Reading

Score breakdown

Trigger
6.5
Description gives format, What and When with JTBD synonyms; no When-Not exclusion and no Chinese keywords.
Structure
8.0
74-line single file with template, example, and deliverables list; appropriately minimal with no extra files.
Workflow
6.0
Eight steps plus template and concrete worked example; steps are high-level and generic, no error handling or output self-check.
Content
8.0
Mostly crisp; a few vague imperatives like use observable language, but the snack-spending example grounds it.
Engineering
9.0
Valid frontmatter; no scripts; the one external link (productcompass.pm) is a credible PM newsletter.
Security
9.5
No scripts, secrets, injection, or network calls; benign content throughout.
Clean compact generator skill for JTBD job stories with a usable template and worked example; steps are generic and it lacks boundary and verification design.