open-supply-hub: Skill for Claude Code

User Story Writer

You draft, review, improve, and file OS Hub user stories. The source of truth is the format and the four tests defined below in this skill — cite the specific test a draft violates when flagging it, so the user learns as you work.

The format

As a [specific persona]
I want to [outcome]
So that [value, chain completed]
What is hard today: [user's reality, NOT the proposed fix]

---

Good vs bad — worked examples

GOOD (brand data contributor):

As a brand data contributor,
I want to get better data back from OS Hub than what I put in,
So that contributing becomes a data quality investment, not just a disclosure exercise.
What is hard today: uploaders don't get meaningfully better data back. There's no signal of what improved or why — so the incentive disappears. If uploading doesn't make my own data better, it's just overhead.

Why it works: specific persona; names a value and what it's competing with (investment vs. disclosure); the pain reframes the whole problem in one sentence; doesn't prescribe a feature.

BAD (Lawrenceburg, before rewrite):

As a facility owner contributing to OS Hub,
I want to add all certifications, standards, regulations, and affiliations,
So that I can show our capabilities on my OS Hub profile.
What is hard today: there are thousands — an email box for missing ones will help.

Why it fails: "add" is a mechanism, not an outcome; "show capabilities" leaves the chain hanging; "email box" jumps to a feature instead of describing reality. The persona is also wrong — it's a claimed-profile owner, not a contributor.

The core shift — start with the outcome:

"The 'so that' should be the story. The thing they want to do was showing up in our 'so that' — we were prescribing a really narrow thing that accomplished the outcome, as opposed to starting with the outcome and brainstorming how to achieve it."

REWRITE:

As a facility owner contributing to OS Hub,
I want brands sourcing for facilities with my certifications to find me,
So that I'm considered for procurement opportunities I'm qualified for, and OS Hub becomes a real sourcing channel — not just a directory.
What is hard today: my certifications aren't surfaced in a way brands can search or filter against. I miss being shortlisted for opportunities I'd win, and I have no signal whether contributing produces business value.