- Home
- Skills
- Workflow Automation
- YouTrack Flow for AI Agents
Works with the AI Agents you already use
YouTrack Flow for AI Agents
Pick up a YouTrack issue from your agent: branch, In Progress, plan, PR, and write everything back.
Free
YouTrack Flow for AI Agents
Example session with this skill installed
/youtrack-task PROJ-123
- Read your context and instructions
- Compiled the youtrack flow
I have fetched the details for PROJ-123: Implement OAuth2 Provider.
The issue is currently Open (Priority: Normal). I will now prepare the workspace.
Task Initialization: PROJ-123
- Branch Created:
feat/PROJ-123-implement-oauth2-provider - Workspace: Created isolated worktree at
.worktrees/PROJ-123-implement-oauth2-provider - YouTrack Status: Updated to In Progress
- Comment Posted: Pickup recorded on YouTrack.
Proposed Implementation Plan
| Phase | Task | Description |
|---|---|---|
| 1. Setup | Configuration | Add oauth2 client credentials to .env.example and config files. |
| 2. Core | Middleware | Implement OAuth2Middleware to intercept and validate Bearer tokens. |
| 3. Storage | Token Store | Create repository for persisting and refreshing access tokens. |
| 4. Test | Integration | Verify token exchange flow with mock provider. |
Next steps
- Review the plan above. If it looks good, I will post it to the YouTrack issue.
- Once the plan is posted, I will begin implementing Phase 1.
- Use
/youtrack-task log 1hwhen you are ready to record time spent.
Connects securely to your tools. The creator never sees your data.
About this skill
Context switching between YouTrack issues and Git branches introduces significant friction and manual record-keeping overhead. This skill automates the lifecycle of a task from pickup to PR by synchronizing your local repository state with your YouTrack board.
What it does
- Issue synchronization fetches full context from YouTrack and updates issue status to In Progress or Testing automatically.
- Isolated workspaces creates dedicated git worktrees for issues to prevent dirty trees from blocking parallel tasks.
- Automated planning generates implementation plans, gets user approval, and mirrors the plan back to YouTrack comments.
- State management handles time logging, status transitions, and linking PRs directly to the relevant issue.
- Cleanup orchestration identifies and removes merged or closed worktrees to keep your local environment lean.
How it works
- Pickup: Run
/youtrack-task <ID>to fetch issue details, create a feature branch, and move the ticket to In Progress. - Implementation: The agent drives the planning phase, writes the plan to YouTrack, and implements code changes.
- Submission: Use
/youtrack-task prto push the branch, create a GitHub PR, and move the ticket to Testing. - Finalization: Execute
/youtrack-task doneto move the issue to its final state and safely prune local worktrees.
Frameworks & tools
This skill requires a YouTrack MCP server and the GitHub CLI (gh). It uses native Git commands and worktree management.
Why this beats prompting it yourself
Manual prompting requires you to copy-paste issue descriptions, remember branch naming conventions, and manually post status updates. This skill enforces consistent workflows, translates non-English issues for Git metadata, and prevents accidental commits to the default branch.
Use cases
- Starting a new feature by transforming a YouTrack ticket into a ready-to-code workspace.
- Managing multiple high-priority bugs in parallel using isolated git worktrees.
- Documenting technical implementation plans on YouTrack for team visibility without leaving the terminal.
- Cleaning up local environment clutter by bulk-pruning merged feature branches and worktrees.
Known limitations
Requires an active YouTrack MCP server connection and GitHub CLI. Does not support force-pushing or deleting remote branches. Git artifacts are strictly English.
Requires a YouTrack MCP server and git; the gh CLI is needed only for the pr sub-command and PRs target GitHub only (no GitLab/Bitbucket). Branch names, commits and PR title/body are always English. Never force-pushes, merges, or deletes branches with -D. Worktree mode clones dependency dirs with cp -c (APFS copy-on-write) and falls back to a plain copy elsewhere. Developed and tested in Claude Code.
How to use
- 1
Connect your agent to the Agensi MCP
Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup
- 2
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 3
Ask for what you need
Your agent loads this skill and uses it on your task. It always asks before any payment.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill goes through the trust checks below.
Security scanned
Checked by our 8-point scan before listing
1 use
Times used to date
Free forever
No account required to browse
Trust & safety
Security scan
Security scan passed 5 days ago
- Free with an Agensi account
Requires
Permissions
File Scopes
Shell: git/gh and the bundled scripts. Network: the YouTrack MCP server and gh pr view/create (only for the pr sub-command). Files: reads the optional user config and repo files for planning; writes only the optional plan copy docs/plans/<ID>.md and git worktrees under .worktrees/. The YouTrack token is never read by the skill; it lives in the agent's MCP configuration.