Official agent skill

Issues Deduplication

by JetBrains in JetBrains/ideavim

Handles deduplication of YouTrack issues. An agent skill from JetBrains/ideavim.

OfficialMITAuto-check passedData & Analytics

Install Issues Deduplication

skills CLI
$ npx skills add JetBrains/ideavim --skill issues-deduplication -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install JetBrains/ideavim issues-deduplication --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/JetBrains/ideavim.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/issues-deduplication .claude/skills/issues-deduplication && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
issues-deduplication
GitHub stars
10k
Token cost
~1.3k tokens
SKILL.md length
679 words
Files
1
Skills in repo
5
Repo updated
First seen
Licence
MIT

At a glance

Handles deduplication of YouTrack issues. An agent skill from JetBrains/ideavim.

  • Works in 12 steps: Choosing Which Issue to Keep Open → Never Duplicate Issues with Customer Tags → Closed Issue Warning → …
  • Cleaning up duplicate issues
  • SKILL.md covers Core Principles, Process, YouTrack Operations and Example Decision Matrix
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Issues Deduplication is an agent skill from JetBrains/ideavim, published by the product's own GitHub organization. Handles deduplication of YouTrack issues. Use when cleaning up duplicate issues, consolidating related bug reports, or organizing issue tracker.

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Data & Analytics, covering Data cleaning, Issue triage and QA and bug reports. It works with JetBrains IDEs and Kotlin. The repository describes itself as: IdeaVim – A Vim engine for JetBrains IDEs. The licence is MIT.

When your agent uses it

  • Cleaning up duplicate issues
  • Consolidating related bug reports
  • Organizing issue tracker

Example prompts

  • “Use the issues-deduplication skill to handle deduplication of YouTrack issues. An agent skill from JetBrains/ideavim”
  • “/issues-deduplication”

Workflow steps

12 steps, taken from the step headings in SKILL.md.

  1. Choosing Which Issue to Keep Open
  2. Never Duplicate Issues with Customer Tags
  3. Closed Issue Warning
  4. Consolidate to a Single Issue
  5. Preserve Unique Information
  6. Gather Issue Details
  7. Group Duplicates
  8. Select Primary Issue
  9. Check for Unique Information
  10. Transfer Information
  11. Mark Duplicates
  12. Leave a Courteous Comment

What it can do on your machine

Read from SKILL.md and the folder at commit 37aeff6. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Issues Deduplication loads about 1.3k tokens when it runs. Until then it costs about 41 tokens; SKILL.md has 679 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~41
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from JetBrains/ideavim at commit 37aeff6, republished under its MIT licence (© JetBrains). 679 words, ~1,336 tokens.

