---
name: gitea
description: >
  Use this skill when the user asks to work with their Gitea server:
  "покажи мои репозитории", "создай репозиторий", "открой issue", "закрой issue",
  "создай pull request", "смерджи PR", "добавь вебхук", "покажи релизы",
  "создай ветку", "покажи коммиты", "сравни ветки", "список организаций",
  "переключись на work gitea", "gitea", "list repos", "create issue",
  "open PR", "merge pull request", "create release", "add webhook",
  "list branches", "gitea notifications", "check gitea connection".
metadata:
  version: "0.2.0"
---

# Gitea Platform Assistant

Full Gitea REST API integration. All tools: `mcp__gitea__<tool_name>`.

## First Use

Always start by checking the connection and listing available instances:
```
mcp__gitea__list_instances()          → shows configured instances + default
mcp__gitea__get_current_user()        → verifies auth works
```

If these fail, tell the user to fill in `config.json` in the plugin folder.

## Instance Selection

Every tool has an optional `instance` parameter (defaults to `""`  = use default from config).

When user says "на work" / "на home" / "on the work server" → pass `instance="work"` (or relevant name).
When no instance is specified → pass `instance=""` (uses config default).

## Tool Categories

### Meta & Health
- `list_instances()` — show all configured instances
- `get_server_info(instance)` — Gitea version
- `get_current_user(instance)` — authenticated user

### Repositories
- `list_my_repos(limit, page, instance)`
- `search_repos(query, instance)`
- `get_repo(owner, repo, instance)`
- `create_repo(name, description, private, auto_init, default_branch, instance)`
- `create_org_repo(org, name, ..., instance)`
- `update_repo(owner, repo, ..., instance)`
- `delete_repo(owner, repo, instance)` ⚠️ permanent
- `fork_repo(owner, repo, organization, new_repo_name, instance)`
- `set_repo_topics(owner, repo, topics, instance)`

### Branches & Tags
- `list_branches(owner, repo, instance)`
- `get_branch(owner, repo, branch, instance)`
- `create_branch(owner, repo, new_branch_name, old_branch_name, instance)`
- `delete_branch(owner, repo, branch, instance)` ⚠️
- `list_tags(owner, repo, instance)`

### Files
- `list_directory(owner, repo, path, ref, instance)` — browse repo tree
- `get_file(owner, repo, filepath, ref, instance)` — returns content + sha
- `create_file(owner, repo, filepath, content, message, branch, instance)` — plain text input, auto-encoded
- `update_file(owner, repo, filepath, content, message, sha, branch, instance)` — requires sha from get_file
- `delete_file(owner, repo, filepath, message, sha, branch, instance)` — requires sha

### Issues
- `list_issues(owner, repo, state, type, labels, assignee, limit, instance)`
- `get_issue(owner, repo, index, instance)`
- `create_issue(owner, repo, title, body, assignees, labels, instance)`
- `update_issue(owner, repo, index, title, body, state, instance)`
- `close_issue / reopen_issue(owner, repo, index, instance)`
- `list_issue_comments / add_issue_comment / edit_issue_comment / delete_issue_comment`

### Labels & Milestones
- `list_labels / create_label(name, color #rrggbb) / add_issue_labels`
- `list_milestones / create_milestone(title, due_on)`

### Pull Requests
- `list_pull_requests(owner, repo, state, instance)`
- `get_pull_request(owner, repo, index, instance)`
- `create_pull_request(owner, repo, title, head, base, body, instance)`
- `merge_pull_request(owner, repo, index, merge_style, instance)` — merge_style: merge|rebase|squash
- `get_pr_diff(owner, repo, index, instance)` — returns diff text
- `list_pr_reviews / create_pr_review(state: APPROVED|COMMENT|REQUEST_CHANGES)`

### Releases
- `list_releases / get_latest_release / create_release / delete_release`

### Webhooks
- `list_repo_webhooks / create_repo_webhook(url, events) / delete_repo_webhook`

### Users & Organizations
- `get_current_user / get_user(username) / search_users(query)`
- `list_my_orgs / get_org / list_org_repos / list_org_members / list_org_teams`

### Commits & Activity
- `list_commits(owner, repo, sha, path, limit)`
- `compare_branches(owner, repo, base, head)` — diff + commit list
- `list_repo_contributors`

### Notifications
- `list_notifications(all) / mark_all_notifications_read`