Create Ticket Skill

When to Use This Skill

Use this skill when:

• Creating a new Jira ticket/issue
• Logging a bug or defect
• Creating a feature request
• Filing a task or story
• Users mention "create ticket", "new issue", "log bug", "file ticket"
• Users want to create a ticket AND start working on it

Prerequisites

1. Install Dependencies

cd .github/skills && npm install

2. Configure Jira Credentials

Create a .env file in your project root:

JIRA_URL=https://ihkreddy.atlassian.net
JIRA_EMAIL=your-email@example.com
JIRA_API_TOKEN=your-api-token
JIRA_DEFAULT_PROJECT=SAM1

Get your API token from: https://id.atlassian.com/manage-profile/security/api-tokens

Workflow Process

1. Create a Simple Ticket

npx ts-node --esm .github/skills/skills/create-ticket/scripts/create-ticket.ts \
  --summary "Add user authentication feature" \
  --type Story

2. Create a Detailed Ticket

npx ts-node --esm .github/skills/skills/create-ticket/scripts/create-ticket.ts \
  --summary "Implement password reset functionality" \
  --description "Users should be able to reset their password via email" \
  --type Story \
  --priority High \
  --labels "authentication,security" \
  --acceptance-criteria "User receives reset email within 5 minutes" \
  --acceptance-criteria "Reset link expires after 24 hours"

3. Create Ticket with Branch and PR

npx ts-node --esm .github/skills/skills/create-ticket/scripts/create-ticket.ts \
  --summary "Add flight search filters" \
  --type Story \
  --create-branch \
  --create-pr

Script Options

Issue Type Guidelines

Story

New features or user-facing functionality:

• "Add user profile page"
• "Implement flight search filters"

Task

Technical work or internal tasks:

• "Update dependencies"
• "Configure CI/CD pipeline"

Bug

Defects or issues:

• "Fix login timeout error"
• "Correct price calculation"

Epic

Large features spanning multiple stories:

• "User Authentication System"
• "Flight Booking Module"

Best Practices

Writing Good Summaries

• Start with a verb: "Add", "Fix", "Update", "Implement"
• Be specific and concise
• Avoid vague terms

Good: "Add password reset via email" Bad: "Fix login stuff"

Writing Acceptance Criteria

Write testable criteria:

• "User sees confirmation message after booking"
• "API returns 400 for invalid input"
• "Page loads in under 2 seconds"