skill Claude Code CX Codex Cursor GitHub Copilot
Open on GitHub
job-stories — Claude Code skill: what it does, how to install
Generates job stories in the "When [situation], I want to [motivation], so I can [outcome]" format with acceptance criteria. Useful for framing backlog items around context instead of user roles.
Install into Claude Code · Skills CLI (Vercel)
All methods and platforms ↓
npx skills add phuryn/pm-skills --skill job-stories -a claude-codeWhat job-stories does
This skill structures product requirements around the Jobs-to-be-Done framework. It focuses on context. Instead of user personas, it captures the triggering situation, user motivation, and target outcome. The output pairs the core narrative with detailed acceptance criteria and design links.
The workflow expects four arguments: $PRODUCT, $FEATURE, $DESIGN, and $CONTEXT. Without concrete user scenarios upfront, the generated acceptance criteria risk staying too generic. Criteria verify system state recognition, visible progress feedback, edge cases, and notifications.
What it helps with
- write job stories using the JTBD framework
- frame backlog requirements around user situations instead of roles
- generate measurable acceptance criteria for feature tickets
- link Figma design mockups directly to job stories
Example prompts for the agent
- Create job stories for $FEATURE in $PRODUCT using context $CONTEXT and design $DESIGN
- Break down the weekly snack spending feature into a job story with acceptance criteria
How to install job-stories
1Skills CLI (Vercel)
npx skills add phuryn/pm-skills --skill job-stories -a claude-code2Manually: put the files in place
~/.claude/skills/job-stories/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/job-stories/
1Skills CLI (Vercel)
npx skills add phuryn/pm-skills --skill job-stories -a codex2Manually: put the files in place
.agents/skills/job-stories/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add phuryn/pm-skills --skill job-stories -a cursor2Manually: put the files in place
.cursor/skills/job-stories/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install phuryn/pm-skills job-stories2Manually: put the files in place
.github/skills/job-stories/SKILL.md1Skills CLI (Vercel)
npx skills add phuryn/pm-skills --skill job-stories -a gemini-cli2Platform CLI
gemini skills install https://github.com/phuryn/pm-skills --path pm-execution/skills/job-storiesManually: put the files in place
.devin/skills/job-stories/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add phuryn/pm-skills --skill job-stories -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
From the same set61
The whole set →
create-prd This skill builds a lean PRD from an 8-section template. Use it to define a feature, document product requirements, or review an existing PRD.
Claude Code CX Codex Cursor +1
10,800installs
pre-mortem Runs a pre-mortem risk assessment on PRDs and launch plans. Catches critical launch blockers, surfaces hidden team assumptions, and maps action items.
Claude Code CX Codex Cursor +1
10,200installs
outcome-roadmap Rewrites feature-heavy roadmaps into outcome-focused statements tied to business and customer impact. Helps teams replace rigid feature lists with measurable strategic goals.
Claude Code CX Codex Cursor +1
9,900installs
prioritization-frameworks Reference guide to 9 prioritization frameworks: RICE, ICE, Opportunity Score, Kano, MoSCoW and more. Helps you pick the right method, compare approaches, and rank tasks by importance.
Claude Code CX Codex Cursor +1
9,900installs
strategy-red-team Stress-tests PRDs, roadmaps, and strategies by attacking load-bearing assumptions before reality does, returning kill criteria and cheap tests.
Claude Code CX Codex Cursor +1
9,200installs
competitor-analysis This skill researches direct competitors and compares their positioning, strengths, weaknesses, and pricing. Use it to prepare a competitive brief or find ways to differentiate a product.
Claude Code CX Codex Cursor +1
3,800installs
business-model Skill generates a Business Model Canvas with all 9 building blocks: from key partners and activities to channels and revenue streams. Use it to create a business model, document how value flows, or analyze an existing business.
Claude Code CX Codex Cursor +1
3,700installs
privacy-policy Skill drafts a detailed privacy policy accounting for GDPR, CCPA, and other regulations. Use it when building a new product, updating data protection docs, or preparing for compliance audits.
Claude Code CX Codex Cursor +1
3,500installs
Similar
apple-notes Lets a coding agent read, search and write Apple Notes from the terminal through the memo CLI, with everything syncing over iCloud.
Claude Code CX Codex Cursor +1
381installs
airtable Ready-made curl calls for Airtable's REST API: read records, filter with formulas, write in batches, upsert on a merge field.
Claude Code CX Codex Cursor +1
375installs
apple-reminders Manages Apple Reminders through the remindctl CLI utility. Enables the assistant to read task lists and schedule items with iCloud sync.
Claude Code CX Codex Cursor +1
367installs
teams-meeting-pipeline Manages Microsoft Teams meeting summaries, transcript ingestion, and Graph webhook subscriptions. Useful for replaying failed jobs and checking pipeline health.
Claude Code CX Codex Cursor +1
365installs
find-community A skill that helps you find the community you already belong to and spot problems worth solving for a minimalist business. Use it when searching for a startup idea or unsure where to start as an entrepreneur.
Claude Code CX Codex Cursor +1
2,600installs
find-skills Discovers and installs agent skills from skills.sh directly inside your coding assistant. Handy when you need domain-specific workflows for a project.
Claude Code CX Codex Cursor +1
4,000,000installs
grill-me grill-me interviews you about a plan or design to expose gaps and sharpen decisions. Use it before implementation starts.
Claude Code
1,424,476installs
grill-with-docs This skill interviews you about a plan or design and creates ADRs and a glossary along the way. Use it when decisions need sharper definition.
Claude Code
1,219,756installs
Questions about job-stories
How do I install job-stories in Claude Code?
Run npx skills add phuryn/pm-skills --skill job-stories -a claude-code in your terminal. This adds the skill to Claude Code and configures the local skill path.
What does the job-stories skill do?
It generates requirement cards using the "When [situation], I want to [motivation], so I can [outcome]" format. Each story includes measurable acceptance criteria and a design link.
Which arguments does the job-stories skill require?
The skill accepts the product name $PRODUCT, feature description $FEATURE, design link $DESIGN, and user situation context $CONTEXT. These inputs shape the story and its criteria.
Source text
SKILL.md · MIT
--- name: job-stories description: "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 - [Jobs-to-be-Done Masterclass with Tony Ulwick and Sabeen Sattar](https://www.productcompass.pm/p/jobs-to-be-done-masterclass-with) (video course)
© phuryn · MIT · phuryn/pm-skills
