Analysis API Create Cherry Pick Issue

Productivity

analysis-api-create-cherry-pick-issue

Analysis API Create Cherry Pick Issue is an Agent Skill for productivity published in the JetBrains/kotlin repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Create a KTIJ cherry-pick tracking issue for a KT fix that needs to be cherry-picked to an IntelliJ branch. Use when cherry-picking Analysis API fixes.

View on GitHub ↗

QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

Open your project in Codex.
Copy and paste the prompt below.
Review files and risks before approving any action.

Prompt to paste

Inspect the Agent Skill at https://github.com/JetBrains/kotlin/blob/HEAD/.claude/skills/analysis-api-create-cherry-pick-issue/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/analysis-api-create-cherry-pick-issue, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Analysis API: Create Cherry-Pick Issue

Creates a KTIJ tracking issue for cherry-picking a KT fix to an IntelliJ release branch.

Prerequisites

This skill requires the YouTrack MCP (mcp__YouTrack__* tools). If the YouTrack MCP is not available, stop immediately and inform the user that this skill cannot run without it.

Required User Inputs

KT issue ID (e.g. KT-84711)
Target version (e.g. 2026.1.1)
Commit hashes (e.g. 0e2ca82e, 449bdb32)

Workflow

Step 1: Gather data

Run these in parallel:

Fetch the KT issue via mcp__YouTrack__get_issue to get:
- summary — used in the KTIJ issue summary
- customFields.Severity — mapped to KTIJ Priority (see mapping below)
Fetch the current user via mcp__YouTrack__get_current_user to get the login for the assignee.

Severity-to-Priority mapping (KT Severity → KTIJ Priority):

KT Severity	KTIJ Priority
Critical	Critical
Major	Major
Normal	Normal
Minor	Minor

If the KT issue has no Severity or an unmapped value, default to Normal.

Step 2: Confirm with user

Before creating the issue, present the resolved fields and ask for confirmation:

Summary: Cherry-pick {KT-ID}: {KT summary} to {target version}
Priority: (mapped from Severity)
Assignee: (from current user)
Commits: (as provided)

Step 3: Create the issue

Use mcp__YouTrack__create_issue with:

project: KTIJ
summary: "Cherry-pick {KT-ID}: {KT summary} to {target version}"
description: (see template below)
permittedGroups: ["jetbrains-team"]
customFields:
  Type: Task
  Priority: (mapped)
  State: Open
  Subsystems: ["IDE"]
  Planned for: ["{target version}"]
  Assignee: (current user login)

Description template:

Cherry-pick the fix for [{KT-ID}](https://youtrack.jetbrains.com/issue/{KT-ID}) to IntelliJ {target version}.

**Commits:** `{hash1}`, `{hash2}`, ...

**Original issue:** {KT-ID} — {KT summary}

Step 4: Add tag

Use mcp__YouTrack__manage_issue_tags to add Needs cherry-picking to the created issue.

Step 5: Link issues

Use mcp__YouTrack__link_issues to link the KT issue as a previous step of the new KTIJ issue:

targetIssueId: {KTIJ-ID}
linkType: "previous step"
issueToLinkId: {KT-ID}

Step 6: Verify

Fetch the created issue via mcp__YouTrack__get_issue and confirm all fields are correct. Report the issue ID and URL to the user.