Files
Reza Rezvani 920e8547af feat(commands): add /plugin-audit — 8-phase validation pipeline for skills and plugins
- Add commands/plugin-audit.md (distributable) + .claude/commands/plugin-audit.md (local invocation)
- 8 phases: discovery, structure validation, quality scoring, script testing,
  security audit, marketplace compliance, ecosystem integration, domain code review
- Auto-fixes non-critical issues, only prompts user for breaking changes
- Integrates skill_validator.py, quality_scorer.py, script_tester.py, skill_security_auditor.py
- Domain-appropriate review via cs-* agents (engineering, product, marketing, etc.)
- Update product-team counts: 12→14 skills, 13→16 tools, 7→8 commands
- Add /code-to-prd and /plugin-audit to mkdocs.yml nav
- Regenerate docs (248 pages, 19 commands)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-17 15:38:00 +01:00

10 KiB
Raw Permalink Blame History

Product Team Skills - Claude Code Guidance

This guide covers the 14 production-ready product management skills and their Python automation tools.

Product Skills Overview

Available Skills:

  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)

Total Tools: 16 Python automation tools

Agents: 5 (cs-product-manager, cs-agile-product-owner, cs-product-strategist, cs-ux-researcher, cs-product-analyst)

Slash Commands: 8 (/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:

# 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:

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:

# 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:

# 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:

# 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:

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:

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:

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:

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:

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:

# 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:

# 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:

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:

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

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

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

Workflow 3: Research to Persona Artifacts

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

Workflow 4: Brand-Aligned Landing Page

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

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

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

Workflow 7: Roadmap and Release Communication

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: March 17, 2026 Skills Deployed: 14/14 product skills production-ready Total Tools: 16 Python automation tools Agents: 5 | Commands: 8