plugins/jira/skills/create-feature/SKILL.md
Implementation guide for creating Jira features representing strategic objectives and market problems
npx skillsauth add openshift-eng/ai-helpers create-featureInstall 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.
This skill provides implementation guidance for creating Jira features, which represent high-level strategic objectives and solutions to market problems.
This skill is automatically invoked by the /jira:create feature command to guide the feature creation process.
Reference Documentation:
| Field | ID | Type | Usage |
|-------|------|------|-------|
| Target Version | customfield_10855 | Array | Format: [{"id": "VERSION_ID"}] |
Every feature should clearly state:
Good example:
## Market Problem
Enterprise customers managing multiple ROSA HCP clusters (10+) struggle with operational visibility and control. They must navigate between separate dashboards for each cluster, making it difficult to:
- Identify issues across their cluster fleet
- Track resource utilization trends
- Respond quickly to incidents
- Optimize costs across clusters
This leads to increased operational overhead, slower incident response, and higher support costs. Without a unified observability solution, customers face scalability challenges as their cluster count grows.
Bad example:
We need better observability.
Explain why this feature matters to the business:
Example:
## Strategic Value
### Customer Value
- 60% reduction in time spent on cluster management
- Faster incident detection and response (10min → 2min)
- Better resource optimization across cluster fleet
- Improved operational confidence at scale
### Business Impact
- Supports enterprise expansion (critical for deals >100 clusters)
- Reduces support burden (fewer escalations, faster resolution)
- Competitive differentiator (no competitor offers unified HCP observability)
- Enables upsell opportunities (advanced monitoring add-ons)
### Strategic Alignment
- Aligns with "Enterprise-First" product strategy for FY2025
- Prerequisite for multi-cluster management capabilities in roadmap
- Supports OpenShift Hybrid Cloud Platform vision
Define how you'll measure success (not just completion):
Example:
## Success Criteria
### Adoption
- 50% of customers with 10+ clusters adopt within 6 months of GA
- Feature enabled by default for new cluster deployments
### Usage
- Average of 5 dashboard views per day per customer
- Alert configuration adoption >30% of customers
- API usage growing 20% month-over-month
### Outcomes
- 40% reduction in time-to-detect incidents (measured via support metrics)
- Customer satisfaction (CSAT) improvement from 7.2 to 8.5 for multi-cluster users
- 25% reduction in cluster management support tickets
### Business
- Closes 10+ enterprise deals blocked by observability gap
- Reduces support costs by $200K annually
- Enables $500K in advanced monitoring upsell revenue
When creating a feature, guide the user through strategic thinking:
Prompt: "What customer or market problem does this feature solve? Be specific about who is affected and why it matters."
Probing questions:
Example response:
Enterprise customers with large ROSA HCP deployments (50+ clusters) struggle with operational visibility. They must manage each cluster separately, leading to slow incident response, difficulty tracking compliance, and high operational overhead. This is blocking large enterprise deals and causing customer escalations.
Prompt: "How will this feature solve the problem? What capability will be delivered?"
Example response:
Deliver a unified observability platform for ROSA HCP that aggregates metrics, logs, and events across all clusters in a customer's fleet. Provide centralized dashboards, fleet-wide alerting, and compliance reporting.
Prompt: "Why is this strategically important? What business value does it deliver?"
Helpful questions:
Example response:
Customer value: 50% reduction in cluster management time
Business impact: Unblocks $5M in enterprise deals, reduces support costs
Competitive advantage: No competitor offers unified HCP observability
Strategic alignment: Critical for enterprise market expansion
Prompt: "How will you measure success? What metrics will tell you this feature achieved its goals?"
Categories to consider:
Example response:
Adoption: 50% of enterprise customers within 6 months
Usage: Daily active usage by SREs in 80% of adopting customers
Outcomes: 40% faster incident detection
Business: Closes 15+ blocked enterprise deals
Prompt: "What are the major components or epics within this feature?"
Identify 3-8 major work streams:
Example response:
1. Multi-cluster metrics aggregation
2. Unified observability dashboard
3. Fleet-wide alerting and automation
4. Compliance and audit reporting
5. API and CLI for programmatic access
6. Documentation and enablement
Prompt: "What is the timeline? What are key milestones?"
Example response:
Timeline: 9 months (3 releases)
Milestones:
- Q1 2025: MVP metrics aggregation (Epic 1)
- Q2 2025: Dashboard and alerting (Epics 2-3)
- Q3 2025: Compliance, API, GA (Epics 4-6)
Before submitting the feature, validate:
Create features via createJiraIssue with contentFormat: "markdown". Key parameters:
projectKey: e.g., "CNTRLPLANE"issueTypeName: "Feature"summary: feature summarydescription: formatted feature template (Markdown) with Market Problem, Strategic Value, Success Criteria, Scope, Timeline sectionsadditional_fields: include "labels": ["ai-generated-jira"], "security": {"name": "Red Hat Employee"}, and target version when specifiedUse Markdown formatting with contentFormat: "markdown":
<Brief feature overview>
## Market Problem
<Detailed description of customer/business problem>
<Who is affected, what pain they experience, impact of not solving>
## Proposed Solution
<Description of the capability/solution being delivered>
## Strategic Value
### Customer Value
- <Benefit 1>
- <Benefit 2>
### Business Impact
- <Impact 1>
- <Impact 2>
### Competitive Advantage
<How this differentiates us>
### Strategic Alignment
<How this supports product/company strategy>
## Success Criteria
### Adoption
- <Adoption metrics>
### Usage
- <Usage metrics>
### Outcomes
- <Customer outcome metrics>
### Business Metrics
- <Revenue, cost, satisfaction metrics>
## Scope
### Epics (Planned)
- Epic 1: <name>
- Epic 2: <name>
- Epic 3: <name>
### Out of Scope
- <Related work NOT in this feature>
## Timeline
- Total duration: <timeframe>
- Target GA: <date/release>
### Milestones
- <Quarter/Release>: <deliverable>
- <Quarter/Release>: <deliverable>
## Dependencies (if any)
- PROJ-XXX - <dependency description>
## Risks and Mitigation (optional)
### Risks
- <Risk 1>
- <Risk 2>
### Mitigation
- <Mitigation strategy 1>
- <Mitigation strategy 2>
Scenario: Feature could be accomplished as a single epic.
Action:
Example:
This feature seems small enough to be a single Epic (1-2 months, single capability).
Features should typically:
- Contain 3-8 epics
- Span multiple releases (6-12 months)
- Address strategic market problem
Would you like to create this as an Epic instead? (yes/no)
Scenario: User doesn't provide market problem or strategic value.
Action:
Example:
For a feature, we need to understand the strategic context:
1. What market problem does this solve?
2. Why is this strategically important to the business?
3. What value do customers get?
These help stakeholders understand why we're investing in this feature.
Let's start with: What customer problem does this solve?
Scenario: Success criteria are vague or not measurable.
Action:
Example:
Success criteria should be measurable. "Feature is successful" is too vague.
Instead, consider metrics like:
- Adoption: "50% of enterprise customers within 6 months"
- Usage: "10+ daily dashboard views per customer"
- Outcomes: "40% faster incident response time"
- Business: "Close 10 blocked deals worth $3M"
What specific metrics would indicate success for this feature?
Scenario: User doesn't identify component epics.
Action:
Example:
Features are typically delivered through 3-8 epics. What are the major components or work streams?
For observability, typical epics might be:
1. Metrics collection infrastructure
2. Dashboard and visualization
3. Alerting system
4. Reporting capabilities
5. API development
6. Documentation
What would be the major components for your feature?
Scenario: Sensitive data detected in feature content.
Action:
Example:
I detected confidential business information (customer names, revenue figures).
If this is a public Jira project, please sanitize:
- Use "Enterprise Customer A" instead of actual customer names
- Use ranges ($1-5M) instead of exact revenue figures
Scenario: MCP tool returns an error when creating the feature.
Action:
Common errors:
Input:
/jira:create feature CNTRLPLANE "Advanced hosted control plane observability"
Interactive prompts collect:
Result:
Input:
/jira:create feature CNTRLPLANE "Multi-cloud cost optimization for ROSA and ARO HCP"
Auto-detected:
Result:
❌ Feature is actually an epic
"Multi-cluster dashboard" (single capability, 1 epic)
✅ Too small, create as Epic
❌ No strategic context
"Build monitoring system"
✅ Must explain market problem and business value
❌ Vague success criteria
"Feature is successful when customers like it"
✅ Use measurable metrics: "50% adoption, 8.5 CSAT score, $2M revenue"
❌ Technical implementation as feature
"Migrate to Kubernetes operator pattern"
✅ Technical work should be epic/task. Features describe customer-facing value.
/jira:create - Main command that invokes this skillcreate-epic skill - For epics within featurescntrlplane skill - CNTRLPLANE specific conventionsresearch
Shared engine for analyzing Jira issue activity and generating status summaries
testing
Snapshot OpenShift payload data (release controller, PR diffs, comments, CI jobs, JUnit results, regression tracking) to a local directory for offline analysis
development
Analyze a payload snapshot to identify root causes of blocking job failures, score candidate PRs, and produce an HTML report with revert recommendations
tools
Create TRT JIRA bugs, open revert PRs, and trigger payload jobs for high-confidence revert candidates