OpenParable
Skip to content
← Back to skills

Youtrack

Productivity
youtrack

Youtrack is an Agent Skill for productivity published in the aiskillstore/marketplace repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Interacts with YouTrack issue tracker for IdeaVim. Use when working with tickets (VIM-XXXX), adding comments, managing tags, setting status, or release management. This project does NOT use GitHub Issues - use YouTrack instead.

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.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/aiskillstore/marketplace/blob/HEAD/skills/jetbrains/youtrack/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/youtrack, 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.

YouTrack Integration

This project uses YouTrack for issue tracking, NOT GitHub Issues. Commands like gh issue will NOT work.

Environment Setup

All scripts require YOUTRACK_TOKEN environment variable to be set.

CLI Scripts

All scripts are in scripts-ts/src/youtrack-cli/ and run via npx tsx:

Add Comment

npx tsx scripts-ts/src/youtrack-cli/add-comment.ts <ticket-id> "<comment-text>" [--private]

Examples:

npx tsx scripts-ts/src/youtrack-cli/add-comment.ts VIM-1234 "This is a public comment"
npx tsx scripts-ts/src/youtrack-cli/add-comment.ts VIM-1234 "@Aleksei.Plate This needs review" --private

Add Tag

npx tsx scripts-ts/src/youtrack-cli/add-tag.ts <ticket-id> <tag-id>

Example:

npx tsx scripts-ts/src/youtrack-cli/add-tag.ts VIM-1234 68-507582

Remove Tag

npx tsx scripts-ts/src/youtrack-cli/remove-tag.ts <ticket-id> <tag-id>

Example:

npx tsx scripts-ts/src/youtrack-cli/remove-tag.ts VIM-1234 68-507582

Set Status

npx tsx scripts-ts/src/youtrack-cli/set-status.ts <ticket-id> "<status>"

Example:

npx tsx scripts-ts/src/youtrack-cli/set-status.ts VIM-1234 "Ready To Release"

Get Ticket Details

npx tsx scripts-ts/src/youtrack-cli/get-ticket.ts <ticket-id> [--json]

Example:

npx tsx scripts-ts/src/youtrack-cli/get-ticket.ts VIM-1234
npx tsx scripts-ts/src/youtrack-cli/get-ticket.ts VIM-1234 --json

Set Fix Version

npx tsx scripts-ts/src/youtrack-cli/set-fix-version.ts <ticket-id> "<version>"

Example:

npx tsx scripts-ts/src/youtrack-cli/set-fix-version.ts VIM-1234 "2.28.0"

Create Release Version

npx tsx scripts-ts/src/youtrack-cli/create-version.ts "<version-name>"

Example:

npx tsx scripts-ts/src/youtrack-cli/create-version.ts "2.29.0"

Delete Release Version

npx tsx scripts-ts/src/youtrack-cli/delete-version.ts "<version-name>"

Example:

npx tsx scripts-ts/src/youtrack-cli/delete-version.ts "2.29.0"

Common Tag IDs

Tag NameTag ID
claude-analyzed68-507461
claude-pending-clarification68-507582
IdeaVim Released In EAP68-385032

Private Comments

Private comments are only visible to the JetBrains team. Use --private flag to make a comment private:

npx tsx scripts-ts/src/youtrack-cli/add-comment.ts VIM-1234 "@Aleksei.Plate Need review" --private

Common Workflows

Mark ticket as analyzed by Claude

npx tsx scripts-ts/src/youtrack-cli/add-tag.ts VIM-1234 68-507461

Ask for clarification (add pending tag + private comment)

npx tsx scripts-ts/src/youtrack-cli/add-tag.ts VIM-1234 68-507582
npx tsx scripts-ts/src/youtrack-cli/add-comment.ts VIM-1234 "@Aleksei.Plate I need clarification: ..." --private

Remove pending clarification tag (after owner responds)

npx tsx scripts-ts/src/youtrack-cli/remove-tag.ts VIM-1234 68-507582

Mark ticket as ready to release

npx tsx scripts-ts/src/youtrack-cli/set-status.ts VIM-1234 "Ready To Release"