Add feature-refinement skill for Red Hat AI product feature planning

skills/feature-refinement/INSTALLATION.md

@@ -0,0 +1,194 @@
+# Feature Refinement Skill - Installation Guide
+
+## Overview
+
+This directory contains a complete Anthropic skill for guiding users through the Red Hat AI feature refinement process.
+
+## Skill Structure
+
+```
+.claude/skills/feature-refinement/
+├── SKILL.md          # Main skill definition (required)
+├── REFERENCE.md      # Complete template reference
+├── TEMPLATE.md       # Blank template for document generation
+└── README.md         # Usage documentation
+```
+
+## Installation Options
+
+### Option 1: Project-Specific Installation (Recommended for Teams)
+
+The skill is already set up in this project at `.claude/skills/feature-refinement/`.
+
+To use it in your project:
+
+1. **Copy to your project:**
+   ```bash
+   cp -r .claude /path/to/your/project/
+   ```
+
+2. **Commit to version control:**
+   ```bash
+   git add .claude/skills/feature-refinement/
+   git commit -m "Add feature refinement skill"
+   ```
+
+This makes the skill available to anyone working on the project.
+
+### Option 2: Personal Installation (Available Across All Projects)
+
+To use this skill in all your Claude Code sessions:
+
+1. **Copy to your personal Claude directory:**
+   ```bash
+   mkdir -p ~/.claude/skills/
+   cp -r .claude/skills/feature-refinement ~/.claude/skills/
+   ```
+
+2. **Verify installation:**
+   ```bash
+   ls -la ~/.claude/skills/feature-refinement/
+   ```
+
+You should see:
+```
+SKILL.md
+REFERENCE.md
+TEMPLATE.md
+README.md
+```
+
+## Verification
+
+To verify the skill is properly installed:
+
+1. Start a Claude Code session
+2. Ask: "What skills are available?"
+3. Look for "feature-refinement" in the list
+
+Or simply test it:
+```
+"Help me create a feature refinement document"
+```
+
+Claude should automatically invoke the feature-refinement skill.
+
+## Usage
+
+Once installed, Claude will automatically use this skill when you mention feature refinement tasks:
+
+**Example prompts:**
+- "Create a feature refinement document for a new RHOAI feature"
+- "Help me refine this feature for RHEL AI"
+- "Walk me through the feature refinement process"
+- "I need to document a new feature for the team"
+
+## What's Included
+
+### SKILL.md (Required)
+The main skill file with:
+- YAML frontmatter (name and description)
+- Complete 7-step workflow
+- Question prompts for gathering information
+- Guidance on all template sections
+
+### REFERENCE.md
+Comprehensive reference containing:
+- Full template structure
+- All required sections explained
+- Roles and responsibilities
+- Contact information and distribution lists
+- T-shirt sizing guide
+
+### TEMPLATE.md
+Ready-to-use template with:
+- All sections pre-formatted
+- Markdown/Google Doc compatible
+- Checkboxes for tracking progress
+- Placeholder text with guidance
+
+### README.md
+Documentation including:
+- Overview and capabilities
+- Installation instructions
+- Usage examples
+- Tips for best results
+- Support contacts
+
+## Customization
+
+To adapt this skill for your organization:
+
+1. **Edit SKILL.md:**
+   - Update the description in YAML frontmatter
+   - Modify questions and workflow steps
+   - Adjust guidance for your process
+
+2. **Edit REFERENCE.md:**
+   - Change contact emails
+   - Update distribution lists
+   - Modify T-shirt sizing scales
+   - Add organization-specific sections
+
+3. **Edit TEMPLATE.md:**
+   - Adjust table formats
+   - Add/remove sections
+   - Update checklist items
+
+## Requirements
+
+- Claude Code CLI
+- Skills feature enabled (available in recent Claude Code versions)
+
+## Troubleshooting
+
+**Skill not appearing:**
+- Verify SKILL.md exists and has proper YAML frontmatter
+- Check that the name field contains only lowercase letters, numbers, and hyphens
+- Ensure description is under 1024 characters
+- Restart Claude Code session
+
+**Skill not triggering automatically:**
+- Try explicitly mentioning "feature refinement" in your request
+- Ask "Use the feature-refinement skill to help me..."
+- Check that the description accurately reflects when to use the skill
+
+**File permission issues:**
+```bash
+chmod -R 755 ~/.claude/skills/feature-refinement/
+```
+
+## Support
+
+For questions about:
+- **This skill**: Review README.md in the skill directory
+- **Claude Code skills system**: Visit https://docs.claude.com/en/docs/claude-code/skills
+- **Feature refinement process**: Contact team-ai-core-platform@redhat.com
+
+## Version Information
+
+- **Created**: 2025-11-12
+- **Compatible with**: Claude Code Skills system
+- **Target Products**: RHOAI, RHAIIS, RHEL AI
+
+## Next Steps
+
+After installation:
+
+1. ✅ Verify the skill is recognized by Claude
+2. ✅ Test with a sample feature refinement
+3. ✅ Customize for your organization (optional)
+4. ✅ Share with team members (if using project installation)
+5. ✅ Review REFERENCE.md for complete template details
+
+## File Manifest
+
+```
+.claude/skills/feature-refinement/SKILL.md       - Main skill definition
+.claude/skills/feature-refinement/REFERENCE.md   - Complete reference guide
+.claude/skills/feature-refinement/TEMPLATE.md    - Blank document template
+.claude/skills/feature-refinement/README.md      - Usage documentation
+```
+
+Total files: 4
+Total size: ~30KB

