Skill Catalogue

Skills are atomic operations that wrap a single MCP tool call or shell command. Each lives in devops-plugin/skills/<name>/SKILL.md. Agents invoke skills via the Skill tool — the skill file provides the exact invocation pattern and parameter contract.

YouTrack skills

Skill	What it does
`get-open-issue`	Queries YouTrack for issues where `Assignee=Claude_Code` and `Stage` is `To Do` or `In Progress`. Optionally filters by `Git Repo` field.
`get-issue-detail`	Fetches full details for a YouTrack issue by its ID.
`add-issue-comment`	Adds a comment to a YouTrack issue.
`update-issue-status`	Updates a YouTrack issue's custom field (e.g. `Stage`, `Assignee`).
`task-rewriter`	Rewrites an existing YouTrack issue with expanded detail, acceptance criteria, and open questions.

Gitea skills

Skill	What it does
`get-open-pr`	Lists open pull requests in a Gitea repository that need attention or carry the `Ready` label.
`view-pull-request`	Loads full PR details: title, description, diff, labels, source/target branches.
`create-pull-request`	Opens a new PR targeting `main` with the given title and body.
`approve-pull-request`	Submits a PR approval review via the Gitea API.
`comment-pull-request`	Posts a review comment on a PR (used for feedback and follow-up notes).
`label-pull-request`	Sets labels on a PR (e.g. `Ready`, `Need Changes`).
`merge-pull-request`	Merges an approved PR.
`delete-branch`	Deletes a Gitea branch after merge.
`clean-merged-branches`	Deletes local branches already merged (or squash-merged) into `origin/main`, with fetch and worktree cleanup.

Git / workspace skills

Skill	What it does
`gitignore-guard`	Scans `git status` for local development artifacts (`.idea/`, `.local.json`, `.env`, `node_modules/`, etc.), appends detected patterns to `.gitignore`, and stages the result. Mandatory before any commit.*
`resolve-merge-conflict`	Classifies merge conflicts as safe (auto-resolvable: lockfiles, changelogs, docs, whitespace) or risky (escalate to human). Resolves safe conflicts automatically; stops and notifies via YouTrack, Discord, and `Need Changes` label for risky ones.
`sync-permissions`	Merges the plugin's `permissions.allow` entries from `devops-plugin/settings.json` into the workspace's `.claude/settings.local.json`.

Notification skills

Skill	What it does
`notify-discord`	Sends a rich Discord embed to `$DISCORD_WEBHOOK_URL` via `skills/notify-discord/send.sh`. Supports `processing` (blue), `done` (green), and `failure` (red) status colours.

The gitignore-guard contract

Every commit-performing agent (issue-resolver, pr-resolver) must invoke gitignore-guard before staging any files:

sequenceDiagram
    %% gitignore-guard pre-commit sequence
    agent->>gitignore-guard: invoke skill
    gitignore-guard->>git status: scan for artifacts
    gitignore-guard-->>agent: appended patterns (if any)
    agent->>git: stage .gitignore first
    agent->>git: stage remaining changed files
    agent->>git: commit