Improve skill discoverability

pm-data-analytics/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "pm-data-analytics",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Data analytics skills for PMs: SQL query generation and cohort analysis. Analyze user data, generate queries, and identify retention patterns.",
   "author": {
     "name": "Paweł Huryn",

pm-data-analytics/skills/ab-test-analysis/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: ab-test-analysis
-description: "Analyze A/B test results with statistical significance, sample size validation, confidence intervals, and actionable recommendations. Use when evaluating experiment results, checking if a test is significant, interpreting A/B test data, or deciding whether to ship a variant. Triggers: A/B test, AB test, experiment results, statistical significance, test analysis, split test, which variant won."
+description: "Analyze A/B test results with statistical significance, sample size validation, confidence intervals, and ship/extend/stop recommendations. Use when evaluating experiment results, checking if a test reached significance, interpreting split test data, or deciding whether to ship a variant."
 ---
 
 ## A/B Test Analysis

pm-data-analytics/skills/cohort-analysis/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: cohort-analysis
-description: "Perform cohort analysis on user engagement data. Identifies retention patterns, feature usage trends, and suggests qualitative follow-up research. Use when analyzing user retention by cohort, studying feature adoption over time, or investigating engagement patterns. Triggers: cohort analysis, retention analysis, user cohorts, engagement trends, cohort data."
+description: "Perform cohort analysis on user engagement data — retention curves, feature adoption trends, and segment-level insights. Use when analyzing user retention by cohort, studying feature adoption over time, investigating churn patterns, or identifying engagement trends."
 ---
 
 # Cohort Analysis & Retention Explorer

pm-data-analytics/skills/sql-queries/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: sql-queries
-description: "Generate SQL queries from natural language descriptions. Supports BigQuery, PostgreSQL, MySQL, and other SQL dialects. Reads database schemas from uploaded diagrams or documentation. Use when writing SQL queries, analyzing databases, building reports, or exploring data. Triggers: SQL query, write SQL, database query, BigQuery, data report, generate query."
+description: "Generate SQL queries from natural language descriptions. Supports BigQuery, PostgreSQL, MySQL, and other dialects. Reads database schemas from uploaded diagrams or documentation. Use when writing SQL, building data reports, exploring databases, or translating business questions into queries."
 ---
 
 # SQL Query Generator

pm-execution/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "pm-execution",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Execution and product management skills: PRDs, OKRs, roadmaps, sprints, pre-mortems, stakeholder maps, user stories, prioritization frameworks, and more.",
   "author": {
     "name": "Paweł Huryn",

pm-execution/skills/brainstorm-okrs/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: brainstorm-okrs
-description: "Brainstorm team-level OKRs aligned with company objectives. Creates 3 OKR sets with qualitative objectives and quantitative key results. Use when setting quarterly OKRs, aligning team goals with company strategy, or drafting objectives. Triggers: OKRs, objectives key results, team goals, quarterly planning, goal setting."
+description: "Brainstorm team-level OKRs aligned with company objectives — qualitative objectives with measurable key results. Use when setting quarterly OKRs, aligning team goals with company strategy, drafting objectives, or learning how to write effective OKRs."
 ---
 
 # Brainstorm Team OKRs

pm-execution/skills/create-prd/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: create-prd
-description: "Create a Product Requirements Document using a comprehensive 8-section template covering summary, background, objectives, market segments, value propositions, solution details, and release planning. Use when writing a PRD, documenting product requirements, creating a feature spec, or preparing a product brief. Triggers: PRD, product requirements, feature spec, product brief, requirements document."
+description: "Create a Product Requirements Document using a comprehensive 8-section template covering problem, objectives, segments, value propositions, solution, and release planning. Use when writing a PRD, documenting product requirements, preparing a feature spec, or reviewing an existing PRD."
 ---
 
 # Create a Product Requirements Document

pm-execution/skills/dummy-dataset/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: dummy-dataset
-description: "Generate realistic dummy datasets for testing with customizable columns, constraints, and output formats (CSV, JSON, SQL, Python script). Use when creating test data, generating sample datasets, or building realistic mock data for development. Triggers: dummy data, test data, mock dataset, sample data, generate data."
+description: "Generate realistic dummy datasets for testing with customizable columns, constraints, and output formats (CSV, JSON, SQL, Python script). Use when creating test data, building mock datasets, or generating sample data for development and demos."
 ---
 # Dummy Dataset Generation
 

pm-execution/skills/job-stories/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: job-stories
-description: "Create job stories using the 'When [situation], I want to [motivation], so I can [outcome]' format with detailed acceptance criteria. Use when writing job stories, expressing user situations and motivations, or creating JTBD-style backlog items. Triggers: job stories, JTBD story, situation motivation outcome."
+description: "Create job stories using the 'When [situation], I want to [motivation], so I can [outcome]' format with detailed acceptance criteria. Use when writing job stories, creating JTBD-style backlog items, or expressing user situations and motivations."
 ---
 # Job Stories
 

pm-execution/skills/outcome-roadmap/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: outcome-roadmap
-description: "Transform an output-focused roadmap into an outcome-focused one. Rewrites initiatives as outcome statements reflecting user and business impacts. Use when shifting from output to outcome roadmaps, rewriting a feature roadmap, or making a roadmap more strategic. Triggers: outcome roadmap, outcome-focused, rewrite roadmap, strategic roadmap, outcome statements."
+description: "Transform an output-focused roadmap into an outcome-focused one that communicates strategic intent. Rewrites initiatives as outcome statements reflecting user and business impacts. Use when shifting to outcome roadmaps, making a roadmap more strategic, or rewriting feature lists as outcomes."
 ---
 
 # Transform Roadmap to Outcome-Focused Format

pm-execution/skills/pre-mortem/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: pre-mortem
-description: "Run a pre-mortem analysis on a PRD. Categorizes risks as Tigers (real problems), Paper Tigers (overblown concerns), and Elephants (unspoken worries), then classifies Tigers as launch-blocking, fast-follow, or track. Use when preparing for launch, risk-assessing a PRD, or stress-testing a product plan. Triggers: pre-mortem, launch risks, what could go wrong, risk analysis PRD, stress test plan."
+description: "Run a pre-mortem risk analysis on a PRD or launch plan. Categorizes risks as Tigers (real problems), Paper Tigers (overblown concerns), and Elephants (unspoken worries), then classifies as launch-blocking, fast-follow, or track. Use when preparing for launch, stress-testing a product plan, or identifying what could go wrong."
 ---
 
 # Pre-Mortem: Risk Analysis for Product Launch

pm-execution/skills/prioritization-frameworks/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: prioritization-frameworks
-description: "Reference guide to 9 prioritization frameworks with formulas, when-to-use guidance, and templates. Covers Opportunity Score, ICE, RICE, Kano, MoSCoW, and more. Use when selecting a prioritization method, comparing frameworks, or needing formula definitions. Triggers: prioritization framework, which framework, ICE, RICE, opportunity score, Kano, MoSCoW, how to prioritize."
+description: "Reference guide to 9 prioritization frameworks with formulas, when-to-use guidance, and templates — RICE, ICE, Kano, MoSCoW, Opportunity Score, and more. Use when selecting a prioritization method, comparing frameworks like RICE vs ICE, or learning how different prioritization approaches work."
 ---
 
 ## Prioritization Frameworks Reference

pm-execution/skills/release-notes/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: release-notes
-description: "Generate user-facing release notes from tickets, PRDs, or changelogs. Creates clear, engaging summaries organized by category (new features, improvements, fixes). Use when writing release notes, creating changelogs, announcing product updates, or summarizing a release. Triggers: release notes, changelog, what's new, product update, release announcement, ship notes."
+description: "Generate user-facing release notes from tickets, PRDs, or changelogs. Creates clear, engaging summaries organized by category (new features, improvements, fixes). Use when writing release notes, creating changelogs, announcing product updates, or summarizing what shipped."
 ---
 
 ## Release Notes Generator

pm-execution/skills/retro/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: retro
-description: "Facilitate a structured sprint retrospective. Analyzes what went well, what didn't, and generates prioritized action items with owners and deadlines. Use when running a retrospective, reflecting on a sprint, or creating action items from team feedback. Triggers: retro, retrospective, sprint retro, what went well, lessons learned, team reflection."
+description: "Facilitate a structured sprint retrospective — what went well, what didn't, and prioritized action items with owners and deadlines. Use when running a retrospective, reflecting on a sprint, creating action items from team feedback, or learning how to run effective retros."
 ---
 
 ## Sprint Retrospective Facilitator

pm-execution/skills/sprint-plan/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: sprint-plan
-description: "Plan a sprint with capacity estimation, story selection, dependency mapping, and risk identification. Use when preparing for sprint planning, estimating team capacity, selecting stories for a sprint, or balancing sprint scope. Triggers: sprint plan, sprint planning, capacity planning, sprint scope, what fits in the sprint, story points."
+description: "Plan a sprint with capacity estimation, story selection, dependency mapping, and risk identification. Use when preparing for sprint planning, estimating team capacity, selecting stories, or balancing sprint scope against velocity."
 ---
 
 ## Sprint Planning

pm-execution/skills/stakeholder-map/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: stakeholder-map
-description: "Build a stakeholder map using a power/interest grid, identify communication strategies per quadrant, and generate a communication plan. Use when managing stakeholders, preparing for a launch, aligning cross-functional teams, or planning stakeholder engagement. Triggers: stakeholder map, stakeholder analysis, power interest grid, stakeholder management, communication plan, who to align."
+description: "Build a stakeholder map using a power/interest grid, identify communication strategies per quadrant, and generate a communication plan. Use when managing stakeholders, preparing for a launch, aligning cross-functional teams, or planning stakeholder engagement."
 ---
 
 ## Stakeholder Mapping & Communication Plan

pm-execution/skills/summarize-meeting/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: summarize-meeting
-description: "Summarize a meeting transcript into a structured template with date, participants, topic, summary points, and action items. Use when processing meeting recordings, creating meeting notes, or summarizing any internal meeting. Triggers: summarize meeting, meeting notes, meeting summary, meeting minutes, recap meeting."
+description: "Summarize a meeting transcript into structured notes with date, participants, topic, key decisions, summary points, and action items. Use when processing meeting recordings, creating meeting notes, writing meeting minutes, or recapping discussions."
 ---
 
 # Summarize Meeting

pm-execution/skills/test-scenarios/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: test-scenarios
-description: "Create comprehensive test scenarios from user stories with test objectives, starting conditions, user roles, step-by-step actions, and expected outcomes. Use when writing QA test cases, creating test plans, or defining acceptance tests. Triggers: test scenarios, test cases, QA scenarios, acceptance tests."
+description: "Create comprehensive test scenarios from user stories with test objectives, starting conditions, user roles, step-by-step actions, and expected outcomes. Use when writing QA test cases, creating test plans, defining acceptance tests, or preparing for feature validation."
 ---
 # Test Scenarios
 

pm-execution/skills/user-stories/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: user-stories
-description: "Create user stories following the 3 C's (Card, Conversation, Confirmation) and INVEST criteria with descriptions, design links, and acceptance criteria. Use when writing user stories, breaking down features, or creating backlog items. Triggers: user stories, backlog story, acceptance criteria."
+description: "Create user stories following the 3 C's (Card, Conversation, Confirmation) and INVEST criteria with descriptions, design links, and acceptance criteria. Use when writing user stories, breaking down features into backlog items, or defining acceptance criteria."
 ---
 # User Stories
 

pm-execution/skills/wwas/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: wwas
-description: "Create product backlog items in Why-What-Acceptance format. Produces independent, valuable, testable items with strategic context. Use when writing backlog items or breaking features into work items. Triggers: WWA, why what acceptance, backlog items, work items."
+description: "Create product backlog items in Why-What-Acceptance format — independent, valuable, testable items with strategic context. Use when writing structured backlog items, breaking features into work items, or using the WWA format."
 ---
 # Why-What-Acceptance (WWA)
 

pm-go-to-market/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "pm-go-to-market",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Go-to-market skills for PMs: GTM strategy, growth loops, GTM motions, beachhead segments, and ideal customer profiles.",
   "author": {
     "name": "Paweł Huryn",

pm-go-to-market/skills/beachhead-segment/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: beachhead-segment
-description: "Identify the first beachhead market segment for a product launch. Evaluates segments against burning pain, willingness to pay, winnable market share, and referral potential. Triggers: beachhead segment, first market, initial target, market entry."
+description: "Identify the first beachhead market segment for a product launch. Evaluates segments against burning pain, willingness to pay, winnable market share, and referral potential. Use when choosing a first market, targeting an initial customer segment, or planning market entry strategy."
 ---
 # Beachhead Segment
 

pm-go-to-market/skills/competitive-battlecard/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: competitive-battlecard
-description: "Create sales-ready competitive battlecards comparing your product against a specific competitor. Includes positioning, feature comparison, objection handling, and win/loss patterns. Use when preparing sales teams, creating competitive materials, or responding to 'why not competitor X?' Triggers: battlecard, competitive battlecard, sales enablement, vs competitor, why us not them, competitive comparison."
+description: "Create sales-ready competitive battlecards comparing your product against a specific competitor — positioning, feature comparison, objection handling, and win/loss patterns. Use when preparing sales teams, creating competitive materials, or responding to 'why not competitor X?'"
 ---
 
 ## Competitive Battlecard

pm-go-to-market/skills/growth-loops/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: growth-loops
-description: "Identify growth loops (flywheels) for sustainable traction. Evaluates 5 loop types: Viral, Usage, Collaboration, User-Generated, and Referral. Use for designing growth mechanisms or building product-led traction. Triggers: growth loops, flywheel, viral loop, referral loop."
+description: "Identify growth loops (flywheels) for sustainable traction. Evaluates 5 loop types: Viral, Usage, Collaboration, User-Generated, and Referral. Use when designing growth mechanisms, building product-led traction, or understanding how growth loops work."
 ---
 # Growth Loops
 

pm-go-to-market/skills/gtm-motions/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: gtm-motions
-description: "Identify the best GTM motions and tools. Evaluates 7 motion types: Inbound, Outbound, Paid Digital, Community, Partners, ABM, and PLG with specific tool recommendations. Triggers: GTM motions, marketing channels, inbound outbound, PLG."
+description: "Identify the best GTM motions and tools across 7 motion types: Inbound, Outbound, Paid Digital, Community, Partners, ABM, and PLG. Use when selecting marketing channels, choosing between inbound and outbound strategy, or planning cross-channel campaigns."
 ---
 # GTM Motions
 

pm-go-to-market/skills/gtm-strategy/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: gtm-strategy
-description: "Create a go-to-market strategy for a product launch covering marketing channels, messaging, success metrics, and launch plan. Triggers: GTM strategy, go-to-market, launch plan, product launch, market entry."
+description: "Create a go-to-market strategy covering marketing channels, messaging, success metrics, and launch timeline. Use when planning a product launch, creating a GTM plan from scratch, or defining a launch strategy for a new market."
 ---
 # GTM Strategy
 

pm-go-to-market/skills/ideal-customer-profile/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: ideal-customer-profile
-description: "Identify the Ideal Customer Profile (ICP) from research data with demographics, behaviors, JTBD, and needs. Use when defining ICP or analyzing PMF survey data. Triggers: ICP, ideal customer profile, best customer, PMF survey."
+description: "Identify the Ideal Customer Profile (ICP) from research data with demographics, behaviors, JTBD, and needs. Use when defining your ICP, analyzing PMF survey data, or understanding who your best customers are."
 ---
 # Ideal Customer Profile
 

pm-market-research/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "pm-market-research",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Market research skills for PMs: user personas, market segmentation, sentiment analysis, and competitive analysis.",
   "author": {
     "name": "Paweł Huryn",

pm-market-research/skills/competitor-analysis/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: competitor-analysis
-description: "Analyze competitors with strengths, weaknesses, and differentiation opportunities. Identifies 5 direct competitors and maps the competitive landscape. Use when doing competitive research, preparing a competitive brief, or finding differentiation opportunities. Triggers: competitor analysis, competitive landscape, who are our competitors, competitive research, differentiation."
+description: "Analyze competitors with strengths, weaknesses, and differentiation opportunities. Identifies direct competitors and maps the competitive landscape. Use when doing competitive research, preparing a competitive brief, or finding differentiation opportunities."
 ---
 
 # Competitor Analysis

pm-market-research/skills/customer-journey-map/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: customer-journey-map
-description: "Create an end-to-end customer journey map with stages, touchpoints, emotions, pain points, and opportunities. Use when mapping the customer experience, identifying friction points, improving onboarding, or visualizing the user journey. Triggers: customer journey, journey map, user journey, touchpoint map, experience map, onboarding flow, customer experience."
+description: "Create an end-to-end customer journey map with stages, touchpoints, emotions, pain points, and opportunities. Use when mapping the customer experience, identifying friction points, improving onboarding, or visualizing the user journey."
 ---
 
 ## Customer Journey Map

pm-market-research/skills/market-segments/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: market-segments
-description: "Identify 3-5 potential customer segments with demographics, JTBD, and product fit analysis. Use when exploring market segments, identifying target audiences, or evaluating new markets. Triggers: market segments, customer segments, target audience, market segmentation, who to target."
+description: "Identify 3-5 potential customer segments with demographics, JTBD, and product fit analysis. Use when exploring market segments, identifying target audiences, evaluating new markets, or learning how to segment a market."
 ---
 
 # Market Segments

pm-market-research/skills/market-sizing/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: market-sizing
-description: "Estimate market size using TAM, SAM, and SOM with top-down and bottom-up approaches. Use when sizing a market opportunity, estimating addressable market, preparing for investor pitches, or evaluating market entry. Triggers: market size, TAM SAM SOM, addressable market, market opportunity, how big is the market, market estimation."
+description: "Estimate market size using TAM, SAM, and SOM with top-down and bottom-up approaches. Use when sizing a market opportunity, estimating addressable market, preparing for investor pitches, or evaluating market entry."
 ---
 
 # Estimate Market Size (TAM, SAM, SOM)

pm-market-research/skills/sentiment-analysis/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: sentiment-analysis
-description: "Analyze user feedback data to identify market segments with sentiment scores, JTBD, and product satisfaction insights. Use when analyzing user feedback at scale, running sentiment analysis on reviews or surveys, or identifying user satisfaction patterns. Triggers: sentiment analysis, analyze feedback, user satisfaction, NPS analysis, review analysis."
+description: "Analyze user feedback data to identify segments with sentiment scores, JTBD, and product satisfaction insights. Use when analyzing user feedback at scale, running sentiment analysis on reviews or surveys, or identifying satisfaction patterns."
 ---
 
 # Sentiment Analysis

pm-market-research/skills/user-personas/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: user-personas
-description: "Create refined user personas from research data. Generates 3 personas with JTBD, pains, gains, and unexpected insights. Use when building personas from survey data, creating user profiles from research, or segmenting users for product decisions. Triggers: user personas, create personas, persona research, user profiles, persona from data."
+description: "Create refined user personas from research data — 3 personas with JTBD, pains, gains, and unexpected insights. Use when building personas from survey data, creating user profiles from research, or segmenting users for product decisions."
 ---
 
 # User Personas

pm-market-research/skills/user-segmentation/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: user-segmentation
-description: "Segment users from feedback data based on behavior, JTBD, and needs. Identifies at least 3 distinct user segments. Use when segmenting a user base, analyzing diverse user feedback, or building a segmentation model. Triggers: user segmentation, segment users, behavioral segments, user groups, feedback segmentation."
+description: "Segment users from feedback data based on behavior, JTBD, and needs. Identifies at least 3 distinct user segments. Use when segmenting a user base, analyzing diverse user feedback, or building a segmentation model."
 ---
 
 # User Segmentation

pm-marketing-growth/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "pm-marketing-growth",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Product marketing and growth skills: marketing ideas, value proposition statements, North Star metrics, product naming, and positioning.",
   "author": {
     "name": "Paweł Huryn",

pm-marketing-growth/skills/marketing-ideas/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: marketing-ideas
-description: "Generate 5 creative, cost-effective marketing ideas with channels, messaging, and engagement rationale. Use when brainstorming marketing campaigns or planning product promotion. Triggers: marketing ideas, promote product, marketing campaign."
+description: "Generate 5 creative, cost-effective marketing ideas with channels, messaging, and engagement rationale. Use when brainstorming marketing campaigns, planning product promotion, or looking for creative marketing tactics."
 ---
 # Marketing Ideas
 

pm-marketing-growth/skills/north-star-metric/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: north-star-metric
-description: "Identify a North Star Metric and 3-5 Input Metrics. Classifies the business game (Attention, Transaction, Productivity) and validates against 7 criteria. Triggers: North Star metric, key metric, what to measure, metrics framework."
+description: "Define a North Star Metric and 3-5 supporting input metrics that form a metrics constellation. Classify the business game (Attention, Transaction, Productivity) and validate against 7 criteria for an effective North Star. Use when choosing a North Star Metric, setting up a metrics framework, learning about the North Star Framework, or deciding what to measure."
 ---
 # North Star Metric
 

pm-marketing-growth/skills/positioning-ideas/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: positioning-ideas
-description: "Brainstorm product positioning ideas differentiated from competitors. Identifies top 5 competitors and generates positioning statements with rationale. Triggers: positioning, brand positioning, differentiation, positioning statement."
+description: "Brainstorm product positioning ideas differentiated from competitors. Identifies top competitors and generates positioning statements with rationale. Use when developing product positioning, differentiating from competitors, or crafting brand positioning strategy."
 ---
 # Positioning Ideas
 

pm-marketing-growth/skills/product-name/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: product-name
-description: "Brainstorm 5 unique, memorable product names with rationale aligned to brand values and target audience. Use when naming a new product or rebranding. Triggers: product name, name ideas, brand name, naming."
+description: "Brainstorm 5 unique, memorable product names with rationale aligned to brand values and target audience. Use when naming a new product, rebranding, or exploring product name ideas."
 ---
 # Product Name
 

pm-marketing-growth/skills/value-prop-statements/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: value-prop-statements
-description: "Generate value proposition statements for marketing, sales, and onboarding from existing value propositions. Triggers: value proposition statements, marketing copy, sales messaging, value statements."
+description: "Generate value proposition statements for marketing, sales, and onboarding from existing value propositions. Use when writing marketing copy, creating sales messaging, or crafting onboarding messages."
 ---
 # Value Proposition Statements
 

pm-product-discovery/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "pm-product-discovery",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Product discovery skills for PMs: ideation, experiments, assumption testing, feature prioritization, and customer interview synthesis.",
   "author": {
     "name": "Paweł Huryn",

pm-product-discovery/skills/analyze-feature-requests/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: analyze-feature-requests
-description: "Analyze and prioritize a list of feature requests by theme, strategic alignment, impact, effort, and risk. Use when reviewing customer feature requests, triaging a backlog, or making prioritization decisions. Triggers: analyze feature requests, prioritize features, triage backlog, feature request analysis, customer requests."
+description: "Analyze and prioritize a list of feature requests by theme, strategic alignment, impact, effort, and risk. Use when reviewing customer feature requests, triaging a backlog, or making prioritization decisions."
 ---
 
 ## Analyze Feature Requests

pm-product-discovery/skills/brainstorm-experiments-existing/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: brainstorm-experiments-existing
-description: "Design experiments to test assumptions for an existing product. Suggests prototypes, A/B tests, spikes, and other low-effort validation methods. Use when you have assumptions to validate, need experiment ideas before full implementation, or want to test a feature idea cheaply. Triggers: experiment design, test assumptions, validate idea, prototype test, A/B test ideas."
+description: "Design experiments to test assumptions for an existing product — prototypes, A/B tests, spikes, and other low-effort validation methods. Use when validating assumptions, testing feature ideas cheaply, or planning product experiments."
 ---
 
 ## Design Experiments (Existing Product)

pm-product-discovery/skills/brainstorm-experiments-new/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: brainstorm-experiments-new
-description: "Design lean startup experiments (pretotypes) for a new product. Creates XYZ hypotheses and suggests low-effort validation methods like landing pages, explainer videos, and pre-orders. Use when validating a new product idea, creating pretotypes, or testing market demand. Triggers: lean startup experiment, pretotype, XYZ hypothesis, validate new product, test market demand."
+description: "Design lean startup experiments (pretotypes) for a new product. Creates XYZ hypotheses and suggests low-effort validation methods like landing pages, explainer videos, and pre-orders. Use when validating a new product idea, creating pretotypes, or testing market demand."
 ---
 
 ## Design Lean Startup Experiments (New Product)

pm-product-discovery/skills/brainstorm-ideas-existing/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: brainstorm-ideas-existing
-description: "Brainstorm product ideas for an existing product using multi-perspective ideation (PM, Designer, Engineer). Use when a PM wants to generate new feature ideas, brainstorm solutions for an identified opportunity, or ideate with a product trio. Triggers: brainstorm ideas, ideate features, new ideas existing product, product trio ideation, feature brainstorm."
+description: "Brainstorm product ideas for an existing product using multi-perspective ideation from PM, Designer, and Engineer viewpoints. Use when generating new feature ideas, brainstorming solutions for an identified opportunity, or ideating with a product trio."
 ---
 
 ## Brainstorm Product Ideas (Existing Product)

pm-product-discovery/skills/brainstorm-ideas-new/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: brainstorm-ideas-new
-description: "Brainstorm feature ideas for a new product in initial discovery. Generates ideas from PM, Designer, and Engineer perspectives. Use when starting product discovery for a new product, exploring features for a startup idea, or doing initial ideation. Triggers: new product ideas, startup features, initial discovery, new product brainstorm."
+description: "Brainstorm feature ideas for a new product in initial discovery from PM, Designer, and Engineer perspectives. Use when starting product discovery for a new product, exploring features for a startup idea, or doing initial ideation."
 ---
 
 ## Brainstorm Product Ideas (New Product)

pm-product-discovery/skills/identify-assumptions-existing/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: identify-assumptions-existing
-description: "Identify risky assumptions for a feature idea in an existing product across Value, Usability, Viability, and Feasibility. Uses multi-perspective devil's advocate thinking. Use when stress-testing a feature idea, doing risk assessment, or preparing for assumption mapping. Triggers: identify assumptions, risk assessment, devil's advocate, assumption mapping, feature risks, what could go wrong."
+description: "Identify risky assumptions for a feature idea in an existing product across Value, Usability, Viability, and Feasibility. Uses multi-perspective devil's advocate thinking. Use when stress-testing a feature idea, doing risk assessment, or preparing for assumption mapping."
 ---
 
 ## Identify Assumptions (Existing Product)

pm-product-discovery/skills/identify-assumptions-new/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: identify-assumptions-new
-description: "Identify risky assumptions for a new product idea across 8 risk categories including Go-to-Market, Strategy, and Team. Uses multi-perspective analysis. Use when launching a new product, evaluating startup risks, or assessing a new product concept. Triggers: new product risks, startup assumptions, GTM risk, launch risk assessment, new product viability."
+description: "Identify risky assumptions for a new product idea across 8 risk categories including Go-to-Market, Strategy, and Team. Use when evaluating startup risks, assessing a new product concept, or mapping assumptions for a new venture."
 ---
 
 ## Identify Assumptions (New Product)

pm-product-discovery/skills/interview-script/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: interview-script
-description: "Create a structured customer interview script with JTBD probing questions, warm-up, core exploration, and wrap-up sections. Follows 'The Mom Test' principles — no leading questions, no pitching, focus on past behavior. Use when preparing for user interviews, creating interview guides, or planning discovery research. Triggers: interview script, interview guide, user interview questions, discovery interview, customer interview prep, how to interview users."
+description: "Create a structured customer interview script with JTBD probing questions, warm-up, core exploration, and wrap-up sections. Follows The Mom Test principles — no leading questions, no pitching, focus on past behavior. Use when preparing for user interviews, creating interview guides, or planning discovery research."
 ---
 
 ## Customer Interview Script

pm-product-discovery/skills/metrics-dashboard/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: metrics-dashboard
-description: "Define and design a product metrics dashboard with key metrics, data sources, visualization types, and alert thresholds. Use when creating a metrics dashboard, defining KPIs, setting up product analytics, or building a data monitoring plan. Triggers: metrics dashboard, product dashboard, KPI dashboard, analytics setup, what to track, product metrics, monitoring."
+description: "Define and design a product metrics dashboard with key metrics, data sources, visualization types, and alert thresholds. Use when creating a metrics dashboard, defining KPIs, setting up product analytics, or building a data monitoring plan."
 ---
 
 ## Product Metrics Dashboard

pm-product-discovery/skills/opportunity-solution-tree/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: opportunity-solution-tree
-description: "Build an Opportunity Solution Tree (OST) to structure product discovery — map a desired outcome to opportunities, solutions, and experiments. Based on Teresa Torres' Continuous Discovery Habits. Use when structuring discovery work, mapping customer opportunities to solutions, or deciding what to build next. Triggers: opportunity solution tree, OST, discovery tree, Teresa Torres, opportunity mapping, what to build next."
+description: "Build an Opportunity Solution Tree (OST) to structure product discovery — map a desired outcome to opportunities, solutions, and experiments. Based on Teresa Torres' Continuous Discovery Habits. Use when structuring discovery work, mapping opportunities to solutions, or deciding what to build next."
 ---
 
 ## Opportunity Solution Tree (OST)

pm-product-discovery/skills/prioritize-assumptions/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: prioritize-assumptions
-description: "Prioritize assumptions using an Impact × Risk matrix and suggest experiments for each. Use when you have a list of assumptions to triage, need to decide what to test first, or want to apply assumption prioritization canvas. Triggers: prioritize assumptions, assumption matrix, what to test first, risk assessment, assumption canvas."
+description: "Prioritize assumptions using an Impact × Risk matrix and suggest experiments for each. Use when triaging a list of assumptions, deciding what to test first, or applying the assumption prioritization canvas."
 ---
 
 ## Prioritize Assumptions

pm-product-discovery/skills/prioritize-features/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: prioritize-features
-description: "Prioritize a backlog of feature ideas based on impact, effort, risk, and strategic alignment. Recommends top 5 features with rationale. Use when prioritizing a feature backlog, making scope decisions, or ranking product ideas. Triggers: prioritize features, feature ranking, backlog prioritization, which features first, scope decision."
+description: "Prioritize a backlog of feature ideas based on impact, effort, risk, and strategic alignment with top 5 recommendations. Use when prioritizing a feature backlog, making scope decisions, or ranking product ideas."
 ---
 
 ## Prioritize Feature Backlog

pm-product-discovery/skills/summarize-interview/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: summarize-interview
-description: "Summarize a customer interview transcript into a structured template with JTBD, satisfaction signals, and action items. Use when processing customer interview recordings or transcripts, synthesizing discovery interviews, or creating interview summaries. Triggers: summarize interview, customer interview notes, interview summary, discovery interview, user interview."
+description: "Summarize a customer interview transcript into a structured template with JTBD, satisfaction signals, and action items. Use when processing interview recordings or transcripts, synthesizing discovery interviews, or creating interview summaries."
 ---
 
 ## Summarize Customer Interview

pm-product-strategy/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "pm-product-strategy",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Product strategy skills for PMs: vision, strategy canvas, value propositions, lean canvas, business model canvas, SWOT, PESTLE, Ansoff Matrix, Porter's Five Forces, and monetization.",
   "author": {
     "name": "Paweł Huryn",

pm-product-strategy/skills/ansoff-matrix/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: ansoff-matrix
-description: "Generate an Ansoff Matrix analysis mapping growth strategies across market penetration, market development, product development, and diversification. Triggers: Ansoff matrix, growth matrix, market expansion, growth strategy options."
+description: "Generate an Ansoff Matrix analysis mapping growth strategies across market penetration, market development, product development, and diversification. Use when considering growth options, planning market expansion, or evaluating strategic growth paths."
 ---
 # Ansoff Matrix
 

pm-product-strategy/skills/business-model/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: business-model
-description: "Generate a Business Model Canvas with all 9 building blocks. Use when creating a business model or analyzing how a business creates value. Triggers: business model canvas, BMC, business model."
+description: "Generate a Business Model Canvas with all 9 building blocks. Use when creating a business model, documenting how a business creates value, or analyzing an existing business model."
 ---
 # Business Model Canvas
 

pm-product-strategy/skills/lean-canvas/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: lean-canvas
-description: "Generate a Lean Canvas business model with sections for problem, solution, metrics, cost structure, UVP, unfair advantage, channels, segments, and revenue. Triggers: lean canvas, startup canvas, business hypothesis."
+description: "Generate a Lean Canvas with problem, solution, metrics, cost structure, UVP, unfair advantage, channels, segments, and revenue. Use when exploring a lean startup canvas, testing a business hypothesis, or modeling a new venture."
 ---
 # Lean Canvas
 

pm-product-strategy/skills/monetization-strategy/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: monetization-strategy
-description: "Brainstorm 3-5 monetization strategies with audience fit, risks, and validation experiments. Use when exploring revenue models or pricing strategies. Triggers: monetization strategy, revenue model, pricing strategy, how to monetize."
+description: "Brainstorm 3-5 monetization strategies with audience fit, risks, and validation experiments. Use when exploring revenue models, evaluating pricing strategies, or deciding how to monetize a product."
 ---
 # Monetization Strategy
 

pm-product-strategy/skills/pestle-analysis/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: pestle-analysis
-description: "Perform a PESTLE analysis covering Political, Economic, Social, Technological, Legal, and Environmental factors. Use for macro-environment assessment or strategic planning. Triggers: PESTLE analysis, macro environment, external factors."
+description: "Perform a PESTLE analysis covering Political, Economic, Social, Technological, Legal, and Environmental factors. Use when assessing the macro environment, doing strategic planning, or evaluating external factors affecting your business."
 ---
 # PESTLE Analysis
 

pm-product-strategy/skills/porters-five-forces/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: porters-five-forces
-description: "Perform Porter's Five Forces analysis evaluating competitive rivalry, supplier power, buyer power, threat of substitutes, and threat of new entrants. Triggers: Porter's five forces, competitive forces, industry analysis."
+description: "Perform Porter's Five Forces analysis — competitive rivalry, supplier power, buyer power, threat of substitutes, and threat of new entrants. Use when analyzing industry dynamics, assessing competitive forces, or evaluating market attractiveness."
 ---
 # Porter's Five Forces
 

pm-product-strategy/skills/pricing-strategy/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: pricing-strategy
-description: "Analyze and design pricing strategies including pricing models, competitive pricing analysis, willingness-to-pay estimation, and price elasticity considerations. Use when setting prices, evaluating pricing models, preparing for a pricing change, or analyzing competitive pricing. Triggers: pricing strategy, pricing model, how to price, pricing analysis, willingness to pay, price point, freemium vs paid."
+description: "Analyze and design pricing strategies including pricing models, competitive pricing analysis, willingness-to-pay estimation, and price elasticity. Use when setting prices, evaluating pricing models, preparing for a pricing change, or comparing freemium vs paid approaches."
 ---
 
 ## Pricing Strategy

pm-product-strategy/skills/product-strategy/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: product-strategy
-description: "Generate a comprehensive product strategy using the 9-section Product Strategy Canvas covering vision, segments, costs, value propositions, trade-offs, metrics, growth, capabilities, and defensibility. Triggers: product strategy, strategy canvas, strategic plan."
+description: "Create a comprehensive product strategy using the 9-section Product Strategy Canvas — vision, segments, costs, value propositions, trade-offs, metrics, growth, capabilities, and defensibility. Use when building a product strategy, creating a strategic plan, or defining product direction."
 ---
 # Product Strategy Canvas
 

pm-product-strategy/skills/product-vision/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: product-vision
-description: "Brainstorm an inspiring, achievable, and emotional product vision that motivates teams. Use when defining or refining product vision. Triggers: product vision, vision statement, create vision, inspiring vision."
+description: "Brainstorm an inspiring, achievable, and emotional product vision that motivates teams and aligns stakeholders. Use when defining or refining a product vision, creating a vision statement, or aligning the team around a shared direction."
 ---
 # Product Vision
 

pm-product-strategy/skills/startup-canvas/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: startup-canvas
-description: "Generate a Startup Canvas combining Product Strategy (9 sections) and Business Model (Cost Structure + Revenue Streams) for a new product. An alternative to Business Model Canvas and Lean Canvas that separates strategy from business model. Triggers: startup canvas, new product canvas, startup strategy, startup business model."
+description: "Generate a Startup Canvas combining Product Strategy (9 sections) and Business Model (costs + revenue) for a new product. An alternative to BMC and Lean Canvas that separates strategy from business model. Use when launching a new product or evaluating a startup concept."
 ---
 # Startup Canvas
 

pm-product-strategy/skills/swot-analysis/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: swot-analysis
-description: "Perform a detailed SWOT analysis identifying strengths, weaknesses, opportunities, and threats with actionable recommendations. Triggers: SWOT analysis, strengths weaknesses, strategic assessment."
+description: "Perform a detailed SWOT analysis — strengths, weaknesses, opportunities, and threats with actionable recommendations. Use when doing strategic assessment, competitive analysis, or evaluating a product or business position."
 ---
 # SWOT Analysis
 

pm-product-strategy/skills/value-proposition/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: value-proposition
-description: "Generate a detailed value proposition using a 6-part JTBD template (Who, Why, What before, How, What after, Alternatives). Triggers: value proposition, value prop, customer value, JTBD value."
+description: "Design a detailed value proposition using a 6-part JTBD template — Who, Why, What before, How, What after, Alternatives. Use when creating a value proposition, analyzing customer value delivery, or articulating why customers should choose your product."
 ---
 # Value Proposition
 

pm-toolkit/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "pm-toolkit",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "PM utility skills: resume review, NDA drafting, privacy policy generation, and grammar/flow checking. Essential tools for product managers beyond core product work.",
   "author": {
     "name": "Paweł Huryn",

pm-toolkit/skills/draft-nda/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: draft-nda
-description: "Draft a detailed Non-Disclosure Agreement between two parties. Covers information types, jurisdiction, and highlights clauses needing legal review. Triggers: NDA, non-disclosure agreement, confidentiality agreement."
+description: "Draft a detailed Non-Disclosure Agreement between two parties covering information types, jurisdiction, and clauses needing legal review. Use when creating confidentiality agreements or preparing an NDA for a partnership."
 ---
 # NDA (Non-Disclosure Agreement) Drafting
 

pm-toolkit/skills/grammar-check/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: grammar-check
-description: "Identify grammar, logical, and flow errors in text and suggest targeted fixes without rewriting the entire text. Use when proofreading content or checking writing quality. Triggers: grammar check, proofread, check my writing, fix grammar."
+description: "Identify grammar, logical, and flow errors in text and suggest targeted fixes without rewriting the entire text. Use when proofreading content, checking writing quality, or reviewing a draft."
 ---
 # Grammar and Flow Checking
 

pm-toolkit/skills/privacy-policy/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: privacy-policy
-description: "Draft a detailed privacy policy for a product covering data types, jurisdiction, compliance considerations, and clauses needing legal review. Triggers: privacy policy, data policy, GDPR, data protection."
+description: "Draft a detailed privacy policy covering data types, jurisdiction, GDPR and compliance considerations, and clauses needing legal review. Use when creating a privacy policy, updating data protection documentation, or preparing for compliance."
 ---
 # Privacy Policy Generator
 

pm-toolkit/skills/review-resume/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: review-resume
-description: "Comprehensive PM resume review and tailoring against 10 best practices including XYZ+S formula, keyword optimization, job-specific tailoring, and structure. Provides personalized, actionable feedback with specific examples. Triggers: review resume, resume feedback, resume review, check my resume, adjust resume, tailor resume, resume for job, customize resume, resume optimization."
+description: "Comprehensive PM resume review and tailoring against 10 best practices including XYZ+S formula, keyword optimization, job-specific tailoring, and structure. Use when reviewing a PM resume, preparing for job applications, or improving resume impact."
 ---
 # Resume Review for Product Managers