jira-time_skill

Overview

This skill manages JIRA time tracking, worklogs, and time reports with a CLI-oriented workflow. It lets you log, view, update, and delete worklogs; set original and remaining estimates; run reports; and export timesheets to CSV or JSON. Use the jira-as CLI for all operations.

How this skill works

The skill wraps JIRA time APIs into discrete jira-as commands (time log, worklogs, update-worklog, delete-worklog, estimate, tracking, report, export, bulk-log). Commands support filters (date range, author, JQL), output formats (text/json/csv), dry-run previews for risky operations, and estimate-adjustment modes. Follow dry-run then execute for bulk or destructive actions.

When to use it

• Log hours spent on one or many issues (individual or bulk)
• View or audit worklogs for an issue, user, or period
• Adjust original or remaining time estimates on issues
• Generate time reports for billing, invoicing, or team summaries
• Export timesheets to CSV/JSON for external systems or archives

Best practices

• Always run jira-as commands (do not run internal scripts directly)
• Use --dry-run (-n) before bulk-log or delete-worklog to preview changes
• When adjusting estimates prefer setting both original and remaining together
• Provide explicit --started dates for off-hour or backdated entries to ensure correct reporting
• Output JSON for scripting and CSV for billing/export workflows

Example use cases

• Log 2h to PROJ-123 with a comment and adjust remaining estimate
• Preview bulk logging across a sprint with jira-as time bulk-log -j "sprint = 456" -t 15m -n, then execute after review
• Export last month's project timesheets to timesheets.csv for invoicing
• List all worklogs for an issue and filter to currentUser() to confirm personal time entries
• Update an existing worklog start time or comment and set automatic estimate adjustment