.build/codex/skills/product-requirements-designer/SKILL.md
Comprehensive product requirements documentation from problem definition through launch planning. Supports both enterprise PRD (full specs, cross-functional alignment) and lean/startup style (hypothesis-driven one-pagers). Framework-agnostic with templates for Agile, Jobs-to-Be-Done, and hybrid approaches. Scaffolds related artifacts including user stories, acceptance criteria, wireframes brief, and technical handoff specs. Triggers on PRD creation, product specs, feature requirements, or product design documentation.
npx skillsauth add organvm-iv-taxis/a-i--skills product-requirements-designerInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Transform product vision into actionable specifications.
Enterprise PRD: Full cross-functional specification
Lean PRD: Hypothesis-driven one-pager
Agile/Scrum: Epics → Features → User Stories → Acceptance Criteria
Jobs-to-Be-Done: Job statement → Forces diagram → Solution mapping
Outcome-Driven: Desired outcomes → Opportunity scoring → Solution requirements
Hybrid: Mix frameworks based on product stage and team needs
[User type] experiences [problem] when trying to [goal],
which results in [negative outcome].
| Evidence Type | Source | Finding | |---------------|--------|---------| | User research | [Study/interviews] | [Key insight] | | Analytics | [Data source] | [Metric showing problem] | | Support data | [Tickets/feedback] | [Pattern identified] | | Market research | [Source] | [Competitive gap] |
| Goal | Metric | Current | Target | Timeline | |------|--------|---------|--------|----------| | [Goal] | [KPI] | [Baseline] | [Target] | [By when] |
| User Segment | Goal | Success Indicator | |--------------|------|-------------------| | [Segment] | [What they want to achieve] | [How we know they succeeded] |
| Persona | Description | Primary Need | Usage Context | |---------|-------------|--------------|---------------| | [Name] | [Who they are] | [Core need] | [When/where/how] |
[Trigger] → [Step 1] → [Pain Point] → [Step 2] → [Pain Point] → [Outcome]
[Trigger] → [Improved Step 1] → [Step 2] → [Desired Outcome]
[High-level description of what we're building]
| ID | Requirement | Priority | Rationale | |----|-------------|----------|-----------| | FR-001 | [System shall...] | P0/P1/P2 | [Why needed] | | FR-002 | [System shall...] | P0/P1/P2 | [Why needed] |
Priority Definitions:
| Category | Requirement | Target | Rationale | |----------|-------------|--------|-----------| | Performance | [Response time, throughput] | [Specific target] | [Why] | | Scalability | [Load, growth capacity] | [Specific target] | [Why] | | Security | [Auth, data protection] | [Standard/compliance] | [Why] | | Accessibility | [WCAG level, devices] | [Specific target] | [Why] | | Reliability | [Uptime, recovery] | [Specific target] | [Why] |
| Interaction | User Action | System Response | Success State | |-------------|-------------|-----------------|---------------| | [Name] | [What user does] | [What happens] | [Result] |
| Scenario | Handling | User Message | |----------|----------|--------------| | [Edge case] | [How handled] | [What user sees] |
| Dependency | Type | Owner | Status | |------------|------|-------|--------| | [System/API/Team] | Blocking/Informational | [Who] | [Status] |
| System | Integration Type | Data Flow | |--------|------------------|-----------| | [System] | [API/Event/Batch] | [In/Out/Bidirectional] |
| Risk | Likelihood | Impact | Mitigation | |------|------------|--------|------------| | [Risk description] | High/Med/Low | High/Med/Low | [Mitigation plan] |
| Flag | Purpose | Default | Rollout Plan | |------|---------|---------|--------------| | [Flag name] | [What it controls] | Off/On | [% ramp plan] |
| Phase | Success Criteria | Go/No-Go Decision | |-------|------------------|-------------------| | Beta | [Criteria] | [Who decides] | | GA | [Criteria] | [Who decides] |
[Conditions and process for rollback]
| Milestone | Date | Owner | Dependencies | |-----------|------|-------|--------------| | PRD approved | [Date] | [PM] | Stakeholder review | | Design complete | [Date] | [Design] | PRD | | Dev complete | [Date] | [Eng] | Design | | QA complete | [Date] | [QA] | Dev | | Launch | [Date] | [PM] | All |
| Question | Owner | Due Date | Status | |----------|-------|----------|--------| | [Question] | [Who answers] | [When] | Open/Resolved |
| Role | Name | Date | Signature | |------|------|------|-----------| | Product | | | | | Engineering | | | | | Design | | | | | [Other stakeholders] | | | |
Feature: [Name]
Owner: [PM]
Date: [Date]
Status: Draft/In Review/Approved
[2-3 sentences: Who has the problem, what is it, why does it matter]
We believe that [solution/change]
for [user segment]
will achieve [outcome]
We will know this is true when [measurable signal]
[Brief description with key capabilities—keep to 3-5 bullets]
| Assumption | Risk if Wrong | How to Validate | |------------|---------------|-----------------| | [Assumption] | [Impact] | [Test/signal] |
In: [Minimum features for learning] Out: [Explicitly deferred]
| Metric | Target | Measurement Method | |--------|--------|-------------------| | [Primary metric] | [Target] | [How measured] | | [Secondary metric] | [Target] | [How measured] |
[Top 2-3 risks with mitigations]
See references/agile-templates.md
See references/jtbd-templates.md
See references/odi-templates.md
This skill scaffolds the following artifacts alongside the PRD:
See references/user-stories-template.md
See references/acceptance-criteria-template.md
See references/wireframes-brief-template.md
See references/technical-handoff-template.md
references/agile-templates.md - Epic, feature, story templatesreferences/jtbd-templates.md - Job statement, forces diagramreferences/odi-templates.md - Outcome-driven innovation templatesreferences/user-stories-template.md - User story formatsreferences/acceptance-criteria-template.md - AC patternsreferences/wireframes-brief-template.md - Design handoff briefreferences/technical-handoff-template.md - Engineering handoff specdevelopment
Dry-run audit + targeted cleanup for shell command history. Currently wraps atuin (stats today, prune, dedup with dated preview artifacts); extensible to zsh/bash/mcfly backends. Always previews before applying — apply commands are echoed for the human to run, never auto-executed. Triggers on "/shell-history-hygiene", "audit atuin", "audit shell history", "clean shell history", "atuin prune", "atuin dedup", "shell history hygiene", "history cleanup". Replaces ad-hoc one-liners (e.g. `... | tee cmd > file.txt` which wrote two files, swallowed dedup output, and left a junk `cmd` file).
tools
Guided Cowork setup — install role-matched plugins, connect your tools, try a skill.
development
Manage AI agent session lifecycles with structured phases (FRAME, SHAPE, BUILD, PROVE), context preservation across sessions, handoff protocols, and session metadata tracking. Triggers on session management, agent lifecycle, or multi-session workflow requests.
tools
Parse a session transcript into a structured Session Governance Index — an annotated bibliography of every file modified and commit made, internal-energy accounting (tool uses, estimated tokens), shipped-vs-tasked atom tally, and classification of missing items as Gaps or Vacuums. Triggers on "visibility-schema-substrate-sweep", "session cascade audit", "session governance audit", or any request to summarize what a session actually produced versus what it was asked to produce.