Skip to content

Conversation

@oidacra
Copy link
Member

@oidacra oidacra commented Jan 30, 2026

Summary

Adds a new Claude AI skill that automates GitHub issue creation using repository templates, ensuring consistent issue structure and proper label assignment across the dotCMS project.

Changes Made

Documentation

  • Added Claude skill: .claude/skills/create-issue/SKILL.md (230 lines)

    • Comprehensive workflow for creating GitHub issues using predefined templates
    • Supports Defect, Feature, Task, Spike, Epic, and UX issue types
    • Handles both English and Spanish input (translates to English)
    • Automated label assignment including team selection (Falcon, Maintenance, Scout)
    • Feature label selection logic based on semantic analysis
    • Integration with GitHub CLI for non-interactive issue creation
  • Added feature labels reference: .claude/skills/create-issue/references/feature-labels.md (116 lines)

    • Complete list of available dotCMS : [Feature] labels
    • Keyword matching guide for label selection
    • Selection strategy and examples
    • Instructions for keeping labels up-to-date

Technical Details

The skill follows a 10-step workflow:

  1. Template Discovery: Dynamically reads available issue templates from .github/ISSUE_TEMPLATE/
  2. Template Analysis: Reads actual template files to understand structure (never assumes)
  3. Issue Classification: Analyzes user input to determine issue type (Defect/Feature/Task/Spike/Epic/UX)
  4. Title Generation: Creates concise English titles (translates from Spanish if needed)
  5. Feature Label Selection: Uses semantic analysis to select appropriate dotCMS : [Feature] label
  6. Technology Detection: Determines technology context (Front-end/Java/Platform)
  7. Team Assignment: Prompts user for team selection (Falcon/Maintenance/Scout)
  8. Body Construction: Builds markdown body matching template structure
  9. Issue Creation: Uses GitHub CLI with proper label assignment
  10. Confirmation: Verifies all labels and project assignment

Key Features:

  • Avoids --template flag incompatibility by manually constructing body
  • Automatically applies template labels, team labels, and feature labels
  • Handles project assignment via template configuration
  • Includes authorization refresh instructions for GitHub CLI

Breaking Changes

None - This is a new skill addition that doesn't affect existing functionality.

Testing

  • Skill file structure validated
  • Template reading workflow verified
  • Label selection logic tested with examples
  • GitHub CLI command format validated
  • Markdown formatting verified

Related Issues

N/A - New feature addition

Additional Notes

  • The skill is designed to be used by Claude AI assistants (Cursor, Claude Code) when users request issue creation
  • Feature labels reference can be updated by running: gh label list --repo dotCMS/core --limit 100 | grep "dotCMS :"
  • The skill respects template-specific requirements (e.g., "Product team use only" for Epic/Feature templates)
  • Team selection is mandatory and uses AskUserQuestion tool for user interaction

This PR fixes: #34460

Copy link
Member

@sfreudenthaler sfreudenthaler left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Love this.

Put in a few items for the missing Team : Platform who's focus is on our dotCMS Cloud Products

@oidacra oidacra added this pull request to the merge queue Feb 2, 2026
github-merge-queue bot pushed a commit that referenced this pull request Feb 2, 2026
…tes (#34465)

## Summary

Adds a new Claude AI skill that automates GitHub issue creation using
repository templates, ensuring consistent issue structure and proper
label assignment across the dotCMS project.

## Changes Made

### Documentation

- **Added Claude skill**: `.claude/skills/create-issue/SKILL.md` (230
lines)
- Comprehensive workflow for creating GitHub issues using predefined
templates
  - Supports Defect, Feature, Task, Spike, Epic, and UX issue types
  - Handles both English and Spanish input (translates to English)
- Automated label assignment including team selection (Falcon,
Maintenance, Scout)
  - Feature label selection logic based on semantic analysis
  - Integration with GitHub CLI for non-interactive issue creation

- **Added feature labels reference**:
`.claude/skills/create-issue/references/feature-labels.md` (116 lines)
  - Complete list of available `dotCMS : [Feature]` labels
  - Keyword matching guide for label selection
  - Selection strategy and examples
  - Instructions for keeping labels up-to-date

## Technical Details

The skill follows a 10-step workflow:

1. **Template Discovery**: Dynamically reads available issue templates
from `.github/ISSUE_TEMPLATE/`
2. **Template Analysis**: Reads actual template files to understand
structure (never assumes)
3. **Issue Classification**: Analyzes user input to determine issue type
(Defect/Feature/Task/Spike/Epic/UX)
4. **Title Generation**: Creates concise English titles (translates from
Spanish if needed)
5. **Feature Label Selection**: Uses semantic analysis to select
appropriate `dotCMS : [Feature]` label
6. **Technology Detection**: Determines technology context
(Front-end/Java/Platform)
7. **Team Assignment**: Prompts user for team selection
(Falcon/Maintenance/Scout)
8. **Body Construction**: Builds markdown body matching template
structure
9. **Issue Creation**: Uses GitHub CLI with proper label assignment
10. **Confirmation**: Verifies all labels and project assignment

**Key Features**:
- Avoids `--template` flag incompatibility by manually constructing body
- Automatically applies template labels, team labels, and feature labels
- Handles project assignment via template configuration
- Includes authorization refresh instructions for GitHub CLI

## Breaking Changes

None - This is a new skill addition that doesn't affect existing
functionality.

## Testing

- [x] Skill file structure validated
- [x] Template reading workflow verified
- [x] Label selection logic tested with examples
- [x] GitHub CLI command format validated
- [x] Markdown formatting verified

## Related Issues

N/A - New feature addition

## Additional Notes

- The skill is designed to be used by Claude AI assistants (Cursor,
Claude Code) when users request issue creation
- Feature labels reference can be updated by running: `gh label list
--repo dotCMS/core --limit 100 | grep "dotCMS :"`
- The skill respects template-specific requirements (e.g., "Product team
use only" for Epic/Feature templates)
- Team selection is mandatory and uses AskUserQuestion tool for user
interaction

This PR fixes: #34460

---------

Co-authored-by: Steve Freudenthaler <[email protected]>
@github-merge-queue github-merge-queue bot removed this pull request from the merge queue due to failed status checks Feb 2, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: No status

Development

Successfully merging this pull request may close these issues.

[TASK] Document creation of GitHub issue creation skill

5 participants