skills/feature-refinement/README.md

@@ -0,0 +1,142 @@
+# Feature Refinement Skill
+
+A Claude Code skill for guiding users through the Red Hat AI feature refinement process.
+
+## Overview
+
+This skill helps Product Managers, Engineering Managers, and other stakeholders create comprehensive feature refinement documents for Red Hat AI products (RHOAI, RHAIIS, RHEL AI). It follows the official Feature Refinement Template and ensures all required sections, dependencies, and approval processes are properly documented.
+
+## Installation
+
+### For Project-Specific Use
+This skill is already located in the project directory:
+```
+.claude/skills/feature-refinement/
+```
+
+### For Personal Use (Available Across All Projects)
+Copy the skill to your personal Claude skills directory:
+
+```bash
+mkdir -p ~/.claude/skills/
+cp -r .claude/skills/feature-refinement ~/.claude/skills/
+```
+
+## Usage
+
+Claude will automatically invoke this skill when you mention feature refinement tasks. You can also explicitly ask Claude to use it:
+
+**Examples:**
+- "Help me create a feature refinement document for a new RHOAI feature"
+- "I need to refine a feature for RHEL AI"
+- "Walk me through the feature refinement process"
+- "Use the feature refinement skill to document this new capability"
+
+## What This Skill Does
+
+The skill guides you through a comprehensive 7-step process:
+
+1. **Gather Initial Information** - Collects basic feature metadata (Jira link, owners, product)
+2. **Define Feature Details** - Documents overview, requirements, acceptance criteria, risks
+3. **Verify Prerequisites & Dependencies** - Checks build onboarding, licensing, accelerator support, architecture review needs
+4. **Create High-Level Delivery Plan** - Builds team delivery table with effort estimates
+5. **Documentation and UXD Engagement** - Ensures proper engagement with Docs and UX teams
+6. **Generate Document** - Creates the complete feature refinement document
+7. **Feature Owner Next Steps** - Provides checklist for announcement, review, and approval
+
+## Key Features
+
+- **Interactive Guidance**: Asks clarifying questions to gather all required information
+- **Format Templates**: Provides proper formatting for user stories (As a/I want/So that) and acceptance criteria (Given/When/Then)
+- **Dependency Tracking**: Ensures all prerequisites are identified (build onboarding, licensing, AIPCC, architecture review)
+- **Team Coordination**: Helps build comprehensive team delivery plans with effort estimates
+- **Stakeholder Management**: Includes complete email distribution lists and engagement processes
+- **Process Compliance**: Follows official Red Hat AI feature refinement workflow
+
+## File Structure
+
+```
+.claude/skills/feature-refinement/
+├── SKILL.md          # Main skill definition with step-by-step workflow
+├── REFERENCE.md      # Complete template reference and detailed guidance
+└── README.md         # This file
+```
+
+## Products Supported
+
+- **RHOAI** (Red Hat OpenShift AI)
+  - Managed
+  - Self-managed
+- **RHAIIS** (Red Hat AI Infrastructure Services)
+- **RHEL AI** (Red Hat Enterprise Linux AI)
+
+## T-Shirt Size Reference
+
+The skill uses standard sprint-based sizing:
+- **XS**: < 1 sprint
+- **S**: 1 sprint (3 weeks)
+- **M**: 2 sprints (6 weeks)
+- **L**: 3 sprints (9 weeks) - Consider breaking down
+- **XL**: 4 sprints (12 weeks) - Must break down
+
+## Key Contacts & Teams
+
+The skill includes contact information and distribution lists for:
+- Documentation team
+- UXD team (Jenn Giardino, Beau Morley)
+- Core platform team (team-ai-core-platform@redhat.com)
+- All relevant stakeholder groups
+
+## Prerequisites Knowledge
+
+The skill references several important processes:
+- JIRA epic/feature linking
+- AIPCC package request process (AIPCC-1)
+- Build onboarding epics (RHOAIENG-31244, RHOAIENG-31290, RHOAIENG-31303)
+- Architecture review requirements
+- Docs intake process
+
+## Output Format
+
+The skill can generate the feature refinement document in:
+- **Google Doc format** (recommended for collaboration)
+- **Markdown format** (for version control)
+
+Both formats include all required sections, tables, and proper formatting.
+
+## Tips for Best Results
+
+1. **Have Information Ready**: Gather your Jira link, feature description, and key stakeholders before starting
+2. **Be Specific**: Provide detailed answers for feature overview and requirements
+3. **Think Cross-Team**: Consider all teams that might be impacted
+4. **Use Provided Formats**: Leverage the user story and acceptance criteria templates
+5. **Don't Skip Prerequisites**: Complete all dependency checks (build, licensing, AIPCC, architecture)
+6. **Engage Early**: Include Docs and UXD teams from the beginning
+
+## Customization
+
+To modify this skill for your organization:
+1. Edit `SKILL.md` to adjust the workflow or questions
+2. Update `REFERENCE.md` with your template structure
+3. Change contact emails and distribution lists as needed
+4. Adjust T-shirt sizing scales if you use different sprint lengths
+
+## Related Documentation
+
+- [Feature Refinement Documents Folder](https://drive.google.com/drive/folders/1SZjUobSqm4t8etx9nVY0agPhH4Wu0IuS?usp=drive_link)
+- [Docs Intake Process](https://docs.google.com/document/d/1G_LKipII0DMX3UxpkxVEpgM9Pk5tHcfZdvnkjn9E1mI/edit?tab=t.0)
+- Build Onboarding Epics: RHOAIENG-31244 (DevPreview), RHOAIENG-31290 (TechPreview), RHOAIENG-31303 (GA)
+- AIPCC Package Requests: AIPCC-1
+
+## Support
+
+For questions about:
+- **Build Process**: team-ai-core-platform@redhat.com
+- **UX Design**: Jenn Giardino (jgiardin@redhat.com) or Beau Morley (bmorley@redhat.com)
+- **Documentation**: openshift-ai-docs@redhat.com
+- **AIPCC/Accelerators**: Follow AIPCC-1 process
+
+## Version
+
+Created: 2025-11-12
+Compatible with: Claude Code Skills system