Product Skills

16 production-ready product skills: product manager toolkit (RICE, PRDs), agile product owner, product strategist, UX researcher, UI design system, competitive teardown, landing page generator, SaaS scaffolder, product analytics, experiment designer, product discovery, roadmap communicator, code-to-prd, research summarizer, apple-hig-expert (Apple Human Interface Guidelines), spec-to-repo. Agent skill and plugin for Claude Code, Codex, Gemini CLI, Cursor, OpenClaw.

# Product Team Skills - Claude Code Guidance

This guide covers the 17 production-ready product management skills (13 bundled incl. the orchestrator + 4 standalone plugins) and their Python automation tools.

## Orchestrator & Discovery Loop (product-skills)

`skills/product-skills/` is the domain's `context: fork` orchestrator and agent harness adapter:

```bash
# Route a product goal deterministically across all 16 lanes (exit 0 route / 2 ask / 3 no signal)
python3 skills/product-skills/scripts/product_goal_router.py --text "help me prioritize features"

# Score the continuous-discovery cadence (Torres weekly habit; refuses on < 2 interviews)
python3 skills/product-skills/scripts/discovery_cadence_tracker.py --input discovery_log.json

# Lint the Opportunity Solution Tree (exit 2 blocks the tree from driving a roadmap)
python3 skills/product-skills/scripts/ost_linter.py --input ost.json
```

Commands: `/cs:product` (router) · `/cs:grill-product` (canon-cited grilling) ·
`/cs:product-loop` (the discovery loop). Agent: `cs-product-orchestrator`. Build-scale
goals compile through `engineering/agent-harness` with the `product-team.json` manifest.
Hard rules: no roadmap cites a tree that fails the linter; single-participant claims are
anecdotes; AI features ship with eval specs (see
`skills/product-skills/references/ai_product_evals.md`).

## Product Skills Overview

