Skills¶

Claude Code plugins that integrate with YouTrack for issue management and development workflows.

sq-scrum — Issue management¶

The sq-scrum plugin provides skills for creating and managing YouTrack issues directly from Claude Code.

create-issue¶

Guided issue creation with smart defaults and field validation.

Invocation: /create-issue

Walks you through selecting a project, type, and filling in fields. Applies project defaults (Category) and validates required fields before creating.

/create-issue
# → Select project: SAR
# → Select type: Bug
# → Fill in summary, description, priority, tags...
# → Issue SAR-789 created

edit-issue¶

View and selectively update fields on an existing issue.

Invocation: /edit-issue

Fetches the issue, displays all current fields, and lets you update only the ones you want to change.

/edit-issue SAR-456
# → Shows current state: Open, Priority: Normal, ...
# → Select fields to update
# → Updated SAR-456

draft-to-issues¶

Parse free-form text into structured YouTrack issues with review before creation.

Invocation: /draft-to-issues

Paste meeting notes, Slack messages, or any unstructured text. The skill identifies individual issues, assigns types, and structures them using the issue templates. You review and confirm before anything is created.

/draft-to-issues
# → Paste your text...
# → Parsed 3 issues: 1 Bug, 1 Task, 1 User Story
# → Review each one, adjust fields, confirm
# → Created SAR-790, SAR-791, OPS-45

sq-dev — Development workflow¶

The sq-dev plugin connects issue tracking to the Git workflow. These skills bridge the gap between YouTrack issues and your local development environment.

start-task¶

Picks up a YouTrack issue and sets up your local environment to work on it.

What it does:

Reads the issue from YouTrack
Creates a feature branch named after the issue (e.g. SAR-456/add-retry-logic)
Sets the issue state to In Progress
Assigns the issue to you if not already assigned

make-commit¶

Stages the intended changes, inspects the final diff, and proposes a contract-compliant commit message.

Invocation: /make-commit

What it does:

Stages the intended changes and inspects the final staged diff
Generates a message from the implemented primary effect using the authoritative commit contract
Shows the message for your approval before committing

The issue and branch provide context only. They do not determine the type, optional !, or version bump; issue references belong in the body or footer when needed.

close-task¶

Wraps up work on the current issue and merges.

Invocation: /close-task

What it does:

Squash-merges the feature branch into dev
Updates the issue state to Done in YouTrack
Cleans up the feature branch

The full development loop¶

/start-task          → branch created, issue In Progress
  ... work ...
/make-commit         → commit classified from the final diff
  ... more work ...
/make-commit         → another commit
/close-task          → squash-merge, issue Done, branch cleaned

See AI-Assisted Workflows for the broader development process including code review and planning.

Planned skills¶

These skills are planned but not yet shipped:

Skill	Purpose
formalize-issue	Read a rough issue, apply the right template, suggest a rewrite
sprint-readiness	Audit sprint issues for missing fields and template gaps