plan-experiences

Enumerates user experiences for a capability and files one GitHub issue per experience.

1|Updated Mar 7, 2023
One-click install
npx skills add https://github.com/Zaba505/infra --skill plan-experiences-zaba505
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-experiences
Source: https://github.com/Zaba505/infra/tree/main/.claude/skills/plan-experiences
Command: npx skills add https://github.com/Zaba505/infra --skill plan-experiences-zaba505

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Breaking a business capability into individual user experiences is error-prone: journeys get bundled together, seams between journeys mismatch, and drafting starts before the full set is visible. This Skill enumerates the complete set of user experiences implied by a reviewed capability doc and files one GitHub issue per experience so each can be authored individually. ## Core Features & Use Cases - Review Gate Enforcement: Refuses to run unless the capability doc has a reviewed_at frontmatter date newer than the file's last modification, preventing planning against unreviewed drafts. - Grounded Enumeration: Proposes verb-led journey titles with persona and goal, each anchored to specific capability sections (Stakeholders, Triggers, Outputs, Business Rules, Success Criteria), and rejects bundled or cross-capability journeys. - Issue Filing Workflow: After human approval, files one GitHub issue per experience via gh issue create using the repo's story(ux): title convention, wires blocked by ordering edges, and places issues on the project board with milestone and Area set. - Use Case: After reviewing the self-hosted-personal-media-storage capability, invoke this Skill to produce a confirmed list like "upload a photo", "share an album", and "delete content", then file one tracked issue per journey for later authoring via define-user-experience. ## Quick Start Ask the assistant to plan the user experiences for a reviewed capability doc, for example: "Plan the user experiences for the self-hosted-personal-media-storage capability."

Frequently Asked Questions about plan-experiences

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I break a business capability into user experiences?

Read the capability doc end-to-end, then propose one journey per persona-goal pair with a distinct entry point and success state, each anchored to specific capability sections. Confirm the list with a human before filing one GitHub issue per experience.

How do I file GitHub issues for planned user experiences with gh CLI?

Use gh issue create with a story(ux): title convention and a body naming the persona, goal, parent capability, and anchoring sections. Then wire ordering with gh issue edit --add-blocked-by and add items to the project board with gh project item-add.

Why does the skill refuse to plan experiences for my capability?

The capability doc must have a reviewed_at frontmatter date newer than the file's last modification time. If reviewed_at is missing, null, or stale, the skill stops and asks you to review the doc and update the field before proceeding.

Can one user experience cover multiple journeys like upload, share, and delete?

No. Bundling multiple goals into one experience forces mismatched entry points and success states into a single UX doc. The skill splits such bundles into separate experiences, one persona plus one goal each, and asks which to tackle first.

When should I not use this skill for UX planning?

Do not use it to draft or define an individual user experience; that is the define-user-experience skill's job. Also do not use it for journeys belonging to a different capability or for defining a brand-new capability, which requires define-capability first.