**Available Skills:**
0. **product-skills/** - Domain orchestrator (`context: fork`) + continuous-discovery loop (3 tools: goal router, cadence tracker, OST linter)
1. **product-manager-toolkit/** - RICE prioritization, customer interview analysis (2 tools)
2. **agile-product-owner/** - User story generation, sprint planning (1 tool)
3. **product-strategist/** - OKR cascade, strategic planning (1 tool)
4. **ux-researcher-designer/** - Persona generation, user research (1 tool)
5. **ui-design-system/** - Design token generation, component systems (1 tool)
6. **competitive-teardown/** - Competitive matrix building, gap analysis (1 tool)
7. **landing-page-generator/** - Landing page scaffolding (1 tool)
8. **saas-scaffolder/** - SaaS project bootstrapping (1 tool)
9. **product-analytics/** - KPI design, retention/cohort/funnel analysis (1 tool)
10. **experiment-designer/** - Experiment design and sample size planning (1 tool)
11. **product-discovery/** - Discovery frameworks and assumption mapping (1 tool)
12. **roadmap-communicator/** - Roadmap communication and changelog generation (1 tool)
13. **code-to-prd/** - Reverse-engineer any codebase into PRD (2 tools: codebase_analyzer, prd_scaffolder)
14. **research-summarizer/** - Research synthesis and summarization (1 tool)
15. **apple-hig-expert/** - Apple Human Interface Guidelines compliance and design (1 tool: hig_checker)
16. **spec-to-repo/** - Convert a spec document into a scaffolded repository

**Total Tools:** 22 Python automation tools

**Agents:** 6 (cs-product-orchestrator, cs-product-manager, cs-agile-product-owner, cs-product-strategist, cs-ux-researcher, cs-product-analyst)

**Slash Commands:** 11 (/cs:product, /cs:grill-product, /cs:product-loop, /rice, /okr, /persona, /user-story, /competitive-matrix, /prd, /sprint-plan, /code-to-prd)

## Python Automation Tools

### 1. RICE Prioritizer (`product-manager-toolkit/scripts/rice_prioritizer.py`)

**Purpose:** RICE framework implementation for feature prioritization

**Formula:** (Reach × Impact × Confidence) / Effort

**Features:**
- Portfolio analysis (quick wins vs big bets)
- Quarterly roadmap generation
- Capacity planning (story points or dev days)
- CSV input/output for Jira/Linear integration
- JSON export for dashboards

**Usage:**
```bash
# Basic prioritization
python product-manager-toolkit/scripts/rice_prioritizer.py features.csv

# With capacity planning
python product-manager-toolkit/scripts/rice_prioritizer.py features.csv --capacity 20

# JSON output
python product-manager-toolkit/scripts/rice_prioritizer.py features.csv --output json
```

**CSV Format:**
```csv
feature,reach,impact,confidence,effort
User Dashboard,500,3,0.8,5
API Rate Limiting,1000,2,0.9,3
Dark Mode,300,1,1.0,2
```

### 2. Customer Interview Analyzer (`product-manager-toolkit/scripts/customer_interview_analyzer.py`)

**Purpose:** NLP-based interview transcript analysis

**Features:**
- Pain point extraction with severity scoring
- Feature request identification
- Sentiment analysis
- Theme extraction
- Jobs-to-be-done pattern recognition

**Usage:**
```bash
# Analyze transcript
python product-manager-toolkit/scripts/customer_interview_analyzer.py interview.txt

# JSON output
python product-manager-toolkit/scripts/customer_interview_analyzer.py interview.txt json
```

### 3. User Story Generator (`agile-product-owner/scripts/user_story_generator.py`)

**Purpose:** INVEST-compliant user story generation

**Features:**
- Sprint planning with capacity allocation
- Epic breakdown into deliverable stories
- Acceptance criteria generation
- Story point estimation
- Priority scoring

**Usage:**
```bash
# Interactive mode
python agile-product-owner/scripts/user_story_generator.py

# Sprint planning (30 story points)
python agile-product-owner/scripts/user_story_generator.py sprint 30
```

### 4. OKR Cascade Generator (`product-strategist/scripts/okr_cascade_generator.py`)

**Purpose:** Automated OKR hierarchy (company → product → team)

**Features:**
- Alignment scoring (vertical and horizontal)
- Strategy templates (growth, retention, revenue, innovation)
- Key result tracking
- Progress visualization

**Usage:**
```bash
# Growth strategy OKRs
python product-strategist/scripts/okr_cascade_generator.py growth

# Retention strategy
python product-strategist/scripts/okr_cascade_generator.py retention
```

### 5. Persona Generator (`ux-researcher-designer/scripts/persona_generator.py`)

**Purpose:** Data-driven persona creation from user research

**Usage:**
```bash
python ux-researcher-designer/scripts/persona_generator.py
python ux-researcher-designer/scripts/persona_generator.py --output json
```

### 6. Design Token Generator (`ui-design-system/scripts/design_token_generator.py`)

**Purpose:** Complete design token system from brand color

**Usage:**
```bash
python ui-design-system/scripts/design_token_generator.py "#0066CC" modern css
python ui-design-system/scripts/design_token_generator.py "#0066CC" modern scss
python ui-design-system/scripts/design_token_generator.py "#0066CC" modern json
```

### 7. Competitive Matrix Builder (`competitive-teardown/scripts/competitive_matrix_builder.py`)

**Purpose:** Weighted competitive scoring with gap analysis

**Usage:**
```bash
python competitive-teardown/scripts/competitive_matrix_builder.py competitors.json
```

### 8. Landing Page Scaffolder (`landing-page-generator/scripts/landing_page_scaffolder.py`)

**Purpose:** Generate production-ready landing pages as Next.js/React TSX components with Tailwind CSS (default) or plain HTML.

**Features:**
- TSX output (default): Next.js 14+ App Router components with Tailwind classes
- 4 design styles: `dark-saas`, `clean-minimal`, `bold-startup`, `enterprise`
- 7 section generators: nav, hero, features, testimonials, pricing, CTA, footer
- Copy frameworks: PAS, AIDA, BAB

**Usage:**
```bash
python landing-page-generator/scripts/landing_page_scaffolder.py config.json --format tsx
python landing-page-generator/scripts/landing_page_scaffolder.py config.json --format html
```

### 9. Project Bootstrapper (`saas-scaffolder/scripts/project_bootstrapper.py`)

**Purpose:** SaaS project scaffolding with auth, billing, and API setup

**Usage:**
```bash
python saas-scaffolder/scripts/project_bootstrapper.py project_config.json
```

### 10. Metrics Calculator (`product-analytics/scripts/metrics_calculator.py`)

**Purpose:** Product analytics — retention, cohort, and funnel analysis

**Features:**
- Retention curve analysis from event data
- Funnel conversion tracking with stage-by-stage drop-off
- Cohort grouping and comparison

**Usage:**
```bash
# Retention analysis
python product-analytics/scripts/metrics_calculator.py retention events.csv

# Funnel analysis
python product-analytics/scripts/metrics_calculator.py funnel funnel.csv --stages visit,signup,activate,pay

# KPI summary
python product-analytics/scripts/metrics_calculator.py kpi metrics.csv --json
```

### 11. Sample Size Calculator (`experiment-designer/scripts/sample_size_calculator.py`)

**Purpose:** Statistical sample size planning for A/B tests and experiments

**Features:**
- Minimum detectable effect (MDE) calculation
- Absolute and relative effect size modes
- Power analysis with configurable alpha/beta

**Usage:**
```bash
# Absolute MDE
python experiment-designer/scripts/sample_size_calculator.py --baseline-rate 0.12 --mde 0.02 --mde-type absolute

# Relative MDE
python experiment-designer/scripts/sample_size_calculator.py --baseline-rate 0.12 --mde 0.15 --mde-type relative

# Custom power/significance
python experiment-designer/scripts/sample_size_calculator.py --baseline-rate 0.12 --mde 0.02 --alpha 0.01 --power 0.9
```

### 12. Assumption Mapper (`product-discovery/scripts/assumption_mapper.py`)

**Purpose:** Map and prioritize product assumptions for discovery validation

**Features:**
- Risk × uncertainty scoring for prioritization
- CSV input with structured assumption fields
- Categorization by assumption type (desirability, viability, feasibility, usability)

**Usage:**
```bash
python product-discovery/scripts/assumption_mapper.py assumptions.csv
python product-discovery/scripts/assumption_mapper.py assumptions.csv --json
```

### 13. Changelog Generator (`roadmap-communicator/scripts/changelog_generator.py`)

**Purpose:** Generate structured changelogs from git commit history

**Note:** Requires `git` on PATH — must be run inside a git repository.

**Usage:**
```bash
python roadmap-communicator/scripts/changelog_generator.py --from v1.0.0 --to HEAD
python roadmap-communicator/scripts/changelog_generator.py --from v1.0.0 --to v2.0.0 --json
```

## Product Workflows

### Workflow 1: Feature Prioritization to Sprint Execution

```bash
python product-manager-toolkit/scripts/rice_prioritizer.py features.csv --capacity 30
python agile-product-owner/scripts/user_story_generator.py sprint 30
```

### Workflow 2: Strategy to Team-Level OKRs

```bash
python product-strategist/scripts/okr_cascade_generator.py growth --json > okrs.json
```

### Workflow 3: Research to Persona Artifacts

```bash
python ux-researcher-designer/scripts/persona_generator.py json > personas.json
```

### Workflow 4: Brand-Aligned Landing Page

```bash
python ../marketing-skill/content-production/scripts/brand_voice_analyzer.py website_copy.txt --format json > voice.json
python ui-design-system/scripts/design_token_generator.py "#0066CC" modern css
python landing-page-generator/scripts/landing_page_scaffolder.py config.json --format tsx
python competitive-teardown/scripts/competitive_matrix_builder.py competitors.json
```

### Workflow 5: Product Analytics and Experimentation

```bash
python product-analytics/scripts/metrics_calculator.py retention events.csv
python product-analytics/scripts/metrics_calculator.py funnel funnel.csv --stages visit,signup,activate,pay
python experiment-designer/scripts/sample_size_calculator.py --baseline-rate 0.12 --mde 0.02 --mde-type absolute
```

### Workflow 6: Discovery and Opportunity Validation

```bash
python product-discovery/scripts/assumption_mapper.py assumptions.csv
```

### Workflow 7: Roadmap and Release Communication

```bash
python roadmap-communicator/scripts/changelog_generator.py --from v1.0.0 --to HEAD
```

## Quality Standards

**All product Python tools must:**
- CLI-first design for automation
- Support both interactive and batch modes
- JSON output for tool integration
- Standard library only (minimal dependencies)
- Actionable recommendations

## Additional Resources

- **Main Documentation:** `../CLAUDE.md`
- **Marketing Brand Voice:** `../marketing-skill/content-production/scripts/brand_voice_analyzer.py`

---

**Last Updated:** July 3, 2026
**Skills Deployed:** 17/17 product skills production-ready (product-skills is now a fork-orchestrator + discovery loop)
**Total Tools:** 22 Python automation tools
**Agents:** 6 | **Commands:** 11

View raw file