Download SKILL.mdSave it as .claude/skills/issues-deduplication/SKILL.md (or your agent's skills folder).
name
issues-deduplication
description
Handles deduplication of YouTrack issues. Use when cleaning up duplicate issues, consolidating related bug reports, or organizing issue tracker.

Issues Deduplication

You are an issue tracker specialist for the IdeaVim project. Your job is to identify and properly handle duplicate issues in YouTrack.

Core Principles

1. Choosing Which Issue to Keep Open

Default rule: The older issue is typically kept open, and newer issues are marked as duplicates.

Exception - Activity trumps age: If a newer issue has significantly more engagement (comments, votes, watchers), keep the newer one open and mark the older one as duplicate. Consider:

  • Number of comments
  • Number of votes/thumbs-up
  • Number of watchers
  • Quality of discussion and information
2. Never Duplicate Issues with Customer Tags

IMPORTANT: Do not mark an issue as duplicate if it has a customer-related tag:

  • Tags like Customer:XXX
  • Company name tags like Uber, Google, Meta, etc.
  • Any tag indicating a specific customer reported or is affected by the issue

These issues need individual tracking for customer relationship purposes.

3. Closed Issue Warning

CRITICAL: Be very careful about duplicating into a closed issue!

Before marking issues as duplicates of a closed issue, verify:

  • Is the closed issue actually fixed?
  • Does the fix apply to all the duplicate reports?
  • Are the newer reports potentially about a regression or different manifestation?

If the problem is still occurring (based on recent reports), do NOT duplicate into a closed issue. Instead:

  • Reopen the closed issue, OR
  • Keep one of the open issues as the primary and duplicate into that

Duplicating active issues into a wrongly-closed issue will mark all related issues as "resolved" and lose track of an unresolved problem.

4. Consolidate to a Single Issue

When multiple issues are duplicates of each other (e.g., issues 1, 2, 3, 4, 5):

  • DO: Mark 2, 3, 4, 5 as duplicates of 1 (star topology)
  • DON'T: Create chains like 2→1, 3→2, 4→3, 5→4

This makes it easier to track all related reports from a single issue.

5. Preserve Unique Information

Before marking an issue as duplicate:

  1. Review the issue for unique information not present in the target issue
  2. If valuable info exists (reproduction steps, logs, environment details, workarounds):
    • Add a comment to the target issue summarizing the unique info
    • Or update the target issue's description if the info is significant
  3. Then mark as duplicate

Process

Step 1: Gather Issue Details

For each candidate issue, collect:

  • Issue ID and summary
  • Creation date
  • Number of comments
  • Number of votes
  • Tags (especially customer tags)
  • Current state (Open, Closed, etc.)
  • Key details from description
Show full SKILL.md (276 more words)Show less
Step 2: Group Duplicates

Identify which issues are truly duplicates vs. related-but-different issues.

Step 3: Select Primary Issue

Based on the rules above, select which issue should be the primary (kept open).

Step 4: Check for Unique Information

Review each duplicate for information not in the primary issue.

Step 5: Transfer Information

Add comments or update the primary issue with any unique valuable information.

Step 6: Mark Duplicates

Use YouTrack to link issues as duplicates:

  • Add "duplicates" link from duplicate → primary
  • Update the issue state to "Duplicate"
Step 7: Leave a Courteous Comment

After marking an issue as duplicate, leave a comment on the duplicated issue to:

  • Inform the reporter about the merge
  • Direct them to the primary issue for updates
  • Thank them for their contribution

Example comment:

This issue has been merged into VIM-XXXX for easier tracking. Please follow that issue for updates. Thank you for your contribution!

This maintains good relationships with reporters and ensures they stay informed.

YouTrack Operations

Use mcp__YouTrack__link_issues with:

  • issueId: The duplicate issue
  • targetIssueId: The primary issue to duplicate into
  • linkName: "duplicates"
Add Comment

Use mcp__YouTrack__add_issue_comment to transfer unique information.

Update Issue

Use mcp__YouTrack__update_issue to update description if needed.

Example Decision Matrix

ScenarioAction
Old issue (2022), new issue (2024) with same problem, similar activityDuplicate new → old
Old issue (2022) with 2 comments, new issue (2024) with 15 comments and 10 votesDuplicate old → new
Issue has Customer:Acme tagNever mark as duplicate
Old issue closed as "Fixed", new reports say problem still existsKeep new issue open, investigate if regression
5 issues about same bugPick best one as primary, duplicate all 4 others → primary

© JetBrains, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .claude/skills/issues-deduplication of JetBrains/ideavim.

Open the folder on GitHubat commit 37aeff6

Compare with similar skills

Issues Deduplication next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Issues Deduplication compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Issues Deduplication this skillJetBrains/ideavim10k—~1.3kAutomated safety check: PassMIT
AI Bug Triagepetrkindlmann/qa-skills165—~5.2kAutomated safety check: PassMIT
Quality Assuranceliangdabiao/claude-data-analysis-ultra-main290—~728Automated safety check: PassNone
Notebook For ExperimentJetBrains/intellij-community21k—~4.4kAutomated safety check: WarnCustom licence
Bug Report TriageOrchestratorInc/agent-orchestrator13k—~1.8kAutomated safety check: PassApache-2.0
Triage IssuesClickHouse/clickhouse-java1.6k—~904Automated safety check: PassApache-2.0

Similar skills

  • AI Bug Triage

    petrkindlmann/qa-skills

    Hybrid fingerprint + LLM pipeline for bug classification, deduplication, and ticket generation.

    165 GitHub stars~5.2k tokensUpdated 4 mo ago
    Testing & QAAuto-check passed
  • Quality Assurance

    liangdabiao/claude-data-analysis-ultra-main

    Data quality validation and analysis accuracy verification. An agent skill from liangdabiao/claude-data-analysis-ultra-main.

    290 GitHub stars~728 tokensUpdated 5 mo ago
    Data & AnalyticsAuto-check passed
  • Notebook For Experiment

    JetBrains/intellij-community

    Official

    Create reproducible Jupyter notebooks for performance experiments.

    21k GitHub stars~4.4k tokensUpdated yesterday
    Data & AnalyticsAuto-check: warnings
  • Bug Report Triage

    OrchestratorInc/agent-orchestrator

    Helps a reporter describe a bug, searches for duplicates and gathers diagnostic evidence kept separate from a short, human-worded issue draft.

    13k GitHub stars~1.8k tokensUpdated today
    DevelopmentAuto-check passed
  • Triage Issues

    ClickHouse/clickhouse-java

    Analyzes a single GitHub issue at a time. An agent skill from ClickHouse/clickhouse-java.

    1.6k GitHub stars~904 tokensUpdated yesterday
    Testing & QAAuto-check passed
  • OpenROAD Issue Triage

    The-OpenROAD-Project/OpenROAD

    Reproduces an OpenROAD GitHub bug from an attached tarball and shrinks the failing design with whittle.py so maintainers get a minimal test case.

    3.2k GitHub stars~842 tokensUpdated yesterday
    DevelopmentAuto-check passed

More from JetBrains/ideavim

  • Doc Sync

    JetBrains/ideavim

    Official

    Keeps IdeaVim documentation in sync with code changes. An agent skill from JetBrains/ideavim.

    10k GitHub starsUsed in 2 repos~2.6k tokens
    Auto-check passed
  • Changelog

    JetBrains/ideavim

    Official

    Maintains the IdeaVim changelog (CHANGES.md). An agent skill from JetBrains/ideavim.

    10k GitHub starsUsed in 1 repo~2.7k tokens
    Auto-check passed
  • Extensions API Migration

    JetBrains/ideavim

    Official

    Migrates IdeaVim extensions from the old VimExtensionFacade API to the new @VimPlugin annotation-based API.

    10k GitHub stars~1.7k tokensUpdated yesterday
    Auto-check passed
  • Git Workflow

    JetBrains/ideavim

    Official

    IdeaVim git workflow conventions covering commits, branches, PRs, and CI.

    10k GitHub stars~424 tokensUpdated yesterday
    Auto-check passed

Questions about Issues Deduplication

What does Issues Deduplication do?

Handles deduplication of YouTrack issues. An agent skill from JetBrains/ideavim. Issues Deduplication is an agent skill from JetBrains/ideavim, published by the product's own GitHub organization. Handles deduplication of YouTrack issues.

When should I use Issues Deduplication?

Issues Deduplication fits situations like: cleaning up duplicate issues; consolidating related bug reports; organizing issue tracker.

How do I install Issues Deduplication in Claude Code?

Run `npx skills add JetBrains/ideavim --skill issues-deduplication -a claude-code`. Or copy the skill folder (.claude/skills/issues-deduplication in JetBrains/ideavim) into .claude/skills/issues-deduplication in your project. Claude Code loads it when a task matches its description.

How do I install Issues Deduplication in Codex?

Run `npx skills add JetBrains/ideavim --skill issues-deduplication -a codex`. Or copy the skill folder (.claude/skills/issues-deduplication in JetBrains/ideavim) into .agents/skills/issues-deduplication in your project. Codex loads it when a task matches its description.

Can I use Issues Deduplication in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add JetBrains/ideavim --skill issues-deduplication -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/issues-deduplication, .gemini/skills/issues-deduplication, .github/skills/issues-deduplication and .opencode/skills/issues-deduplication in your project.

What does Issues Deduplication need to run?

SKILL.md names no scripts, command-line tools or credentials: Issues Deduplication is instructions for the agent only.

Does Issues Deduplication access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Issues Deduplication safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Issues Deduplication use?

Issues Deduplication is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Issues Deduplication use?

About 1.3k tokens (SKILL.md is roughly 5.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Issues Deduplication?

Skills that share tags, products or a category with Issues Deduplication: AI Bug Triage (petrkindlmann/qa-skills, 165 stars), Quality Assurance (liangdabiao/claude-data-analysis-ultra-main, 290 stars), Notebook For Experiment (JetBrains/intellij-community, 21k stars) and Bug Report Triage (OrchestratorInc/agent-orchestrator, 13k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Issues Deduplication?

JetBrains (a GitHub organization, an official publisher) maintains it in JetBrains/ideavim, which has 10,278 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on October 7, 2026.

Source: JetBrains/ideavim on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.