Tooluck logoTooluck
SKILL.md

job-stories

Agent skill fromphuryn/pm-skills

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.

How to install job-stories

install job-stories
# install the pm-skills pack with the skills CLI
npx skills add phuryn/pm-skills

# or add only this skill to Claude Code: copy the folder

pm-execution/skills/job-stories/

# into

~/.claude/skills/job-stories/ (all projects)

.claude/skills/job-stories/ (one project)

pm-execution/skills/job-stories/SKILL.md

MITFull file
1# Job Stories
2
3Create 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.
4
5**Use when:** Writing job stories, expressing user situations and motivations, creating JTBD-style backlog items, or focusing on user context rather than roles.
6
7**Arguments:**
8- `$PRODUCT`: The product or system name
9- `$FEATURE`: The new feature to break into job stories
10- `$DESIGN`: Link to design files (Figma, Miro, etc.)
11- `$CONTEXT`: User situations or job scenarios
12
13## Step-by-Step Process
14
151. **Identify user situations** that trigger the need
162. **Define motivations** underlying the user's behavior
173. **Clarify outcomes** the user wants to achieve
184. **Apply JTBD framework:** Focus on the job, not the role
195. **Create acceptance criteria** that validate the outcome is achieved
206. **Use observable, measurable language**
217. **Link to design mockups** or prototypes
228. **Output job stories** with detailed acceptance criteria
23
24## Story Template
25
26**Title:** [Job outcome or result]
27
28**Description:** When [situation], I want to [motivation], so I can [outcome].
29
30**Design:** [Link to design files]
31
32**Acceptance Criteria:**
331. [Situation is properly recognized]
342. [System enables the desired motivation]
353. [Progress or feedback is visible]
364. [Outcome is achieved efficiently]
375. [Edge cases are handled gracefully]
386. [Integration and notifications work]
39…

Excerpt shown under the repository's MIT license.

More skills in pm-skills

Keep exploring

Similar skill repositories

Newsletter

Join the Community

Subscribe to our newsletter for the latest news and updates