Agent skill
work-on-ticket
Pulls ticket details from Jira, creates feature branches with proper naming conventions, and handles planning steps. Use when starting work on a Jira ticket, creating branches for tickets, or when users mention "work on ticket", "start ticket", "create branch for", or Jira ticket IDs.
Install this agent skill to your Project
npx add-skill https://github.com/IHKREDDY/agent-skills-ts/tree/main/skills/work-on-ticket
Metadata
Additional technical details for this skill
- author
- IHKREDDY
- version
- 1.0
- category
- development
SKILL.md
Work on Ticket Skill
When to Use This Skill
Use this skill when:
- Starting work on a Jira ticket
- Creating a feature branch for a ticket
- Fetching ticket details and acceptance criteria
- Setting up workspace for new development work
- Users mention ticket IDs like "SAM1-123" or "work on ticket"
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
Workflow Process
1. Fetch Ticket Details
npx ts-node --esm .github/skills/skills/work-on-ticket/scripts/fetch-ticket.ts --ticket SAM1-123
This retrieves:
- Ticket summary and description
- Status and priority
- Assignee and reporter
- Acceptance criteria
- Labels
2. Start Working on a Ticket
npx ts-node --esm .github/skills/skills/work-on-ticket/scripts/start-work.ts --ticket SAM1-123
This will:
- ✅ Fetch ticket details
- ✅ Display summary and acceptance criteria
- ✅ Create feature branch with proper naming
- ✅ Transition ticket to "In Progress"
- ✅ Add comment: "Started working on this ticket"
3. Branch Naming Conventions
- Feature:
feature/sam1-123-short-description - Bug fix:
bugfix/sam1-123-short-description - Hotfix:
hotfix/sam1-123-short-description
Script Reference
fetch-ticket.ts
Retrieves complete ticket information from Jira.
# Basic fetch
npx ts-node --esm scripts/fetch-ticket.ts --ticket SAM1-123
# Output as JSON
npx ts-node --esm scripts/fetch-ticket.ts --ticket SAM1-123 --json
start-work.ts
Full workflow to start development.
# Start work with all defaults
npx ts-node --esm scripts/start-work.ts --ticket SAM1-123
# Skip branch creation
npx ts-node --esm scripts/start-work.ts --ticket SAM1-123 --no-branch
# Skip status transition
npx ts-node --esm scripts/start-work.ts --ticket SAM1-123 --no-transition
test-connection.ts
Verify Jira connectivity.
npx ts-node --esm scripts/test-connection.ts
Integration with create-ticket
After creating a ticket with create-ticket, use this skill to start development:
# First, create the ticket
npx ts-node --esm skills/create-ticket/scripts/create-ticket.ts \
--summary "Add search filters" --type Story
# Output: Created ticket SAM1-15
# Then start working on it
npx ts-node --esm skills/work-on-ticket/scripts/start-work.ts --ticket SAM1-15
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
IHKREDDY/agent-skills-ts
tech-debt-report
Find TODOs, deprecated APIs, and outdated patterns in codebase
IHKREDDY/agent-skills-ts
sprint-summary
Generate sprint review summary from completed Jira tickets
IHKREDDY/agent-skills-ts
api-integration
Design and implement REST API integrations with proper error handling, authentication, rate limiting, and testing. Use when building API clients, integrating third-party services, or when users mention API, REST, webhooks, HTTP requests, or service integration.
IHKREDDY/agent-skills-ts
hotfix-workflow
Rapid hotfix branch creation, fix application, and PR to main
IHKREDDY/agent-skills-ts
create-ticket
Creates Jira tickets with proper formatting, acceptance criteria, and optionally sets up git branches and pull requests. Use when users want to create a new ticket, log a bug, request a feature, or when they mention "create ticket", "new ticket", "log issue", "file bug", or "create Jira".
IHKREDDY/agent-skills-ts
auto-commit
Generates semantic commit messages from staged changes. Analyzes git diff and creates conventional commit messages. Use when users want to commit with good messages, mention "commit", "save changes", or ask for commit message suggestions.
Didn't find tool you were looking for?