Add jira-dmtools Cursor Agent skill

[Alex-Tarasevich]

Add jira-dmtools skill

Summary

Adds a Cursor Agent skill for performing JIRA operations via the dmtools CLI. The skill guides agents through connection verification, config setup, and running the right dmtools commands for search, read, create, update, workflow, comments, and other JIRA tasks.

What's included

Location: .cursor/skills/jira-dmtools/

• Main skill: SKILL.md – Agent flow (verify → config → run), command index by task, how to invoke dmtools.
• Readme: readme-jira-dmtools.md – Skill and script invocation flow (diagram + examples), full command list by group, config and usage notes.
• Script: scripts/verify_jira_connection.py – Verifies JIRA connection and creates/refreshes .dmtools/jira.cfg using dmtools.env (JIRA_BASE_PATH, JIRA_EMAIL, JIRA_API_TOKEN).
• Subskills: One SKILL.md per command group under commands/ with exact tools, parameters, and examples:
  • search – jira_search_by_jql, jira_search_by_page, jira_search_with_pagination
  • tickets-read – jira_get_ticket, jira_get_subtasks, jira_get_comments, jira_get_transitions
  • ticket-create – jira_create_ticket_basic, jira_create_ticket_with_json, jira_create_ticket_with_parent
  • ticket-update – jira_update_ticket, jira_update_field, jira_update_description, etc.
  • ticket-delete – jira_delete_ticket
  • workflow – jira_move_to_status, jira_move_to_status_with_resolution, jira_assign_ticket_to
  • profile – jira_get_account_by_email, jira_get_my_profile, jira_get_user_profile
  • comments – jira_post_comment, jira_post_comment_if_not_exists
  • fix-versions – jira_get_fix_versions, jira_set_fix_version, jira_add_fix_version, jira_remove_fix_version
  • links-labels-priority – jira_get_issue_link_types, jira_link_issues, jira_add_label, jira_set_priority
  • fieldsdata – jira_get_fields, jira_get_field_custom_code, jira_get_all_fields_with_name
  • metadata – jira_get_issue_types, jira_get_project_statuses, jira_get_components
  • attachments – jira_attach_file_to_ticket, jira_download_attachment
  • xray – jira_xray_* (search, get details/steps/preconditions, create precondition, add to test, etc.)
  • advanced – jira_execute_request (custom GET)

Invocation flow

1. Script: From repo root, run python .cursor/skills/jira-dmtools/scripts/verify_jira_connection.py --verify. If it fails (no or invalid .dmtools/jira.cfg), run the same script without --verify (optionally with --project PROJ) to create/refresh config, then retry verify.
2. Skill: Match the user task to the "When to use" column in the command index, open the corresponding commands/<folder>/SKILL.md, then run dmtools <tool_name> with positional args or --data '<JSON>'. Output is JSON on stdout.

Config is read from dmtools.env (or env): JIRA_BASE_PATH, JIRA_EMAIL, JIRA_API_TOKEN; optional JIRA_AUTH_TYPE (default basic).

Files

Path	Description
.cursor/skills/jira-dmtools/SKILL.md	Main skill: agent flow, command index, how to invoke
.cursor/skills/jira-dmtools/readme-jira-dmtools.md	Readme: invocation flow diagram, command list, config, notes, verification
.cursor/skills/jira-dmtools/scripts/verify_jira_connection.py	Verify connection and write .dmtools/jira.cfg
.cursor/skills/jira-dmtools/commands/<group>/SKILL.md	Per-group subskills (14 groups) with tools, params, examples

Documentation and scripts only; requires dmtools CLI and JIRA credentials in dmtools.env.