issue-labler

GitHub Auto-Label Issues & Templates Action

The most comprehensive GitHub Action for automatic issue labeling, story point detection, and professional issue templates

Support This Project

If this GitHub Action helps your team, please consider supporting its development:

Sponsor on GitHub - Monthly recurring support

Connect with us:

• Discord - Join our community
• Twitter - Follow for updates
• Instagram - Behind the scenes
• Facebook - Stay connected
• YouTube - Tutorials & demos

Your sponsorship helps us:

• Maintain and improve the action
• Add new features and integrations
• Provide better documentation and support
• Keep the project free for everyone

Overview

The Ultimate GitHub Issue Management Solution - A GitHub Action that automatically creates professional issue templates, detects story points, and applies intelligent labels based on content and file changes. Perfect for mobile development teams, agile projects, and organizations that need consistent issue management across multiple repositories.

Key Features

• Smart Story Point Detection: Automatically detects and labels story points (1, 2-3, 5, 8, 13, 20+)
• File-Based Labeling: Labels PRs based on changed files (JavaScript, Python, iOS, Android, etc.)
• Mobile Development Focus: iOS/Android specific labels and templates
• 50+ Professional Labels: Comprehensive label set for all development areas
• Professional Templates: Structured templates for features, bugs, and performance issues
• No External Dependencies: Self-contained GitHub Action
• Organization Ready: Perfect for enterprise and multi-repo setups

Features

• Smart Auto-Labeling: Automatically detects and applies labels based on issue content and keywords
• Professional Templates: Comprehensive, structured issue templates with guided sections
• 40+ Predefined Labels: Categorized labels for story points, difficulty, priority, and development areas
• Stable IDs: Labels use persistent identifiers that survive display name changes
• No External Dependencies: Self-contained GitHub Action using GitHub CLI
• Detailed Logging: Comprehensive error handling and progress reporting
• Configurable: Easy to customize via repository variables
• Intelligent Detection: Analyzes both issue title and body for better accuracy

Quick Installation

GitHub Marketplace (Recommended)

Add this simple workflow to your repository:

# .github/workflows/auto-label-issues.yml
name: Auto Label Issues & Templates

on:
  issues:
    types: [opened, edited]
  pull_request:
    types: [opened, edited, synchronize]

jobs:
  auto-label:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - uses: Devlander-Software/issue-labler@v1
        with:
          create_templates: 'true'
          create_labels: 'true'
          auto_label_issues: 'true'

That's it! The action will automatically:

• Create professional issue templates
• Set up 50+ comprehensive labels
• Auto-label issues and PRs based on content and file changes

Test Your Installation

After installation, test it by creating an issue with:

Title: "Test auto-labeling - Story Points: 5"

Body:
## Story Points
- [x] **Story Points: 5**

## Difficulty
- [x] **Difficulty: Easy**

## Priority
- [x] **Priority: Medium**

The GitHub Action will automatically run and apply labels based on your selections!

Complete Usage Guide - Everything you need to know about installation, configuration, and advanced usage

Quick Reference - Fast reference card for common usage patterns

Benefits of Using This GitHub Action

• Consistency Across Teams: Whether you're working on a single project or across multiple repositories in an organization, having consistent labels and issue templates makes it easier to manage issues.

• Better Organization: The predefined labels help categorize and prioritize issues in a clear, structured way, so team members and product managers can easily understand the state of the project.

• Easier Client Collaboration: Clients and customers can use familiar templates to submit feature requests or bug reports, ensuring that all communication follows a similar format. This reduces confusion and ensures requests are handled efficiently.

• Visual Clarity with Emojis: The emoji-enhanced labels make the issue list visually appealing and easier to scan. Non-technical stakeholders will appreciate the intuitive visual cues that emojis provide.

• Simplified Setup: This action automatically sets up everything you need to manage issues—issue templates and labels—so you don't have to manually create them for every new project.

• 📊 Data-Driven Analysis: NEW! Advanced data analysis and organization capabilities with structured labels, team insights, and export-ready data for external tools.

🆕 Data Analysis & Organization

The Issue Labler now includes advanced data analysis capabilities that transform your issue management into a data-driven system:

🎯 Key Analysis Features

• 📊 Structured Labels: Each label includes metadata (team, skills, complexity, hours)
• 👥 Team Insights: Automatic team capacity and workload analysis
• 📈 Sprint Planning: Story points with hour estimates for capacity planning
• 🔍 Smart Filtering: Pre-built GitHub search filters for common use cases
• 📤 Export Ready: JSON and CSV exports for external tools (Jira, Power BI, etc.)

🚀 Quick Analysis Commands

# Generate templates and analysis data
npm run generate:all

# Get insights and recommendations
npm run analyze

# Export data for external tools
npm run generate:analysis

📋 Sample GitHub Filters

# Quick wins (high impact, low effort)
label:"⏳ Story Points: 1" label:"🚨 Priority: High"

# Frontend team tasks
label:"🎨 Client Side" OR label:"👩‍💻 Component/UI"

# Technical debt
label:"📉 Technical Debt"

📖 For detailed analysis guidance, see DATA_ANALYSIS.md